Saltar al contenido principal

Instalación

Markdown

Para configurar el SDK en tu proyecto, sigue estos pasos:

Paso 1 — Agregar el repositorio Maven

El SDK de Android se distribuye a través del repositorio Maven propio de Unico. Agrégalo al bloque dependencyResolutionManagement en tu archivo settings.gradle:

settings.gradle.kts
dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
Proyectos más antiguos

Si todavía usas el build.gradle/build.gradle.kts de nivel raíz para declarar los repositorios, agrega el repositorio de Unico al bloque allprojects en su lugar:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
Paso 2 — Habilitar soporte de AndroidX (si es necesario)

Agrega lo siguiente a gradle.properties en la raíz del proyecto:

gradle.properties
android.useAndroidX=true
Jetifier

Para proyectos con AGP 8.6+, Jetifier está deshabilitado de forma predeterminada. Solo agrega android.enableJetifier=true si tu proyecto aún depende de artefactos support-library heredados que no han migrado a AndroidX — habilitarlo innecesariamente aumenta el tiempo de compilación.

Paso 3 — Agregar la dependencia del SDK

Agrega io.unico:capture al bloque dependencies en el archivo de compilación de nivel de módulo. Reemplaza <latest_version> con la versión actual (6.13.0) — consulta las Notas de versión para la más reciente:

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
Nomenclatura de paquete heredada

El paquete Java/Kotlin com.acesso.acessobio_android refleja la marca heredada de Acesso Digital y no cambiará para esta versión del SDK. El mismo SDK se denomina UnicoCheck en la Referencia de API y otros materiales de Unico.

Paso 4 — Configurar compatibilidad con Java

Requerido para compatibilidad con el nivel de API mínimo soportado por el SDK (26). Agrega lo siguiente a compileOptions en el mismo archivo de compilación de nivel de módulo:

app/build.gradle.kts (module)
android {
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}
Paso 5 — Agregar permisos en AndroidManifest

Agrega los permisos mínimos requeridos y la declaración de función de hardware a tu 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" />
Filtrado de entrega en Play Store

La declaración <uses-feature> indica a Play Store que la app requiere cámara, filtrándola para dispositivos que no la tengan. Establece android:required="false" solo si tu app tiene una ruta alternativa sin cámara.

Permiso en tiempo de ejecución

Tu app es responsable de solicitar el permiso CAMERA al usuario en tiempo de ejecución antes de abrir una sesión de captura. Sin un permiso concedido, el SDK no podrá abrir la cámara.

Escenario WebView

Algunas apps híbridas usan el SDK nativo de Android para flujos biométricos estándar mientras renderizan journeys específicos (como flujos de onboarding personalizados o experiencias regionales específicas) a través del SDK Web dentro de un WebView. Si tu app sigue este patrón, se requieren permisos adicionales. Consulta la guía de integración del SDK Web para ver la lista completa.

Última actualización el