Установка
Шаг 1 — Добавьте репозиторий Maven
Android SDK распространяется через собственный репозиторий Maven компании Unico. Добавьте его в блок repositories в файле сборки корневого уровня:
- build.gradle.kts
- build.gradle
allprojects {
repositories {
google()
maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
}
}
allprojects {
repositories {
google()
maven { url "https://maven-sdk.unico.run/sdk-mobile" }
}
}
Шаг 2 — Включите поддержку AndroidX (при необходимости)
Добавьте следующее в gradle.properties в корне проекта:
android.useAndroidX=true
В проектах с AGP 8.6+ Jetifier отключён по умолчанию. Добавляйте android.enableJetifier=true только в том случае, если ваш проект по-прежнему зависит от устаревших артефактов support-library, которые не перешли на AndroidX — включение Jetifier без необходимости увеличивает время сборки.
Шаг 3 — Добавьте зависимость SDK
Добавьте acessobio-android в блок dependencies в файле сборки уровня модуля. Замените <latest_version> текущей версией (6.10.1) — актуальные сведения см. в Примечаниях к выпуску:
- build.gradle.kts
- build.gradle
dependencies {
implementation("com.acesso:acessobio-android:<latest_version>")
}
dependencies {
implementation 'com.acesso:acessobio-android:<latest_version>'
}
Группа Maven com.acesso и имя артефакта acessobio-android отражают прежний брендинг Acesso Digital — это опубликованные идентификаторы артефакта, которые не изменятся для данной версии SDK. Тот же SDK в справочнике API и других материалах Unico называется UnicoCheck.
Шаг 4 — Настройте совместимость с Java
Чтобы избежать несовместимости с min-26, добавьте следующее в compileOptions в том же файле сборки уровня модуля:
- build.gradle.kts
- build.gradle
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
Шаг 5 — Добавьте разрешения в AndroidManifest
Добавьте минимально необходимые разрешения и объявление аппа ратного компонента в ваш AndroidManifest.xml:
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
Объявление <uses-feature> сообщает Play Store, что приложению требуется камера, и исключает его из результатов для устройств без камеры. Устанавливайте android:required="false" только в том случае, если в вашем приложении предусмотрен резервный путь без использования камеры.
Некоторые гибридные приложения используют нативный Android SDK для стандартных биометрических сценариев, одновременно отображая отдельные пользовательские маршруты (например, индивидуальные онбординговые потоки или региональные сценарии) через Web SDK внутри WebView. Если ваше приложение следует этому паттерну, требуются дополнительные разрешения. Обратитесь к руководству по интеграции Web SDK для получения полного списка.