Installation

Pour configurer le SDK dans votre projet, suivez ces étapes :

Étape 1 — Ajouter le dépôt Maven

Le SDK Android est distribué via le dépôt Maven propre à Unico. Ajoutez-le au bloc repositories dans votre fichier de build au niveau racine :

build.gradle.kts
build.gradle

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    maven { url = uri("https://maven-sdk.unico.run/sdk-mobile") }
  }
}

build.gradle (project)
allprojects {
  repositories {
    google()
    maven { url "https://maven-sdk.unico.run/sdk-mobile" }
  }
}

Étape 2 — Activer le support AndroidX (si nécessaire)

Ajoutez ce qui suit à gradle.properties à la racine du projet :

gradle.properties
android.useAndroidX=true

Jetifier

Pour les projets AGP 8.6+, Jetifier est désactivé par défaut. N'ajoutez android.enableJetifier=true que si votre projet dépend encore d'artefacts support-library hérités qui n'ont pas migré vers AndroidX — l'activer inutilement augmente le temps de compilation.

Étape 3 — Ajouter la dépendance SDK

Ajoutez acessobio-android au bloc dependencies dans votre fichier de build au niveau du module. Remplacez <latest_version> par la version actuelle (6.5.0) — voir les Notes de version pour la dernière version :

build.gradle.kts
build.gradle

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

app/build.gradle (module)
dependencies {
  implementation 'com.acesso:acessobio-android:<latest_version>'
}

Nommage d'artefact hérité

Le groupe Maven com.acesso et le nom d'artefact acessobio-android reflètent l'ancienne marque Acesso Digital — ce sont les identifiants d'artefacts publiés et ils ne changeront pas pour cette version du SDK. Ce même SDK est désigné sous le nom UnicoCheck dans la Référence API et d'autres supports Unico.

Étape 4 — Définir la compatibilité Java

Requis pour la compatibilité avec le niveau d'API minimum supporté par le SDK (26). Ajoutez ce qui suit à compileOptions dans le même fichier de build au niveau du module :

build.gradle.kts
build.gradle

app/build.gradle.kts (module)
android {
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}

app/build.gradle (module)
android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

Étape 5 — Ajouter les permissions AndroidManifest

Ajoutez les permissions minimales requises et la déclaration de fonctionnalité matérielle à votre 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" />

Filtrage de livraison Play Store

La déclaration <uses-feature> signale au Play Store que l'application nécessite un appareil photo, la filtrant pour les appareils qui en sont dépourvus. Définissez android:required="false" uniquement si votre application dispose d'un chemin alternatif sans appareil photo.

Permission d'exécution

Votre application est responsable de demander la permission CAMERA à l'utilisateur au moment de l'exécution avant d'ouvrir une session de capture. Sans permission accordée, le SDK ne sera pas en mesure d'ouvrir la caméra.

Scénario WebView

Certaines applications hybrides utilisent le SDK Android natif pour les flux biométriques standard tout en affichant des parcours spécifiques (tels que des flux d'intégration hérités ou des expériences régionales spécifiques) via le SDK Web dans une WebView. Si votre application suit ce modèle, des permissions supplémentaires sont requises. Consultez le guide d'intégration du SDK Web pour la liste complète.