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

Установка

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

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

settings.gradle.kts
dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
Старые проекты

Если вы всё ещё используете корневой build.gradle/build.gradle.kts для объявления репозиториев, добавьте репозиторий Unico в блок allprojects:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven("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

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

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
Устаревшие наименования пакета

Пакет Java/Kotlin 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 для получения полного списка.

Последнее обновление