Instalasi
Langkah 1 — Tambahkan repositori Maven
Android SDK didistribusikan melalui repositori Maven milik Unico. Tambahkan ke blok repositories di file build tingkat root Anda:
- build.gradle.kts
- build.gradle
allprojects {
repositories {
google()
maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
}
}
allprojects {
repositories {
google()
maven { url "https://maven-sdk.unico.run/sdk-mobile" }
}
}
Langkah 2 — Aktifkan dukungan AndroidX (jika diperlukan)
Tambahkan berikut ini ke gradle.properties di root proyek:
android.useAndroidX=true
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 acessobio-android ke blok dependencies di file build tingkat modul Anda. Ganti <latest_version> dengan versi saat ini (6.3.0) — lihat Catatan Rilis untuk versi terbaru:
- build.gradle.kts
- build.gradle
dependencies {
implementation("com.acesso:acessobio-android:<latest_version>")
}
dependencies {
implementation 'com.acesso:acessobio-android:<latest_version>'
}
Maven group com.acesso dan nama artefak acessobio-android mencerminkan merek Acesso Digital lama — ini adalah identifier artefak yang dipublikasikan 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:
- build.gradle.kts
- build.gradle
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
}
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:
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
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.
Beberapa aplikasi hybrid menggunakan native Android SDK untuk alur biometrik standar sekaligus merender journey tertentu (seperti alur onboarding lama 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.