---
title: 설치
canonical: https://developer.unico.io/ko/developers/sdks-and-tools/android/installation/
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [SDK 및 도구](/ko/developers/sdks-and-tools/overview)
- [Android SDK](/ko/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`에서 저장소를 선언하고 있다면, 대신 `allprojects` 블록에 Unico 저장소를 추가하세요: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
```

JetifierAGP 8.6+ 프로젝트의 경우 Jetifier는 기본적으로 비활성화되어 있습니다. 프로젝트가 AndroidX로 마이그레이션되지 않은 레거시 `support-library` 아티팩트에 여전히 의존하는 경우에만 `android.enableJetifier=true`를 추가하세요 — 불필요하게 활성화하면 빌드 시간이 늘어납니다.
**3단계** — SDK 의존성 추가**모듈 레벨** 빌드 파일의 `dependencies` 블록에 `io.unico:capture`를 추가합니다. `<latest_version>`을 현재 버전(**6.13.0**)으로 교체하세요 — 최신 정보는 [릴리스 노트](/ko/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 통합 가이드](/ko/developers/sdks-and-tools/web)를 참조하세요.마지막 업데이트 2026년 10월 23일**에