---
title: 安装
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/android/installation/
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- [SDK 与工具](/zh-CN/dual-api/developers/sdks-and-tools/overview)
- [Android SDK](/zh-CN/dual-api/developers/sdks-and-tools/android/requirements)
- 安装

# 安装

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

**步骤 1** — 添加 Maven 仓库Android SDK 通过 Unico 自有的 Maven 仓库分发。请将其添加到**根级别**构建文件中的 `repositories` 块：

- build.gradle.kts
- build.gradle

build.gradle.kts (project)```
allprojects {**  repositories {    google()    maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }  }}
```

build.gradle (project)```
allprojects {  repositories {    google()    maven { url "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.10.1**）——如需了解最新信息，请参阅[版本说明](/zh-CN/developers/sdks-and-tools/android/resources/release-notes)：build.gradle.ktsbuild.gradleapp/build.gradle.kts (module)```
dependencies {  implementation("com.acesso:acessobio-android:<latest_version>")}
```

app/build.gradle (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` 中添加以下内容：build.gradle.ktsbuild.gradleapp/build.gradle.kts (module)```
android {  compileOptions {    sourceCompatibility = JavaVersion.VERSION_1_8    targetCompatibility = JavaVersion.VERSION_1_8  }}
```

app/build.gradle (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 集成指南](/zh-CN/developers/sdks-and-tools/web)。最后更新 于 2026年10月8日**