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

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

# 安装

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

**步骤 1** — 添加 Maven 仓库Android SDK 通过 Unico 自有的 Maven 仓库分发。请将其添加到 `settings.gradle` 文件中的 `dependencyResolutionManagement` 块：

- settings.gradle.kts
- settings.gradle

settings.gradle.kts```
dependencyResolutionManagement {**  repositories {    google()    mavenCentral()    maven("https://maven-sdk.unico.run/sdk-mobile")  }}
```

settings.gradle```
dependencyResolutionManagement {  repositories {    google()    mavenCentral()    maven { url "https://maven-sdk.unico.run/sdk-mobile" }  }}
```

旧版项目如果您仍在使用根级 `build.gradle`/`build.gradle.kts` 声明仓库，请改为将 Unico 仓库添加到 `allprojects` 代码块中：build.gradle.ktsbuild.gradlebuild.gradle.kts (project)```
allprojects {  repositories {    google()    mavenCentral()    maven("https://maven-sdk.unico.run/sdk-mobile")  }}
```

build.gradle (project)```
allprojects {  repositories {    google()    mavenCentral()    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 依赖项将 `io.unico:capture` 添加到**模块级别**构建文件中的 `dependencies` 块。将 `<latest_version>` 替换为当前版本（**6.13.0**）——如需了解最新信息，请参阅[版本说明](/zh-CN/developers/sdks-and-tools/android/resources/release-notes)：build.gradle.ktsbuild.gradleapp/build.gradle.kts (module)```
dependencies {  implementation("io.unico:capture:<latest_version>")}
```

app/build.gradle (module)```
dependencies {  implementation 'io.unico:capture:<latest_version>'}
```

旧版包名Java/Kotlin 包名 `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月23日**