Saltar al contenido principal

Instalación

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 repositories en el archivo de compilación de nivel raíz:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    maven { url = uri("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 acessobio-android al bloque dependencies en el archivo de compilación de nivel de módulo. Reemplaza <latest_version> con la versión actual (6.5.0) — consulta las Notas de versión para la más reciente:

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

El grupo Maven com.acesso y el nombre de artefacto acessobio-android reflejan la marca heredada de Acesso Digital — estos son los identificadores de artefacto publicados y no cambiarán 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 heredados 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