Перейти к основному содержимому

Установка

Добавьте зависимость и настройте менеджер пакетов
Шаг 1 — Добавьте репозиторий Maven

Android SDK распространяется через собственный репозиторий Maven компании Unico. Добавьте его в блок repositories в файле сборки корневого уровня:

build.gradle.kts (project)
allprojects {
repositories {
google()
maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
}
}
Шаг 2 — Включите поддержку AndroidX (при необходимости)

Добавьте следующее в gradle.properties в корне проекта:

gradle.properties
android.useAndroidX=true
Jetifier

В проектах с AGP 8.6+ Jetifier отключён по умолчанию. Добавляйте android.enableJetifier=true только в том случае, если ваш проект по-прежнему зависит от устаревших артефактов support-library, которые не перешли на AndroidX — включение Jetifier без необходимости увеличивает время сборки.

Шаг 3 — Добавьте зависимость SDK

Добавьте acessobio-android в блок dependencies в файле сборки уровня модуля. Замените <latest_version> текущей версией (6.3.0) — актуальные сведения см. в Примечаниях к выпуску:

app/build.gradle.kts (module)
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 в том же файле сборки уровня модуля:

app/build.gradle.kts (module)
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
Шаг 5 — Добавьте разрешения в AndroidManifest

Добавьте минимально необходимые разрешения и объявление аппаратного компонента в ваш AndroidManifest.xml:

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" />
Фильтрация доставки в Play Store

Объявление <uses-feature> сообщает Play Store, что приложению требуется камера, и исключает его из результатов для устройств без камеры. Устанавливайте android:required="false" только в том случае, если в вашем приложении предусмотрен резервный путь без использования камеры.

Сценарий с WebView

Некоторые гибридные приложения используют нативный Android SDK для стандартных биометрических сценариев, одновременно отображая отдельные пользовательские маршруты (например, устаревшие онбординговые потоки или региональные сценарии) через Web SDK внутри WebView. Если ваше приложение следует этому паттерну, требуются дополнительные разрешения. Обратитесь к руководству по интеграции Web SDK для получения полного списка.