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

- [/ko/](/ko/)
- [SDK 및 도구](/ko/dual-api/developers/sdks-and-tools/overview)
- [Android SDK](/ko/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
```

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