跳转到主要内容

安装

如需在项目中配置 SDK，请按照以下步骤操作：

步骤 1 — 添加 Maven 仓库

Android SDK 通过 Unico 自有的 Maven 仓库分发。请将其添加到根级别构建文件中的 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 默认已禁用。仅当您的项目仍依赖尚未迁移至 AndroidX 的旧版 support-library 制品时，才需添加 android.enableJetifier=true——不必要地启用 Jetifier 会增加构建时间。

步骤 3 — 添加 SDK 依赖项

将 acessobio-android 添加到模块级别构建文件中的 dependencies 块。将 <latest_version> 替换为当前版本（6.5.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 兼容性

为确保与 SDK 最低支持 API 级别（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"。

运行时权限

您的应用程序负责在打开采集会话之前，在运行时向用户请求 CAMERA 权限。若未授予该权限，SDK 将无法打开摄像头。

WebView 场景

部分混合应用在使用原生 Android SDK 处理标准生物识别流程的同时，也会通过 WebView 内嵌的 Web SDK 渲染特定业务流程（如旧版注册流程或特定地区的体验）。若您的应用采用此模式，则需要额外的权限。完整列表请参阅 Web SDK 集成指南。

最后更新 于