Pular para o conteúdo principal

Instalação

Markdown

Para configurar o SDK no seu projeto, siga os seguintes passos:

Etapa 1 — Adicionar o repositório Maven

O SDK Android é distribuído por meio do repositório Maven próprio da Unico. Adicione-o ao bloco dependencyResolutionManagement no arquivo settings.gradle do seu projeto:

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

Se você ainda estiver usando o build.gradle/build.gradle.kts de nível raiz para declarar repositórios, adicione o repositório da Unico ao bloco allprojects em vez disso:

build.gradle.kts (project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven("https://maven-sdk.unico.run/sdk-mobile")
  }
}
Etapa 2 — Habilitar o suporte ao AndroidX (se necessário)

Adicione o seguinte ao gradle.properties na raiz do projeto:

gradle.properties
android.useAndroidX=true
Jetifier

Para projetos com AGP 8.6+, o Jetifier está desativado por padrão. Adicione android.enableJetifier=true apenas se o seu projeto ainda depender de artefatos legados da support-library que não foram migrados para o AndroidX — habilitá-lo desnecessariamente aumenta o tempo de build.

Etapa 3 — Adicionar a dependência do SDK

Adicione io.unico:capture ao bloco dependencies no arquivo de build do nível de módulo. Substitua <latest_version> pela versão atual (6.13.0) — consulte as Notas de versão para obter a mais recente:

app/build.gradle.kts (module)
dependencies {
  implementation("io.unico:capture:<latest_version>")
}
Nomenclatura legada do pacote

O pacote Java/Kotlin com.acesso.acessobio_android reflete a marca legada da Acesso Digital e não será alterado nesta versão do SDK. O mesmo SDK é referenciado como UnicoCheck na Referência de API e em outros materiais da Unico.

Etapa 4 — Definir a compatibilidade com Java

Necessário para compatibilidade com o nível mínimo de API suportado pelo SDK (26). Adicione o seguinte a compileOptions no mesmo arquivo de build do nível de módulo:

app/build.gradle.kts (module)
android {
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}
Etapa 5 — Adicionar permissões ao AndroidManifest

Adicione as permissões mínimas necessárias e a declaração de recurso de hardware ao seu 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" />
Filtragem de entrega na Play Store

A declaração <uses-feature> sinaliza à Play Store que o app requer câmera, filtrando-o para dispositivos sem câmera. Defina android:required="false" somente se o seu app tiver um fluxo alternativo sem câmera.

Permissão em tempo de execução

O app é responsável por solicitar a permissão de CAMERA ao usuário em tempo de execução antes de abrir uma sessão de captura. Sem a permissão concedida, o SDK não conseguirá abrir a câmera.

Cenário WebView

Alguns apps híbridos utilizam o SDK Android nativo para fluxos biométricos padrão e renderizam jornadas específicas (como fluxos de cadastro personalizados ou experiências regionais) por meio do Web SDK dentro de uma WebView. Se o seu app segue esse padrão, permissões adicionais são necessárias. Consulte o guia de integração do Web SDK para a lista completa.

Última atualização em