메인 콘텐츠로 건너뛰기

설치

프로젝트에 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를 추가하세요 — 불필요하게 활성화하면 빌드 시간이 늘어납니다.

3단계 — SDK 의존성 추가

모듈 레벨 빌드 파일의 dependencies 블록에 acessobio-android를 추가합니다. <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 통합 가이드를 참조하세요.

마지막 업데이트 에