Aller au contenu principal

Installation

Markdown

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 dependencyResolutionManagement dans votre fichier settings.gradle :

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

Si vous utilisez encore le build.gradle/build.gradle.kts de niveau racine pour déclarer les dépôts, ajoutez plutôt le dépôt Unico au bloc allprojects :

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven("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 io.unico:capture au bloc dependencies dans votre fichier de build au niveau du module. Remplacez <latest_version> par la version actuelle (6.13.0) — voir les Notes de version pour la dernière version :

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
Nommage de package hérité

Le package Java/Kotlin com.acesso.acessobio_android reflète l'ancienne marque Acesso Digital et ne changera 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 :

app/build.gradle.kts (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 personnalisé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.

Dernière mise à jour le