Zum Hauptinhalt springen

Installation

Abhängigkeit hinzufügen und Paketmanager konfigurieren
Schritt 1 — Maven-Repository hinzufügen

Das Android-SDK wird über Unicos eigenes Maven-Repository verteilt. Fügen Sie es dem repositories-Block in Ihrer Root-Level-Build-Datei hinzu:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
  }
}
Schritt 2 — AndroidX-Unterstützung aktivieren (falls erforderlich)

Fügen Sie Folgendes zur gradle.properties im Projektstamm hinzu:

gradle.properties
android.useAndroidX=true
Jetifier

Bei AGP-8.6+-Projekten ist Jetifier standardmäßig deaktiviert. Fügen Sie android.enableJetifier=true nur dann hinzu, wenn Ihr Projekt noch von Legacy-support-library-Artefakten abhängt, die nicht zu AndroidX migriert wurden — eine unnötige Aktivierung verlängert die Build-Zeit.

Schritt 3 — SDK-Abhängigkeit hinzufügen

Fügen Sie acessobio-android zum dependencies-Block in Ihrer modulbezogenen Build-Datei hinzu. Ersetzen Sie <latest_version> durch die aktuelle Version (6.3.0) — unter Release Notes finden Sie stets den aktuellen Stand:

app/build.gradle.kts (module)
dependencies {
  implementation("com.acesso:acessobio-android:<latest_version>")
}
Legacy artifact naming

Die Maven-Gruppe com.acesso und der Artefaktname acessobio-android spiegeln das historische Acesso-Digital-Branding wider — dies sind die veröffentlichten Artefakt-Bezeichner und werden für diese SDK-Version nicht geändert. Dasselbe SDK wird in der API-Referenz und anderen Unico-Materialien als UnicoCheck bezeichnet.

Schritt 4 — Java-Kompatibilität festlegen

Um Frame-Inkompatibilität mit min-26 zu vermeiden, fügen Sie Folgendes zu compileOptions in derselben modulbezogenen Build-Datei hinzu:

app/build.gradle.kts (module)
android {
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}
Schritt 5 — AndroidManifest-Berechtigungen hinzufügen

Fügen Sie die mindestens erforderlichen Berechtigungen und die Hardware-Feature-Deklaration zu Ihrer AndroidManifest.xml hinzu:

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

Die <uses-feature>-Deklaration signalisiert dem Play Store, dass die App eine Kamera benötigt, und filtert sie für Geräte ohne Kamera heraus. Setzen Sie android:required="false" nur dann, wenn Ihre App einen kamerafreien Fallback-Pfad hat.

WebView-Szenario

Einige Hybrid-Apps nutzen das native Android-SDK für standardmäßige biometrische Abläufe und rendern dabei bestimmte Nutzerführungen (z. B. Legacy-Onboarding-Flows oder regionsspezifische Erlebnisse) über das Web-SDK in einer WebView. Falls Ihre App diesem Muster folgt, sind zusätzliche Berechtigungen erforderlich. Die vollständige Liste finden Sie im Leitfaden zur Web-SDK-Integration.

Zuletzt aktualisiert am