├── app
├── .gitignore
├── src
│ ├── main
│ │ ├── res
│ │ │ ├── mipmap-hdpi
│ │ │ │ ├── ic_launcher.webp
│ │ │ │ └── ic_launcher_round.webp
│ │ │ ├── mipmap-mdpi
│ │ │ │ ├── ic_launcher.webp
│ │ │ │ └── ic_launcher_round.webp
│ │ │ ├── mipmap-xhdpi
│ │ │ │ ├── ic_launcher.webp
│ │ │ │ └── ic_launcher_round.webp
│ │ │ ├── mipmap-xxhdpi
│ │ │ │ ├── ic_launcher.webp
│ │ │ │ └── ic_launcher_round.webp
│ │ │ ├── mipmap-xxxhdpi
│ │ │ │ ├── ic_launcher.webp
│ │ │ │ └── ic_launcher_round.webp
│ │ │ ├── values
│ │ │ │ ├── themes.xml
│ │ │ │ ├── colors.xml
│ │ │ │ └── strings.xml
│ │ │ ├── mipmap-anydpi-v26
│ │ │ │ ├── ic_launcher.xml
│ │ │ │ └── ic_launcher_round.xml
│ │ │ ├── xml
│ │ │ │ ├── backup_rules.xml
│ │ │ │ └── data_extraction_rules.xml
│ │ │ ├── values-en
│ │ │ │ └── strings.xml
│ │ │ ├── values-tr
│ │ │ │ └── strings.xml
│ │ │ ├── values-de
│ │ │ │ └── strings.xml
│ │ │ ├── drawable-v24
│ │ │ │ └── ic_launcher_foreground.xml
│ │ │ └── drawable
│ │ │ │ └── ic_launcher_background.xml
│ │ ├── java
│ │ │ └── com
│ │ │ │ └── android
│ │ │ │ └── authentication
│ │ │ │ ├── ui
│ │ │ │ ├── theme
│ │ │ │ │ ├── Color.kt
│ │ │ │ │ ├── Type.kt
│ │ │ │ │ └── Theme.kt
│ │ │ │ └── screens
│ │ │ │ │ └── StartScreen.kt
│ │ │ │ └── MainActivity.kt
│ │ └── AndroidManifest.xml
│ ├── test
│ │ └── java
│ │ │ └── com
│ │ │ └── android
│ │ │ └── authentication
│ │ │ └── ExampleUnitTest.kt
│ └── androidTest
│ │ └── java
│ │ └── com
│ │ └── android
│ │ └── authentication
│ │ └── ExampleInstrumentedTest.kt
├── proguard-rules.pro
└── build.gradle
├── pinlibrary
├── .gitignore
├── consumer-rules.pro
├── src
│ ├── main
│ │ ├── AndroidManifest.xml
│ │ ├── java
│ │ │ └── com
│ │ │ │ └── android
│ │ │ │ └── pinlibrary
│ │ │ │ ├── utils
│ │ │ │ ├── enums
│ │ │ │ │ └── PinCodeScenario.kt
│ │ │ │ ├── preferences
│ │ │ │ │ ├── IAttemptCounter.kt
│ │ │ │ │ ├── IPinCodeManager.kt
│ │ │ │ │ ├── ISettingsManager.kt
│ │ │ │ │ ├── AttemptCounter.kt
│ │ │ │ │ ├── SettingsManager.kt
│ │ │ │ │ └── PinCodeManager.kt
│ │ │ │ ├── listeners
│ │ │ │ │ └── NumberListener.kt
│ │ │ │ ├── state
│ │ │ │ │ ├── deletepin
│ │ │ │ │ │ ├── DeletePinScreenIntent.kt
│ │ │ │ │ │ └── DeletePinScreenState.kt
│ │ │ │ │ ├── validationpin
│ │ │ │ │ │ ├── ValidationPinScreenIntent.kt
│ │ │ │ │ │ └── ValidationPinScreenState.kt
│ │ │ │ │ ├── createpin
│ │ │ │ │ │ ├── CreatePinScreenIntent.kt
│ │ │ │ │ │ └── CreatePinScreenState.kt
│ │ │ │ │ ├── changepin
│ │ │ │ │ │ ├── ChangePinScreenIntent.kt
│ │ │ │ │ │ └── ChangePinScreenState.kt
│ │ │ │ │ ├── IPinCodeStateManager.kt
│ │ │ │ │ └── PinCodeStateManager.kt
│ │ │ │ ├── keyboard
│ │ │ │ │ └── KeyboardButtonEnum.kt
│ │ │ │ ├── encryption
│ │ │ │ │ ├── enums
│ │ │ │ │ │ └── Algorithm.kt
│ │ │ │ │ └── Encryptor.kt
│ │ │ │ ├── helpers
│ │ │ │ │ └── HandleButtonClick.kt
│ │ │ │ └── biometric
│ │ │ │ │ └── BiometricHelper.kt
│ │ │ │ ├── ui
│ │ │ │ ├── systemdesign
│ │ │ │ │ ├── theme
│ │ │ │ │ │ └── Dimens.kt
│ │ │ │ │ ├── dialog
│ │ │ │ │ │ └── ShowDialog.kt
│ │ │ │ │ ├── indicator
│ │ │ │ │ │ └── RoundedPinCodeIndicator.kt
│ │ │ │ │ └── ripple
│ │ │ │ │ │ └── RippleEffect.kt
│ │ │ │ ├── components
│ │ │ │ │ ├── PinCodeTitle.kt
│ │ │ │ │ ├── PinCodeNotification.kt
│ │ │ │ │ ├── PinCodeForgot.kt
│ │ │ │ │ ├── Keyboard.kt
│ │ │ │ │ ├── PinCodeContent.kt
│ │ │ │ │ └── KeyboardButton.kt
│ │ │ │ └── screens
│ │ │ │ │ ├── MainScreen.kt
│ │ │ │ │ ├── DeletePinScreen.kt
│ │ │ │ │ ├── CreatePinScreen.kt
│ │ │ │ │ ├── ValidationPinScreen.kt
│ │ │ │ │ └── ChangePinScreen.kt
│ │ │ │ └── viewmodel
│ │ │ │ └── PinViewModel.kt
│ │ └── res
│ │ │ ├── drawable
│ │ │ ├── ic_clear_30.xml
│ │ │ ├── ic_clear_white_30.xml
│ │ │ ├── ic_fingerprint_30.xml
│ │ │ ├── ic_fingerprint_white_30.xml
│ │ │ └── ic_fingerprint_transparent_30.xml
│ │ │ ├── values-en
│ │ │ └── strings.xml
│ │ │ ├── values-tr
│ │ │ └── strings.xml
│ │ │ ├── values-de
│ │ │ └── strings.xml
│ │ │ └── values
│ │ │ └── strings.xml
│ ├── test
│ │ └── java
│ │ │ └── com
│ │ │ └── android
│ │ │ └── pinlibrary
│ │ │ └── ExampleUnitTest.kt
│ └── androidTest
│ │ └── java
│ │ └── com
│ │ └── android
│ │ └── pinlibrary
│ │ └── ExampleInstrumentedTest.kt
├── proguard-rules.pro
└── build.gradle
├── .idea
├── .name
├── .gitignore
├── codeStyles
│ ├── codeStyleConfig.xml
│ └── Project.xml
├── vcs.xml
├── compiler.xml
├── kotlinc.xml
├── deploymentTargetDropDown.xml
├── migrations.xml
├── misc.xml
├── gradle.xml
└── inspectionProfiles
│ └── Project_Default.xml
├── screens
├── preview_russian.gif
├── preview_english_01.png
├── preview_english_02.png
└── preview_english_03.png
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── .gitignore
├── settings.gradle
├── LICENSE.md
├── gradle.properties
├── gradlew.bat
├── README.md
├── gradlew
└── README_RU.md
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
--------------------------------------------------------------------------------
/pinlibrary/.gitignore:
--------------------------------------------------------------------------------
1 | /build
--------------------------------------------------------------------------------
/.idea/.name:
--------------------------------------------------------------------------------
1 | Pin Authentication
--------------------------------------------------------------------------------
/pinlibrary/consumer-rules.pro:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/.idea/.gitignore:
--------------------------------------------------------------------------------
1 | # Default ignored files
2 | /shelf/
3 | /workspace.xml
4 |
--------------------------------------------------------------------------------
/screens/preview_russian.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/screens/preview_russian.gif
--------------------------------------------------------------------------------
/screens/preview_english_01.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/screens/preview_english_01.png
--------------------------------------------------------------------------------
/screens/preview_english_02.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/screens/preview_english_02.png
--------------------------------------------------------------------------------
/screens/preview_english_03.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/screens/preview_english_03.png
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Khokhlinvladimir/android-pin-authentication/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp
--------------------------------------------------------------------------------
/.idea/codeStyles/codeStyleConfig.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/.idea/vcs.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/.idea/compiler.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/.idea/kotlinc.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/app/src/main/res/values/themes.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/enums/PinCodeScenario.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.enums
2 |
3 | enum class PinCodeScenario {
4 | CREATION,
5 | CHANGE,
6 | DELETION,
7 | VALIDATION,
8 | STUB;
9 | }
--------------------------------------------------------------------------------
/.idea/deploymentTargetDropDown.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Wed Oct 25 16:26:40 MSK 2023
2 | distributionBase=GRADLE_USER_HOME
3 | distributionPath=wrapper/dists
4 | distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
5 | zipStoreBase=GRADLE_USER_HOME
6 | zipStorePath=wrapper/dists
7 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/caches
5 | /.idea/libraries
6 | /.idea/modules.xml
7 | /.idea/workspace.xml
8 | /.idea/navEditor.xml
9 | /.idea/assetWizardSettings.xml
10 | .DS_Store
11 | /build
12 | /captures
13 | .externalNativeBuild
14 | .cxx
15 | local.properties
16 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/preferences/IAttemptCounter.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.preferences
2 |
3 | interface IAttemptCounter {
4 | fun saveAttempts(attempts: Int)
5 | fun getAttempts(): Int
6 | fun decrementAttempts()
7 | fun resetAttempts()
8 | }
9 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/listeners/NumberListener.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.listeners
2 |
3 | import com.android.pinlibrary.utils.keyboard.KeyboardButtonEnum
4 |
5 | fun interface NumberListener {
6 | fun onNumberTriggered(keyboardEnum: KeyboardButtonEnum)
7 | }
8 |
--------------------------------------------------------------------------------
/.idea/migrations.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
9 |
10 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/preferences/IPinCodeManager.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.preferences
2 |
3 | interface IPinCodeManager {
4 | fun savePinCode(pinCode: String)
5 | fun loadPinCode(): String?
6 | fun clearPinCode()
7 | fun isPinCodeCorrect(enteredPinCode: String): Boolean
8 | }
9 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/deletepin/DeletePinScreenIntent.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.deletepin
2 |
3 | sealed class DeletePinScreenIntent {
4 |
5 | data object InitialState : DeletePinScreenIntent()
6 | data class EnterPin(val pin: String) : DeletePinScreenIntent()
7 | data object DeletePin : DeletePinScreenIntent()
8 | }
--------------------------------------------------------------------------------
/app/src/main/java/com/android/authentication/ui/theme/Color.kt:
--------------------------------------------------------------------------------
1 | package com.android.authentication.ui.theme
2 |
3 | import androidx.compose.ui.graphics.Color
4 |
5 | val Purple80 = Color(0xFFD0BCFF)
6 | val PurpleGrey80 = Color(0xFFCCC2DC)
7 | val Pink80 = Color(0xFFEFB8C8)
8 |
9 | val Purple40 = Color(0xFF6650a4)
10 | val PurpleGrey40 = Color(0xFF625b71)
11 | val Pink40 = Color(0xFF7D5260)
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/validationpin/ValidationPinScreenIntent.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.validationpin
2 |
3 | sealed class ValidationPinScreenIntent {
4 |
5 | data object InitialState : ValidationPinScreenIntent()
6 | data class EnterPin(val pin: String) : ValidationPinScreenIntent()
7 | data object ValidatePin : ValidationPinScreenIntent()
8 | }
--------------------------------------------------------------------------------
/.idea/misc.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/app/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | #FFBB86FC
4 | #FF6200EE
5 | #FF3700B3
6 | #FF03DAC5
7 | #FF018786
8 | #FF000000
9 | #FFFFFFFF
10 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | pluginManagement {
2 | repositories {
3 | google()
4 | mavenCentral()
5 | gradlePluginPortal()
6 | }
7 | }
8 | dependencyResolutionManagement {
9 | repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
10 | repositories {
11 | google()
12 | mavenCentral()
13 | }
14 | }
15 | rootProject.name = "Pin Authentication"
16 | include ':app'
17 | include ':pinlibrary'
18 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/createpin/CreatePinScreenIntent.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.createpin
2 |
3 | sealed class CreatePinScreenIntent {
4 |
5 | data object InitialState : CreatePinScreenIntent()
6 | data class EnterPin(val pin: String) : CreatePinScreenIntent()
7 | data class ConfirmPin(val pin: String) : CreatePinScreenIntent()
8 | data object CreatePin : CreatePinScreenIntent()
9 | }
10 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/keyboard/KeyboardButtonEnum.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.keyboard
2 |
3 | enum class KeyboardButtonEnum(val buttonValue: Int) {
4 | BUTTON_0(0),
5 | BUTTON_1(1),
6 | BUTTON_2(2),
7 | BUTTON_3(3),
8 | BUTTON_4(4),
9 | BUTTON_5(5),
10 | BUTTON_6(6),
11 | BUTTON_7(7),
12 | BUTTON_8(8),
13 | BUTTON_9(9),
14 | BUTTON_FINGERPRINT(10),
15 | BUTTON_CLEAR(-1);
16 | }
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/deletepin/DeletePinScreenState.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.deletepin
2 |
3 | sealed class DeletePinScreenState {
4 |
5 | data object InitialState : DeletePinScreenState()
6 | data class EnteringPinState(val pin: String) : DeletePinScreenState()
7 | data object PinDeletedState : DeletePinScreenState()
8 | data class ErrorState(val errorMessage: String) : DeletePinScreenState()
9 | }
--------------------------------------------------------------------------------
/pinlibrary/src/test/java/com/android/pinlibrary/ExampleUnitTest.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary
2 |
3 | import org.junit.Test
4 |
5 | import org.junit.Assert.*
6 |
7 | /**
8 | * Example local unit test, which will execute on the development machine (host).
9 | *
10 | * See [testing documentation](http://d.android.com/tools/testing).
11 | */
12 | class ExampleUnitTest {
13 | @Test
14 | fun addition_isCorrect() {
15 | assertEquals(4, 2 + 2)
16 | }
17 | }
--------------------------------------------------------------------------------
/app/src/test/java/com/android/authentication/ExampleUnitTest.kt:
--------------------------------------------------------------------------------
1 | package com.android.authentication
2 |
3 | import org.junit.Test
4 |
5 | import org.junit.Assert.*
6 |
7 | /**
8 | * Example local unit test, which will execute on the development machine (host).
9 | *
10 | * See [testing documentation](http://d.android.com/tools/testing).
11 | */
12 | class ExampleUnitTest {
13 | @Test
14 | fun addition_isCorrect() {
15 | assertEquals(4, 2 + 2)
16 | }
17 | }
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/validationpin/ValidationPinScreenState.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.validationpin
2 |
3 | sealed class ValidationPinScreenState {
4 |
5 | data object InitialState : ValidationPinScreenState()
6 | data class EnteringPinState(val pin: String) : ValidationPinScreenState()
7 | data class ErrorState(val errorMessage: String) : ValidationPinScreenState()
8 | data object PinValidatedState : ValidationPinScreenState()
9 | }
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/ui/systemdesign/theme/Dimens.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.ui.systemdesign.theme
2 |
3 | import androidx.compose.ui.unit.dp
4 | import androidx.compose.ui.unit.sp
5 |
6 | object Dimens {
7 | val verticalKeyboardButtonPadding = 10.dp
8 | val horizontalKeyboardButtonPadding = 23.dp
9 | val verticalKeyboardPadding = 16.dp
10 | val horizontalKeyboardPadding = 20.dp
11 | val keyBoardButtonSize = 50.dp
12 | val keyBoardButtonFontSize = 25.sp
13 | }
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/preferences/ISettingsManager.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.preferences
2 |
3 | interface ISettingsManager {
4 | fun isBiometricEnabled(): Boolean
5 | fun isAutoLaunchBiometricEnabled(): Boolean
6 | fun setAutoLaunchBiometricEnabled(enabled: Boolean)
7 | fun setBiometricEnabled(enabled: Boolean)
8 | fun getMaxPinAttempts(): Int
9 | fun setMaxPinAttempts(maxAttempts: Int)
10 | fun getPinLength(): Int
11 | fun setPinLength(pinLength: Int)
12 | }
13 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/changepin/ChangePinScreenIntent.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.changepin
2 |
3 | sealed class ChangePinScreenIntent {
4 |
5 | data object InitialState : ChangePinScreenIntent()
6 | data class EnterCurrentPin(val currentPin: String) : ChangePinScreenIntent()
7 | data class EnterNewPin(val newPin: String) : ChangePinScreenIntent()
8 | data class ConfirmNewPin(val newPin: String) : ChangePinScreenIntent()
9 | data object ChangePin : ChangePinScreenIntent()
10 | }
--------------------------------------------------------------------------------
/app/src/main/res/xml/backup_rules.xml:
--------------------------------------------------------------------------------
1 |
8 |
9 |
13 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/createpin/CreatePinScreenState.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.createpin
2 |
3 | sealed class CreatePinScreenState {
4 |
5 | data object InitialState : CreatePinScreenState()
6 | data class EnteringPinState(val pin: String) : CreatePinScreenState()
7 | data class ConfirmingPinState(val pin: String) : CreatePinScreenState()
8 | data object PinCreatedState : CreatePinScreenState()
9 | data class ErrorState(val errorMessage: String) : CreatePinScreenState()
10 | }
11 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/encryption/enums/Algorithm.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.encryption.enums
2 |
3 | enum class Algorithm(val value: String) {
4 | SHA1("1"), SHA256("2");
5 |
6 | companion object {
7 | @JvmStatic
8 | fun getFromText(text: String): Algorithm {
9 | for (algorithm in values()) {
10 | if (algorithm.value == text) {
11 | return algorithm
12 | }
13 | }
14 | return SHA1
15 | }
16 | }
17 | }
--------------------------------------------------------------------------------
/app/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | Pin Authentication
3 |
4 | Текущий статус: %s
5 | Создать Pin-код
6 | Валидировать Pin-код
7 | Изменить Pin-код
8 | Удалить Pin-код
9 | Pin-код создан
10 | Pin-код не создан
11 |
--------------------------------------------------------------------------------
/app/src/main/res/values-en/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | Pin Authentication
4 |
5 | Current status: %s
6 | Create Pin Code
7 | Validate Pin Code
8 | Change Pin Code
9 | Delete Pin Code
10 | Pin Code Created
11 | Pin Code Not Created
12 |
--------------------------------------------------------------------------------
/app/src/main/res/values-tr/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | Pin Authentication
4 |
5 | Mevcut durum: %s
6 | Pin Kodu Oluştur
7 | Pin Kodunu Doğrula
8 | Pin Kodunu Değiştir
9 | Pin Kodunu Sil
10 | Pin Kodu Oluşturuldu
11 | Pin Kodu Oluşturulmadı
12 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/changepin/ChangePinScreenState.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state.changepin
2 |
3 | sealed class ChangePinScreenState {
4 | data object InitialState : ChangePinScreenState()
5 | data class EnteringCurrentPin(val currentPin: String) : ChangePinScreenState()
6 | data class EnteringNewPin(val newPin: String) : ChangePinScreenState()
7 | data class ConfirmingNewPin(val newPin: String) : ChangePinScreenState()
8 | data object PinChangedSuccess : ChangePinScreenState()
9 | data class ErrorState(val errorMessage: String) : ChangePinScreenState()
10 | }
--------------------------------------------------------------------------------
/app/src/main/res/values-de/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | Pin Authentication
4 |
5 | Aktueller Status: %s
6 | PIN-Code erstellen
7 | PIN-Code überprüfen
8 | PIN-Code ändern
9 | PIN-Code löschen
10 | PIN-Code erstellt
11 | PIN-Code nicht erstellt
12 |
--------------------------------------------------------------------------------
/app/src/main/res/xml/data_extraction_rules.xml:
--------------------------------------------------------------------------------
1 |
6 |
7 |
8 |
12 |
13 |
19 |
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
--------------------------------------------------------------------------------
/app/src/androidTest/java/com/android/authentication/ExampleInstrumentedTest.kt:
--------------------------------------------------------------------------------
1 | package com.android.authentication
2 |
3 | import androidx.test.platform.app.InstrumentationRegistry
4 | import androidx.test.ext.junit.runners.AndroidJUnit4
5 |
6 | import org.junit.Test
7 | import org.junit.runner.RunWith
8 |
9 | import org.junit.Assert.*
10 |
11 | /**
12 | * Instrumented test, which will execute on an Android device.
13 | *
14 | * See [testing documentation](http://d.android.com/tools/testing).
15 | */
16 | @RunWith(AndroidJUnit4::class)
17 | class ExampleInstrumentedTest {
18 | @Test
19 | fun useAppContext() {
20 | // Context of the app under test.
21 | val appContext = InstrumentationRegistry.getInstrumentation().targetContext
22 | assertEquals("com.android.authentication", appContext.packageName)
23 | }
24 | }
--------------------------------------------------------------------------------
/pinlibrary/src/androidTest/java/com/android/pinlibrary/ExampleInstrumentedTest.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary
2 |
3 | import androidx.test.platform.app.InstrumentationRegistry
4 | import androidx.test.ext.junit.runners.AndroidJUnit4
5 |
6 | import org.junit.Test
7 | import org.junit.runner.RunWith
8 |
9 | import org.junit.Assert.*
10 |
11 | /**
12 | * Instrumented test, which will execute on an Android device.
13 | *
14 | * See [testing documentation](http://d.android.com/tools/testing).
15 | */
16 | @RunWith(AndroidJUnit4::class)
17 | class ExampleInstrumentedTest {
18 | @Test
19 | fun useAppContext() {
20 | // Context of the app under test.
21 | val appContext = InstrumentationRegistry.getInstrumentation().targetContext
22 | assertEquals("com.android.pinlibrary.test", appContext.packageName)
23 | }
24 | }
--------------------------------------------------------------------------------
/pinlibrary/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/ui/components/PinCodeTitle.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.ui.components
2 |
3 | import androidx.compose.foundation.layout.padding
4 | import androidx.compose.foundation.layout.wrapContentSize
5 | import androidx.compose.material3.Text
6 | import androidx.compose.runtime.Composable
7 | import androidx.compose.ui.Modifier
8 | import androidx.compose.ui.text.font.FontWeight
9 | import androidx.compose.ui.text.style.TextAlign
10 | import androidx.compose.ui.unit.dp
11 | import androidx.compose.ui.unit.sp
12 |
13 | @Composable
14 | fun PinCodeScreenHeader(text: String) {
15 | Text(
16 | text = text,
17 | fontWeight = FontWeight.Bold,
18 | fontSize = 24.sp,
19 | textAlign = TextAlign.Center,
20 | modifier = Modifier
21 | .wrapContentSize()
22 | .padding(horizontal = 16.dp, vertical = 0.dp)
23 | )
24 | }
25 |
--------------------------------------------------------------------------------
/.idea/gradle.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
20 |
21 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/res/drawable/ic_clear_30.xml:
--------------------------------------------------------------------------------
1 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/res/drawable/ic_clear_white_30.xml:
--------------------------------------------------------------------------------
1 |
3 |
4 |
5 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/helpers/HandleButtonClick.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.helpers
2 |
3 | import com.android.pinlibrary.utils.keyboard.KeyboardButtonEnum
4 |
5 | fun fillArrayWithButtons(
6 | button: KeyboardButtonEnum,
7 | array: MutableList,
8 | maxLength: Int,
9 | callback: (List) -> Unit
10 | ) {
11 |
12 | if (button == KeyboardButtonEnum.BUTTON_FINGERPRINT) {
13 | return
14 | }
15 |
16 | if (button == KeyboardButtonEnum.BUTTON_CLEAR) {
17 | /** If the "Clear" button was pressed, remove the last element from the array **/
18 | if (array.isNotEmpty()) {
19 | array.removeAt(array.size - 1)
20 | }
21 | } else {
22 | /** If there is no "Clear" button, add the button value to the array **/
23 | if (array.size < maxLength) {
24 | array.add(button.buttonValue)
25 | }
26 | }
27 |
28 | /** Call callback to notify about array changes **/
29 | callback(array)
30 | }
31 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/ui/components/PinCodeNotification.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.ui.components
2 |
3 | import androidx.compose.foundation.layout.padding
4 | import androidx.compose.foundation.layout.wrapContentSize
5 | import androidx.compose.material3.Text
6 | import androidx.compose.runtime.Composable
7 | import androidx.compose.ui.Modifier
8 | import androidx.compose.ui.graphics.Color
9 | import androidx.compose.ui.text.font.FontWeight
10 | import androidx.compose.ui.text.style.TextAlign
11 | import androidx.compose.ui.text.style.TextOverflow
12 | import androidx.compose.ui.unit.dp
13 | import androidx.compose.ui.unit.sp
14 |
15 | @Composable
16 | fun PinCodeScreenNotification(text: String) {
17 | Text(
18 | text = text,
19 | fontWeight = FontWeight.Normal,
20 | fontSize = 15.sp,
21 | color = Color.Red,
22 | textAlign = TextAlign.Center,
23 | modifier = Modifier
24 | .wrapContentSize()
25 | .padding(horizontal = 16.dp, vertical = 20.dp),
26 | overflow = TextOverflow.Visible
27 | )
28 | }
29 |
--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) [2023] [Khokhlin Vladimir]
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
15 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
--------------------------------------------------------------------------------
/app/src/main/java/com/android/authentication/ui/theme/Type.kt:
--------------------------------------------------------------------------------
1 | package com.android.authentication.ui.theme
2 |
3 | import androidx.compose.material3.Typography
4 | import androidx.compose.ui.text.TextStyle
5 | import androidx.compose.ui.text.font.FontFamily
6 | import androidx.compose.ui.text.font.FontWeight
7 | import androidx.compose.ui.unit.sp
8 |
9 | // Set of Material typography styles to start with
10 | val Typography = Typography(
11 | bodyLarge = TextStyle(
12 | fontFamily = FontFamily.Default,
13 | fontWeight = FontWeight.Normal,
14 | fontSize = 16.sp,
15 | lineHeight = 24.sp,
16 | letterSpacing = 0.5.sp
17 | )
18 | /* Other default text styles to override
19 | titleLarge = TextStyle(
20 | fontFamily = FontFamily.Default,
21 | fontWeight = FontWeight.Normal,
22 | fontSize = 22.sp,
23 | lineHeight = 28.sp,
24 | letterSpacing = 0.sp
25 | ),
26 | labelSmall = TextStyle(
27 | fontFamily = FontFamily.Default,
28 | fontWeight = FontWeight.Medium,
29 | fontSize = 11.sp,
30 | lineHeight = 16.sp,
31 | letterSpacing = 0.5.sp
32 | )
33 | */
34 | )
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/ui/screens/MainScreen.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.ui.screens
2 |
3 | import androidx.compose.runtime.Composable
4 | import androidx.compose.runtime.livedata.observeAsState
5 | import androidx.lifecycle.viewmodel.compose.viewModel
6 | import com.android.pinlibrary.utils.enums.PinCodeScenario
7 | import com.android.pinlibrary.utils.state.PinCodeStateManager
8 | import com.android.pinlibrary.viewmodel.PinViewModel
9 |
10 | @Composable
11 | fun PinCodeScreen() {
12 |
13 | val pinCodeStateManager = PinCodeStateManager.getInstance()
14 | val currentScenario = pinCodeStateManager.currentScenario.observeAsState()
15 | val pinViewModel = viewModel()
16 |
17 | when (currentScenario.value) {
18 | PinCodeScenario.CREATION -> CreatePinScreen(pinViewModel, pinCodeStateManager)
19 | PinCodeScenario.CHANGE -> ChangePinScreen(pinViewModel, pinCodeStateManager)
20 | PinCodeScenario.DELETION -> DeletePinScreen(pinViewModel, pinCodeStateManager)
21 | PinCodeScenario.VALIDATION -> ValidationPinScreen(
22 | pinViewModel,
23 | pinCodeStateManager,
24 | PinCodeScenario.VALIDATION
25 | )
26 |
27 | else -> {}
28 | }
29 | }
30 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/preferences/AttemptCounter.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.preferences
2 |
3 | import android.content.Context
4 | import android.content.SharedPreferences
5 |
6 | class AttemptCounter(val context: Context) : IAttemptCounter {
7 |
8 | private val sharedPreferences: SharedPreferences =
9 | context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
10 | private val settingsManager = SettingsManager(context = context)
11 |
12 | override fun saveAttempts(attempts: Int) {
13 | sharedPreferences.edit().putInt(KEY_ATTEMPTS, attempts).apply()
14 | }
15 |
16 | override fun getAttempts(): Int {
17 | return sharedPreferences.getInt(KEY_ATTEMPTS, settingsManager.getMaxPinAttempts())
18 | }
19 |
20 | override fun decrementAttempts() {
21 | val currentAttempts = getAttempts()
22 | if (currentAttempts > 0) {
23 | saveAttempts(currentAttempts - 1)
24 | }
25 | }
26 |
27 | override fun resetAttempts() {
28 | saveAttempts(settingsManager.getMaxPinAttempts())
29 | }
30 |
31 | companion object {
32 | private const val PREFS_NAME = "AttemptPrefs"
33 | private const val KEY_ATTEMPTS = "attempts"
34 | }
35 | }
36 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/ui/systemdesign/dialog/ShowDialog.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.ui.systemdesign.dialog
2 |
3 | import androidx.compose.material3.AlertDialog
4 | import androidx.compose.material3.Button
5 | import androidx.compose.material3.Text
6 | import androidx.compose.runtime.Composable
7 | import androidx.compose.ui.res.stringResource
8 | import com.android.pinlibrary.R
9 | import com.android.pinlibrary.utils.state.PinCodeStateManager
10 |
11 | @Composable
12 | fun ShowDialog(
13 | title: String,
14 | description: String,
15 | showDialog: Boolean,
16 | pinCodeStateManager: PinCodeStateManager,
17 | onDismiss: () -> Unit
18 | ) {
19 | if (showDialog) {
20 | AlertDialog(
21 | onDismissRequest = { onDismiss() },
22 | title = {
23 | Text(text = title)
24 | },
25 | text = {
26 | Text(text = description)
27 | },
28 | confirmButton = {
29 | Button(
30 | onClick = {
31 | pinCodeStateManager.setResetPassword()
32 | onDismiss()
33 | }
34 | ) {
35 | Text(text = stringResource(id = R.string.ok_button))
36 | }
37 | }
38 | )
39 | }
40 | }
41 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | # Project-wide Gradle settings.
2 | # IDE (e.g. Android Studio) users:
3 | # Gradle settings configured through the IDE *will override*
4 | # any settings specified in this file.
5 | # For more details on how to configure your build environment visit
6 | # http://www.gradle.org/docs/current/userguide/build_environment.html
7 | # Specifies the JVM arguments used for the daemon process.
8 | # The setting is particularly useful for tweaking memory settings.
9 | org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
10 | # When configured, Gradle will run in incubating parallel mode.
11 | # This option should only be used with decoupled projects. More details, visit
12 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
13 | # org.gradle.parallel=true
14 | # AndroidX package structure to make it clearer which packages are bundled with the
15 | # Android operating system, and which are packaged with your app's APK
16 | # https://developer.android.com/topic/libraries/support-library/androidx-rn
17 | android.useAndroidX=true
18 | # Kotlin code style for this project: "official" or "obsolete":
19 | kotlin.code.style=official
20 | # Enables namespacing of each library's R class so that its R class includes only the
21 | # resources declared in the library itself and none from the library's dependencies,
22 | # thereby reducing the size of the R class for that library
23 | android.nonTransitiveRClass=true
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/IPinCodeStateManager.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state
2 |
3 | import android.app.Application
4 | import androidx.lifecycle.LiveData
5 | import com.android.pinlibrary.utils.enums.PinCodeScenario
6 |
7 | interface IPinCodeStateManager {
8 | val currentScenario: LiveData
9 |
10 | fun setScenario(scenario: PinCodeScenario)
11 |
12 | fun onCreationSuccess(callback: (isSuccess: Boolean) -> Unit)
13 |
14 | fun onValidationSuccess(callback: (isSuccess: Boolean) -> Unit)
15 |
16 | fun onChangeSuccess(callback: (isSuccess: Boolean) -> Unit)
17 |
18 | fun onDeletionSuccess(callback: (isSuccess: Boolean) -> Unit)
19 |
20 | fun onLoginAttemptsExpended(callback: () -> Unit)
21 | fun onBiometricAuthentication(callback: (isSuccess: Boolean) -> Unit)
22 |
23 | fun onResetPassword(callback: () -> Unit)
24 |
25 | fun clearConfiguration(application: Application)
26 | fun isPinCodeSaved(application: Application): Boolean
27 |
28 | fun setBiometricEnabled(enabled: Boolean, application: Application): Boolean
29 | fun autoLaunchBiometricEnabled(enabled: Boolean, application: Application): Boolean
30 | fun setMaxPinAttempts(maxAttempts: Int, application: Application): Int
31 | fun setPinLength(pinLength: Int, application: Application): Int
32 |
33 | fun setTemporaryPinValidationState(isEnabled: Boolean)
34 | }
35 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/res/values-en/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | Forgot?
4 | Disable Pincode
5 | Create a PIN code
6 | Enter Pincode
7 | Enter Pincode
8 | Confirm Pincode
9 | Fingerprint
10 | Fingerprint recognized
11 | Fingerprint not recognized. Try again
12 | Incorrect PIN. Attempts left: %1$d
13 | PIN codes do not match
14 | Password successfully saved
15 |
16 | Authorization
17 | Use biometrics for authorization
18 | Confirm your identity
19 | Cancel
20 |
21 | Forgot PIN?
22 | If you forgot your PIN, you can reset it by re-authenticating
23 | OK
24 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/res/values-tr/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | PIN\'ı unuttunuz mu?
4 | %d haneli PIN\'i devre dışı bırak
5 | Bir PIN kodu oluşturun
6 | PIN girin
7 | PIN girin
8 | PIN\'inizi onaylayın
9 | Parmak izi
10 | Parmak izi kabul edildi
11 | Parmak izi tanınmadı. Tekrar deneyin.
12 | Yanlış PIN. Kalan deneme sayısı: %1$d
13 | PIN kodları uyuşmuyor
14 | Parola başarıyla kaydedildi
15 |
16 | Yetkilendirme
17 | Yetkilendirme için biyometriyi kullanın
18 | Kimliğinizi doğrulayın
19 | İptal
20 |
21 | PIN\'ı unuttunuz mu?
22 | PIN kodunuzu unuttuysanız, yeniden yetkilendirme yaparak sıfırlayabilirsiniz
23 | Tamam
24 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/res/values-de/strings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | PIN vergessen?
4 | %d-stellige PIN deaktivieren
5 | Erstellen Sie einen PIN-Code
6 | PIN eingeben
7 | PIN eingeben
8 | Bestätigen Sie Ihre PIN
9 | Fingerabdruck
10 | Fingerabdruck akzeptiert
11 | Fingerabdruck nicht erkannt. Versuchen Sie es erneut.
12 | Falsche PIN. Versuche übrig: %1$d
13 | PIN-Codes stimmen nicht überein
14 | Passwort erfolgreich gespeichert
15 |
16 | Authentifizierung
17 | Verwenden Sie die Biometrie zur Authentifizierung
18 | Bestätigen Sie Ihre Identität
19 | Abbrechen
20 |
21 | PIN vergessen?
22 | Wenn Sie Ihren PIN vergessen haben, können Sie ihn durch erneute Authentifizierung zurücksetzen
23 | OK
24 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable-v24/ic_launcher_foreground.xml:
--------------------------------------------------------------------------------
1 |
7 |
8 |
9 |
15 | 
12 |
13 | ## Main features
14 |
15 | 1. Simple and intuitive PIN authentication.
16 | 2. Reliable storage and protection of user PIN codes using encryption.
17 | 3. Ability to customize the required length and complexity of the PIN code.
18 | 4. Limit the number of attempts to enter a PIN code to prevent brute force attacks.
19 | 5. Advanced configuration options and event notifications.
20 |
21 | # Instructions for using the library for PIN code authentication
22 |
23 | This tutorial will help you become familiar with using the PIN authentication library in your application. The library provides a simple and reliable way to protect access to your application using a PIN code. Let's figure out how it works:
24 |
25 | ## Step 1: Installing the library
26 |
27 | Installing a PIN authentication library is the first step to securely protecting your application.
28 |
29 | 1. Add the dependency to your build.gradle file:
30 |
31 | ```gradle
32 | dependencies {
33 | implementation 'com.github.Khokhlinvladimir:android-pin-authentication:v1.0.5'
34 | }
35 | ```
36 | With this simple step, you will enable a powerful authentication tool in your application, making it reliable and secure.
37 |
38 | 2. Specifying the repository in the settings.gradle file:
39 |
40 | ```gradle
41 | dependencyResolutionManagement {
42 | repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
43 | repositories {
44 | mavenCentral()
45 | maven { url 'https://jitpack.io' }
46 | }
47 | }
48 | ```
49 | Don't forget to add this setting to your settings.gradle file to ensure the library will be available for download.
50 | ## Step 2: Initialize the library
51 |
52 | In your activity or fragment, initialize the library like this:
53 |
54 | ```kotlin
55 | val pinCodeStateManager = PinCodeStateManager.getInstance()
56 | ```
57 |
58 | ## Step 3: Configure Security Settings
59 |
60 | Set security options such as maximum number of PIN attempts, PIN length, and biometric authentication activation:
61 |
62 | ```kotlin
63 | pinCodeStateManager.setMaxPinAttempts(maxAttempts = 4, application = application)
64 | pinCodeStateManager.setPinLength(pinLength = 4, application = application)
65 | pinCodeStateManager.setBiometricEnabled(enabled = true, application = application)
66 | pinCodeStateManager.autoLaunchBiometricEnabled(enabled = true,application = application)
67 | ```
68 |
69 | ## Step 4: Create, validate, change and delete PIN code
70 |
71 | The library supports four main scenarios:
72 |
73 | ### 1. Create a PIN code
74 |
75 | ```kotlin
76 | pinCodeStateManager.setScenario(PinCodeScenario.CREATION)
77 | ```
78 |
79 | Allows the user to create a new PIN.
80 |
81 | ### 2. PIN code validation
82 |
83 | ```kotlin
84 | pinCodeStateManager.setScenario(PinCodeScenario.VALIDATION)
85 | ```
86 |
87 | The user can log into the application by entering their existing PIN. The library will check the entered PIN code for compliance and, if validated successfully, will provide access to the application.
88 |
89 | ### 3. Change PIN code
90 |
91 | ```kotlin
92 | pinCodeStateManager.setScenario(PinCodeScenario.CHANGE)
93 | ```
94 |
95 | Allows the user to change their current PIN to a new one.
96 |
97 | ### 4. Removing the PIN code
98 |
99 | ```kotlin
100 | pinCodeStateManager.setScenario(PinCodeScenario.DELETION)
101 | ```
102 |
103 | The user can delete their current PIN.
104 |
105 | ## Step 5: Event Handling
106 |
107 | Handle events such as successful PIN creation, validation, change, and deletion, as well as input attempts exhaustion:
108 |
109 | ```kotlin
110 | pinCodeStateManager.onCreationSuccess {
111 | // Handle successful PIN setting
112 | }
113 |
114 | pinCodeStateManager.onValidationSuccess {
115 | // Handle successful PIN validation
116 | }
117 |
118 | pinCodeStateManager.onLoginAttemptsExpended {
119 | // Handle exhaustion of PIN entry attempts
120 | }
121 |
122 | // and so on for other events
123 | ```
124 |
125 | ## Step 6: Integration with the application interface
126 |
127 | Integrate the library with your application's interface
128 |
129 | ```kotlin
130 | Surface(
131 | modifier = Modifier.fillMaxSize(),
132 | color = MaterialTheme.colorScheme.background
133 | ) {
134 | // Display a screen for entering or validating a PIN code
135 | PinCodeScreen()
136 | }
137 | ```
138 |
139 | These are the basic steps to use the library for PIN authentication in your Android application. Customize the library and handle events according to your needs to create a secure and seamless user experience.
140 |
141 | ## Technical specifications:
142 |
143 | Minimum SDK version (minSdk): 24
144 |
145 | Target SDK version (targetSdk): 34
146 |
147 | Gradle version: 8.5.2
148 |
149 | OpenJDK Version: 17.0.1
150 |
151 | ## License
152 |
153 | This library is distributed under the MIT license. Details can be found in the LICENSE file.
154 |
155 | ## Author
156 |
157 | The library is developed and maintained by Khokhlin Vladimir. You can contact me via telegram [@vkhokhlin](https://t.me/vkhokhlin).
158 |
159 | ## Assistance
160 |
161 | If you have suggestions for improving the library or find a bug, please create an issue or send a pull request to the GitHub repository.
162 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable/ic_launcher_background.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
10 |
15 |
20 |
25 |
30 |
35 |
40 |
45 |
50 |
55 |
60 |
65 |
70 |
75 |
80 |
85 |
90 |
95 |
100 |
105 |
110 |
115 |
120 |
125 |
130 |
135 |
140 |
145 |
150 |
155 |
160 |
165 |
170 |
171 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env sh
2 |
3 | #
4 | # Copyright 2015 the original author or authors.
5 | #
6 | # Licensed under the Apache License, Version 2.0 (the "License");
7 | # you may not use this file except in compliance with the License.
8 | # You may obtain a copy of the License at
9 | #
10 | # https://www.apache.org/licenses/LICENSE-2.0
11 | #
12 | # Unless required by applicable law or agreed to in writing, software
13 | # distributed under the License is distributed on an "AS IS" BASIS,
14 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | # See the License for the specific language governing permissions and
16 | # limitations under the License.
17 | #
18 |
19 | ##############################################################################
20 | ##
21 | ## Gradle start up script for UN*X
22 | ##
23 | ##############################################################################
24 |
25 | # Attempt to set APP_HOME
26 | # Resolve links: $0 may be a link
27 | PRG="$0"
28 | # Need this for relative symlinks.
29 | while [ -h "$PRG" ] ; do
30 | ls=`ls -ld "$PRG"`
31 | link=`expr "$ls" : '.*-> \(.*\)$'`
32 | if expr "$link" : '/.*' > /dev/null; then
33 | PRG="$link"
34 | else
35 | PRG=`dirname "$PRG"`"/$link"
36 | fi
37 | done
38 | SAVED="`pwd`"
39 | cd "`dirname \"$PRG\"`/" >/dev/null
40 | APP_HOME="`pwd -P`"
41 | cd "$SAVED" >/dev/null
42 |
43 | APP_NAME="Gradle"
44 | APP_BASE_NAME=`basename "$0"`
45 |
46 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
47 | DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
48 |
49 | # Use the maximum available, or set MAX_FD != -1 to use that value.
50 | MAX_FD="maximum"
51 |
52 | warn () {
53 | echo "$*"
54 | }
55 |
56 | die () {
57 | echo
58 | echo "$*"
59 | echo
60 | exit 1
61 | }
62 |
63 | # OS specific support (must be 'true' or 'false').
64 | cygwin=false
65 | msys=false
66 | darwin=false
67 | nonstop=false
68 | case "`uname`" in
69 | CYGWIN* )
70 | cygwin=true
71 | ;;
72 | Darwin* )
73 | darwin=true
74 | ;;
75 | MINGW* )
76 | msys=true
77 | ;;
78 | NONSTOP* )
79 | nonstop=true
80 | ;;
81 | esac
82 |
83 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
84 |
85 |
86 | # Determine the Java command to use to start the JVM.
87 | if [ -n "$JAVA_HOME" ] ; then
88 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
89 | # IBM's JDK on AIX uses strange locations for the executables
90 | JAVACMD="$JAVA_HOME/jre/sh/java"
91 | else
92 | JAVACMD="$JAVA_HOME/bin/java"
93 | fi
94 | if [ ! -x "$JAVACMD" ] ; then
95 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
96 |
97 | Please set the JAVA_HOME variable in your environment to match the
98 | location of your Java installation."
99 | fi
100 | else
101 | JAVACMD="java"
102 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
103 |
104 | Please set the JAVA_HOME variable in your environment to match the
105 | location of your Java installation."
106 | fi
107 |
108 | # Increase the maximum file descriptors if we can.
109 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
110 | MAX_FD_LIMIT=`ulimit -H -n`
111 | if [ $? -eq 0 ] ; then
112 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
113 | MAX_FD="$MAX_FD_LIMIT"
114 | fi
115 | ulimit -n $MAX_FD
116 | if [ $? -ne 0 ] ; then
117 | warn "Could not set maximum file descriptor limit: $MAX_FD"
118 | fi
119 | else
120 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
121 | fi
122 | fi
123 |
124 | # For Darwin, add options to specify how the application appears in the dock
125 | if $darwin; then
126 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
127 | fi
128 |
129 | # For Cygwin or MSYS, switch paths to Windows format before running java
130 | if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
131 | APP_HOME=`cygpath --path --mixed "$APP_HOME"`
132 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
133 |
134 | JAVACMD=`cygpath --unix "$JAVACMD"`
135 |
136 | # We build the pattern for arguments to be converted via cygpath
137 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
138 | SEP=""
139 | for dir in $ROOTDIRSRAW ; do
140 | ROOTDIRS="$ROOTDIRS$SEP$dir"
141 | SEP="|"
142 | done
143 | OURCYGPATTERN="(^($ROOTDIRS))"
144 | # Add a user-defined pattern to the cygpath arguments
145 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then
146 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
147 | fi
148 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
149 | i=0
150 | for arg in "$@" ; do
151 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
152 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
153 |
154 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
155 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
156 | else
157 | eval `echo args$i`="\"$arg\""
158 | fi
159 | i=`expr $i + 1`
160 | done
161 | case $i in
162 | 0) set -- ;;
163 | 1) set -- "$args0" ;;
164 | 2) set -- "$args0" "$args1" ;;
165 | 3) set -- "$args0" "$args1" "$args2" ;;
166 | 4) set -- "$args0" "$args1" "$args2" "$args3" ;;
167 | 5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
168 | 6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
169 | 7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
170 | 8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
171 | 9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
172 | esac
173 | fi
174 |
175 | # Escape application args
176 | save () {
177 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
178 | echo " "
179 | }
180 | APP_ARGS=`save "$@"`
181 |
182 | # Collect all arguments for the java command, following the shell quoting and substitution rules
183 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
184 |
185 | exec "$JAVACMD" "$@"
186 |
--------------------------------------------------------------------------------
/README_RU.md:
--------------------------------------------------------------------------------
1 | # PIN Authentication Library on Jetpack Compose
2 |
3 | [](https://jitpack.io/#Khokhlinvladimir/android-pin-authentication)
4 |
5 | [Версия на английском языке](https://github.com/Khokhlinvladimir/android-pin-authentication/blob/main/README.md)
6 |
7 | ## Описание
8 |
9 | Библиотека для аутентификации пользователей с использованием PIN-кода. Эта библиотека предоставляет удобные и безопасные способы проверки личности пользователей с помощью простого числового PIN-кода. Она может быть использована разработчиками при создании приложений, требующих дополнительного слоя безопасности или идентификации пользователей.
10 |
11 |
12 |
13 | ## Основные возможности
14 |
15 | 1. Простая и интуитивно понятная аутентификация с помощью PIN-кода.
16 | 2. Надежное хранение и защита PIN-кодов пользователей при помощи кодирования.
17 | 3. Возможность настройки требуемой длины и сложности PIN-кода.
18 | 4. Ограничение количества попыток ввода PIN-кода для предотвращения атак брутфорса.
19 | 5. Расширенные опции настройки и уведомлений о событиях.
20 |
21 | # Инструкция по использованию библиотеки для аутентификации по PIN-коду
22 |
23 | Эта инструкция поможет вам ознакомиться с использованием библиотеки для аутентификации по PIN-коду в вашем приложении. Библиотека предоставляет простой и надежный способ защиты доступа к вашему приложению с помощью PIN-кода. Давайте разберемся, как это работает:
24 |
25 | ## Шаг 1: Установка библиотеки
26 |
27 | Установка библиотеки для аутентификации по PIN-коду — первый шаг к безопасной защите вашего приложения.
28 |
29 | 1. Внесите зависимость в файл build.gradle:
30 |
31 | ```gradle
32 | dependencies {
33 | implementation 'com.github.Khokhlinvladimir:android-pin-authentication:v1.0.5'
34 | }
35 | ```
36 | С этим простым шагом, вы включите мощный инструмент аутентификации в вашем приложении, делая его надежным и безопасным.
37 |
38 | 2. Указание репозитория в файле settings.gradle:
39 |
40 | ```gradle
41 | dependencyResolutionManagement {
42 | repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
43 | repositories {
44 | mavenCentral()
45 | maven { url 'https://jitpack.io' }
46 | }
47 | }
48 | ```
49 | Не забудьте добавить эту настройку в ваш файл settings.gradle, чтобы убедиться, что библиотека будет доступна для загрузки.
50 | ## Шаг 2: Инициализация библиотеки
51 |
52 | В вашей активности или фрагменте инициализируйте библиотеку следующим образом:
53 |
54 | ```kotlin
55 | val pinCodeStateManager = PinCodeStateManager.getInstance()
56 | ```
57 |
58 | ## Шаг 3: Настройка параметров безопасности
59 |
60 | Установите параметры безопасности, такие как максимальное количество попыток ввода PIN-кода, длина PIN-кода и активация биометрической аутентификации:
61 |
62 | ```kotlin
63 | pinCodeStateManager.setMaxPinAttempts(maxAttempts = 4, application = application)
64 | pinCodeStateManager.setPinLength(pinLength = 4, application = application)
65 | pinCodeStateManager.setBiometricEnabled(enabled = true, application = application)
66 | pinCodeStateManager.autoLaunchBiometricEnabled(enabled = true,application = application)
67 | ```
68 |
69 | ## Шаг 4: Создание, валидация, изменение и удаление PIN-кода
70 |
71 | Библиотека поддерживает четыре основных сценария:
72 |
73 | ### 1. Создание PIN-кода
74 |
75 | ```kotlin
76 | pinCodeStateManager.setScenario(PinCodeScenario.CREATION)
77 | ```
78 |
79 | Позволяет пользователю создать новый PIN-код.
80 |
81 | ### 2. Валидация PIN-кода
82 |
83 | ```kotlin
84 | pinCodeStateManager.setScenario(PinCodeScenario.VALIDATION)
85 | ```
86 |
87 | Пользователь может войти в приложение, введя свой существующий PIN-код. Библиотека проверит введенный PIN-код на соответствие и, при успешной валидации, предоставит доступ к приложению.
88 |
89 | ### 3. Изменение PIN-кода
90 |
91 | ```kotlin
92 | pinCodeStateManager.setScenario(PinCodeScenario.CHANGE)
93 | ```
94 |
95 | Позволяет пользователю изменить свой текущий PIN-код на новый.
96 |
97 | ### 4. Удаление PIN-кода
98 |
99 | ```kotlin
100 | pinCodeStateManager.setScenario(PinCodeScenario.DELETION)
101 | ```
102 |
103 | Пользователь может удалить свой текущий PIN-код.
104 |
105 | ## Шаг 5: Обработка событий
106 |
107 | Обработайте события, такие как успешное создание, валидация, изменение и удаление PIN-кода, а также исчерпание попыток ввода:
108 |
109 | ```kotlin
110 | pinCodeStateManager.onCreationSuccess {
111 | // Обработка успешной установки PIN-кода
112 | }
113 |
114 | pinCodeStateManager.onValidationSuccess {
115 | // Обработка успешной валидации PIN-кода
116 | }
117 |
118 | pinCodeStateManager.onLoginAttemptsExpended {
119 | // Обработка исчерпания попыток ввода PIN-кода
120 | }
121 |
122 | // и так далее для других событий
123 | ```
124 |
125 | ## Шаг 6: Интеграция с интерфейсом приложения
126 |
127 | Интегрируйте библиотеку с интерфейсом вашего приложения
128 |
129 | ```kotlin
130 | Surface(
131 | modifier = Modifier.fillMaxSize(),
132 | color = MaterialTheme.colorScheme.background
133 | ) {
134 | // Вывести экран для ввода или валидации PIN-кода
135 | PinCodeScreen()
136 | }
137 | ```
138 |
139 | Это основные шаги по использованию библиотеки для аутентификации по PIN-коду в вашем Android-приложении. Настраивайте библиотеку и обрабатывайте события в соответствии с вашими потребностями для создания безопасного и удобного опыта для пользователей.
140 |
141 | ## Технические спецификации:
142 |
143 | Минимальная версия SDK (minSdk): 24
144 |
145 | Целевая версия SDK (targetSdk): 34
146 |
147 | Версия Gradle: 8.5.2
148 |
149 | Версия OpenJDK: 17.0.1
150 |
151 | ## Лицензия
152 |
153 | Эта библиотека распространяется под лицензией MIT. Подробности можно найти в файле LICENSE.
154 |
155 | ## Автор
156 |
157 | Библиотека разработана и поддерживается Khokhlin Vladimir. Вы можете связаться со мной через telegram [@vkhokhlin](https://t.me/vkhokhlin).
158 |
159 | ## Содействие
160 |
161 | Если у вас есть предложения по улучшению библиотеки или вы обнаружили ошибку, пожалуйста, создайте issue или отправьте пулл-реквест в репозиторий на GitHub.
162 |
--------------------------------------------------------------------------------
/pinlibrary/src/main/java/com/android/pinlibrary/utils/state/PinCodeStateManager.kt:
--------------------------------------------------------------------------------
1 | package com.android.pinlibrary.utils.state
2 |
3 | import android.app.Application
4 | import androidx.lifecycle.LiveData
5 | import androidx.lifecycle.MutableLiveData
6 | import com.android.pinlibrary.utils.enums.PinCodeScenario
7 | import com.android.pinlibrary.utils.preferences.AttemptCounter
8 | import com.android.pinlibrary.utils.preferences.PinCodeManager
9 | import com.android.pinlibrary.utils.preferences.SettingsManager
10 |
11 | /**
12 | * val pinCodeStateManager = PinCodeStateManager.getInstance()
13 | *
14 | * Installing the scenario
15 | * pinCodeStateManager.setScenario(PinCodeScenario.CREATION)
16 | *
17 | * Getting the current scenario using [LiveData]
18 | *
19 | * val currentScenarioLiveData = pinCodeStateManager.currentScenario
20 | * currentScenarioLiveData.observe(owner) { scenario ->
21 | * Handling a scenario change
22 | * }
23 | */
24 |
25 | class PinCodeStateManager private constructor() : IPinCodeStateManager {
26 |
27 | private val _currentScenario = MutableLiveData()
28 | override val currentScenario: LiveData = _currentScenario
29 |
30 | private var onLoginAttemptsExpended: (() -> Unit)? = null
31 | private var onCreationSuccess: ((isSuccess: Boolean) -> Unit)? = null
32 | private var onValidationSuccess: ((isSuccess: Boolean) -> Unit)? = null
33 | private var onChangeSuccess: ((isSuccess: Boolean) -> Unit)? = null
34 | private var onDeletionSuccess: ((isSuccess: Boolean) -> Unit)? = null
35 | private var onBiometricAuthentication: ((isSuccess: Boolean) -> Unit)? = null
36 | private var onResetPassword: (() -> Unit)? = null
37 | var isValidationEnabled: Boolean = true
38 |
39 | companion object {
40 | private var instance: PinCodeStateManager? = null
41 | fun getInstance(): PinCodeStateManager {
42 | return instance ?: synchronized(this) {
43 | instance ?: PinCodeStateManager().also { instance = it }
44 | }
45 | }
46 | }
47 |
48 | override fun setScenario(scenario: PinCodeScenario) {
49 | _currentScenario.value = scenario
50 | }
51 |
52 | internal fun setCreationSuccess(isSuccess: Boolean) {
53 | onCreationSuccess?.invoke(isSuccess)
54 | }
55 |
56 | override fun onCreationSuccess(callback: (isSuccess: Boolean) -> Unit) {
57 | this.onCreationSuccess = callback
58 | }
59 |
60 | internal fun setValidationSuccess(isSuccess: Boolean) {
61 | onValidationSuccess?.invoke(isSuccess)
62 | }
63 |
64 | override fun onValidationSuccess(callback: (isSuccess: Boolean) -> Unit) {
65 | this.onValidationSuccess = callback
66 | }
67 |
68 | internal fun setChangeSuccess(isSuccess: Boolean) {
69 | onChangeSuccess?.invoke(isSuccess)
70 | }
71 |
72 | override fun onChangeSuccess(callback: (isSuccess: Boolean) -> Unit) {
73 | this.onChangeSuccess = callback
74 | }
75 |
76 | internal fun setDeletionSuccess(isSuccess: Boolean) {
77 | onDeletionSuccess?.invoke(isSuccess)
78 | }
79 |
80 | override fun onDeletionSuccess(callback: (isSuccess: Boolean) -> Unit) {
81 | this.onDeletionSuccess = callback
82 | }
83 |
84 | internal fun setLoginAttemptsExpended() {
85 | onLoginAttemptsExpended?.invoke()
86 | }
87 |
88 | override fun onLoginAttemptsExpended(callback: () -> Unit) {
89 | this.onLoginAttemptsExpended = callback
90 | }
91 |
92 | internal fun setBiometricAuthentication(isSuccess: Boolean) {
93 | onBiometricAuthentication?.invoke(isSuccess)
94 | }
95 |
96 | override fun onBiometricAuthentication(callback: (isSuccess: Boolean) -> Unit) {
97 | this.onBiometricAuthentication = callback
98 | }
99 |
100 | internal fun setResetPassword() {
101 | onResetPassword?.invoke()
102 | }
103 |
104 | override fun onResetPassword(callback: () -> Unit) {
105 | this.onResetPassword = callback
106 | }
107 |
108 | override fun clearConfiguration(application: Application) {
109 | val pinCodeManager = PinCodeManager(context = application)
110 | val attemptCounter = AttemptCounter(context = application)
111 | pinCodeManager.clearPinCode()
112 | attemptCounter.resetAttempts()
113 | }
114 |
115 | override fun isPinCodeSaved(application: Application): Boolean {
116 | val pinCodeManager = PinCodeManager(context = application)
117 | return pinCodeManager.loadPinCode() != null
118 | }
119 |
120 | /**
121 | * Set the value of the "Enable biometrics" option and return the current value.
122 | *
123 | * @param enabled true to enable biometrics; false to turn off.
124 | * @param application Application context.
125 | * @return true if biometrics is enabled; false otherwise.
126 | */
127 | override fun setBiometricEnabled(enabled: Boolean, application: Application): Boolean {
128 | val settingsManager = SettingsManager(context = application)
129 | settingsManager.setBiometricEnabled(enabled)
130 | return settingsManager.isBiometricEnabled()
131 | }
132 |
133 | /**
134 | * Set the value of the "Auto-launch biometric authentication" option and return the current value.
135 | *
136 | * @param enabled true to enable automatic biometric dialog on validation start; false to disable.
137 | * @param application Application context.
138 | * @return true if automatic biometric launch is enabled; false otherwise.
139 | */
140 | override fun autoLaunchBiometricEnabled(enabled: Boolean, application: Application): Boolean {
141 | val settingsManager = SettingsManager(context = application)
142 | settingsManager.setAutoLaunchBiometricEnabled(enabled)
143 | return settingsManager.isAutoLaunchBiometricEnabled()
144 | }
145 |
146 | /**
147 | * Set the maximum number of pin code entry attempts and return the current value.
148 | *
149 | * @param maxAttempts New maximum number of attempts.
150 | * @param application Application context.
151 | * @return The current maximum number of retries.
152 | */
153 | override fun setMaxPinAttempts(maxAttempts: Int, application: Application): Int {
154 | val settingsManager = SettingsManager(context = application)
155 | settingsManager.setMaxPinAttempts(maxAttempts)
156 | return settingsManager.getMaxPinAttempts()
157 | }
158 |
159 | /**
160 | * Set pin length and return current value.
161 | *
162 | * @param pinLength New pin length.
163 | * @param application Application context.
164 | * @return Current pin length.
165 | */
166 | override fun setPinLength(pinLength: Int, application: Application): Int {
167 | val settingsManager = SettingsManager(context = application)
168 | settingsManager.setPinLength(pinLength)
169 | return settingsManager.getPinLength()
170 | }
171 |
172 | override fun setTemporaryPinValidationState(isEnabled: Boolean) {
173 | isValidationEnabled = isEnabled
174 | }
175 | }
--------------------------------------------------------------------------------
/app/src/main/java/com/android/authentication/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package com.android.authentication
2 |
3 | import android.os.Bundle
4 | import androidx.activity.ComponentActivity
5 | import androidx.activity.compose.setContent
6 | import androidx.compose.foundation.layout.fillMaxSize
7 | import androidx.compose.material3.MaterialTheme
8 | import androidx.compose.material3.Surface
9 | import androidx.compose.runtime.Composable
10 | import androidx.compose.runtime.getValue
11 | import androidx.compose.runtime.mutableStateOf
12 | import androidx.compose.runtime.remember
13 | import androidx.compose.runtime.setValue
14 | import androidx.compose.ui.Modifier
15 | import androidx.compose.ui.tooling.preview.Preview
16 | import com.android.authentication.ui.screens.PinCodeStartScreen
17 | import com.android.authentication.ui.theme.PinAuthenticationTheme
18 | import com.android.pinlibrary.ui.screens.PinCodeScreen
19 | import com.android.pinlibrary.utils.state.PinCodeStateManager
20 |
21 | class MainActivity : ComponentActivity() {
22 |
23 | override fun onCreate(savedInstanceState: Bundle?) {
24 | super.onCreate(savedInstanceState)
25 |
26 | val pinCodeStateManager = PinCodeStateManager.getInstance()
27 |
28 | setContent {
29 | PinAuthenticationTheme {
30 |
31 | var isPinCodeCreated by remember { mutableStateOf(false) }
32 | var isPinCodeScreenVisible by remember { mutableStateOf(false) }
33 |
34 | /**
35 | * Handler invoked when all login attempts with the PIN code have been exhausted.
36 | * This method is responsible for handling the event when all login attempts are used up.
37 | */
38 | pinCodeStateManager.onLoginAttemptsExpended {
39 | // Your handling logic here
40 | isPinCodeScreenVisible = false
41 | isPinCodeCreated = false
42 | pinCodeStateManager.clearConfiguration(application = application)
43 | }
44 |
45 | /**
46 | * Handler invoked upon successful biometric authentication.
47 | * This method is responsible for handling the event of successful biometric authentication of the user.
48 | */
49 | pinCodeStateManager.onBiometricAuthentication {
50 | // Your handling logic here
51 | isPinCodeScreenVisible = !it
52 | }
53 |
54 | /**
55 | * Handler invoked upon successful PIN code creation or setting.
56 | * This method is responsible for handling the event of successful PIN code creation or setting.
57 | */
58 | pinCodeStateManager.onCreationSuccess {
59 | // Your handling logic here
60 | isPinCodeScreenVisible = false
61 | isPinCodeCreated = true
62 | }
63 |
64 | /**
65 | * Handler invoked upon successful PIN code change.
66 | * This method is responsible for handling the event of successful PIN code change.
67 | */
68 | pinCodeStateManager.onChangeSuccess {
69 | // Your handling logic here
70 | isPinCodeScreenVisible = false
71 | }
72 |
73 | /**
74 | * Handler invoked upon successful PIN code validation.
75 | * This method is responsible for handling the event of successful validation of the entered PIN code.
76 | */
77 | pinCodeStateManager.onValidationSuccess {
78 | // Your handling logic here
79 | isPinCodeScreenVisible = false
80 | }
81 |
82 | /**
83 | * Handler invoked upon successful PIN code deletion.
84 | * This method is responsible for handling the event of successful PIN code deletion.
85 | */
86 | pinCodeStateManager.onDeletionSuccess {
87 | // Your handling logic here
88 | isPinCodeScreenVisible = false
89 | isPinCodeCreated = false
90 | }
91 |
92 | /**
93 | * Handler invoked when resetting the password.
94 | * This method is responsible for handling the event of password or PIN code reset.
95 | */
96 | pinCodeStateManager.onResetPassword {
97 | // Your handling logic here
98 | isPinCodeScreenVisible = false
99 | isPinCodeCreated = false
100 | pinCodeStateManager.clearConfiguration(application = application)
101 | }
102 |
103 | /**
104 | * Indicates whether a PIN code is saved in the application.
105 | *
106 | * @return True if a PIN code is saved, false otherwise.
107 | */
108 | val isPinCodeSaved = pinCodeStateManager.isPinCodeSaved(
109 | application = application
110 | )
111 | isPinCodeCreated = isPinCodeSaved
112 |
113 | /**
114 | * Sets the maximum number of PIN code attempts.
115 | *
116 | * @param maxAttempts The maximum number of PIN code attempts allowed.
117 | * @param application The application context.
118 | */
119 | val setMaxPinAttempts = pinCodeStateManager.setMaxPinAttempts(
120 | maxAttempts = 4,
121 | application = application
122 | )
123 |
124 | /**
125 | * Sets the length of the PIN code.
126 | *
127 | * @param pinLength The desired length for the PIN code.
128 | * @param application The application context.
129 | */
130 | val setPinLength =
131 | pinCodeStateManager.setPinLength(
132 | pinLength = 4,
133 | application = application
134 | )
135 |
136 | /**
137 | * Enables or disables biometric authentication for PIN code.
138 | *
139 | * @param enabled True to enable biometric authentication, false to disable.
140 | * @param application The application context.
141 | */
142 | val setBiometricEnabled = pinCodeStateManager.setBiometricEnabled(
143 | enabled = true,
144 | application = application
145 | )
146 |
147 | /**
148 | * Enables or disables automatic biometric authentication dialog launch on validation screen start.
149 | *
150 | * @param enabled True to enable automatic biometric launch, false to disable.
151 | * @param application The application context.
152 | */
153 | val autoLaunchBiometricEnabled = pinCodeStateManager.autoLaunchBiometricEnabled(
154 | enabled = true,
155 | application = application
156 | )
157 |
158 | Surface(
159 | modifier = Modifier.fillMaxSize(),
160 | color = MaterialTheme.colorScheme.background
161 | ) {
162 |
163 | if (isPinCodeScreenVisible) {
164 | PinCodeScreen()
165 | } else {
166 | PinCodeStartScreen(isPinCodeCreated) {
167 | pinCodeStateManager.setScenario(it)
168 | isPinCodeScreenVisible = true
169 | }
170 | }
171 | }
172 | }
173 | }
174 | }
175 | }
176 |
177 | @Preview(showBackground = true)
178 | @Composable
179 | fun GreetingPreview() {
180 | PinAuthenticationTheme {
181 | PinCodeScreen()
182 | }
183 | }
184 |
--------------------------------------------------------------------------------