Lewati ke konten utama

Instalasi

Markdown
Tambahkan dependensi dan konfigurasikan package manager
Langkah 1 — Tambahkan repositori Maven

Android SDK didistribusikan melalui repositori Maven milik Unico. Tambahkan ke blok dependencyResolutionManagement di file settings.gradle Anda:

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

Jika Anda masih menggunakan build.gradle/build.gradle.kts tingkat root untuk mendeklarasikan repositori, tambahkan repositori Unico ke blok allprojects sebagai gantinya:

build.gradle.kts (project)
allprojects {
repositories {
google()
mavenCentral()
maven("https://maven-sdk.unico.run/sdk-mobile")
}
}
Langkah 2 — Aktifkan dukungan AndroidX (jika diperlukan)

Tambahkan berikut ini ke gradle.properties di root proyek:

gradle.properties
android.useAndroidX=true
Jetifier

Untuk proyek AGP 8.6+, Jetifier dinonaktifkan secara default. Tambahkan android.enableJetifier=true hanya jika proyek Anda masih bergantung pada artefak support-library lama yang belum bermigrasi ke AndroidX — mengaktifkannya secara tidak perlu akan meningkatkan waktu build.

Langkah 3 — Tambahkan dependensi SDK

Tambahkan io.unico:capture ke blok dependencies di file build tingkat modul Anda. Ganti <latest_version> dengan versi saat ini (6.13.0) — lihat Catatan Rilis untuk versi terbaru:

app/build.gradle.kts (module)
dependencies {
implementation("io.unico:capture:<latest_version>")
}
Penamaan paket lama

Package Java/Kotlin com.acesso.acessobio_android mencerminkan merek Acesso Digital lama dan tidak akan berubah untuk versi SDK ini. SDK yang sama dirujuk sebagai UnicoCheck di API Reference dan materi Unico lainnya.

Langkah 4 — Atur kompatibilitas Java

Untuk menghindari ketidakcocokan frame dengan min-26, tambahkan konfigurasi berikut ke compileOptions di file build tingkat modul yang sama:

app/build.gradle.kts (module)
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
Langkah 5 — Tambahkan izin AndroidManifest

Tambahkan izin minimum yang diperlukan dan deklarasi fitur hardware ke AndroidManifest.xml Anda:

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" />
Pemfilteran pengiriman Play Store

Deklarasi <uses-feature> memberi sinyal kepada Play Store bahwa aplikasi memerlukan kamera, menyaringnya untuk perangkat yang tidak memilikinya. Atur android:required="false" hanya jika aplikasi Anda memiliki jalur fallback tanpa kamera.

Skenario WebView

Beberapa aplikasi hybrid menggunakan native Android SDK untuk alur biometrik standar sekaligus merender journey tertentu (seperti alur onboarding khusus atau pengalaman spesifik wilayah) melalui Web SDK di dalam WebView. Jika aplikasi Anda mengikuti pola ini, diperlukan izin tambahan. Lihat panduan integrasi Web SDK untuk daftar lengkapnya.