Lewati ke konten utama

Instalasi

Tambahkan dependensi dan konfigurasikan package manager
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 (project)
allprojects {
repositories {
google()
maven { url = uri("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 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:

app/build.gradle.kts (module)
dependencies {
implementation("com.acesso:acessobio-android:<latest_version>")
}
Penamaan artefak lama

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:

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 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.