# Guia de instalação
## Pré-requisitos do ambiente de desenvolvimento
É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:
| |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| - Possuir a versão 9 ou superior do Android Studio instalado (IDE oficial de desenvolvimento do Google);
|
| - Possuir a versão do SDK Android na versão 21 ou superior;
|
| - Possuir o repositório Maven da Unico configurado.
|
{% hint style="info" %}
O componente de captura disponibilizado por meio do **SDK Android** dá suporte às versões igual ou superiores para as tecnologias:
* **Android:** 5.0 (API 21);
* **Kotlin:** 1.8.22.
{% endhint %}
## Dispositivos compatíveis
{% hint style="info" %}
Este SDK não funciona em emuladores, somente em dispositivos físicos.
{% endhint %}
O **SDK Android** é compatível com a grande maioria dos dispositivos que possuam Android 5.0 (API de nível 21) ou versões superiores.
A tabela a seguir lista os dispositivos testados em laboratório, além da disponibilidade das extensões do fornecedor/fabricante. Algumas extensões listadas podem estar sujeitas as API ou SKUs específicos do fabricante. Clique abaixo para ver os dispositivos testados:
Dispositivos testados
| **Dispositivo** | **Versão do Android** | **Resultado do teste** | **Tipo do teste** |
| ------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
| ASUS - X01BDA | 10.0.0 |  | Físico |
| ASUS - Z01KD | 8.0.1 |  | Físico |
| HUAWEY - P30 Lite | 9.0.0 |  | Físico |
| LG - K22 | 10.0.0 |  | Físico |
| LG - Q6 | 7.0.0 |  | Físico |
| MOTOROLA - Moto one macro | 10.0.0 |  | Físico |
| MOTOROLA - Moto G4 | 6.0.1 |  | Físico |
| MOTOROLA - Moto G5s Plus | 8.1.0 |  | Físico |
| MOTOROLA - Moto G6 Play | 9.0.0 |  | Físico |
| MOTOROLA - Moto G7 Play | 10.0.0 |  | Físico |
| MOTOROLA - Moto G7 Power | 10.0.0 |  | Físico |
| MOTOROLA - Moto G8 Power Lite | 10.0.0 |  | Físico |
| SAMSUNG - A01 | 10.0.0 |  | Físico |
| SAMSUNG - J8 SM J810M | 8.1.0 |  | Físico |
| SAMSUNG - Galaxy A30s SM-A307GT | 10.0.0 |  | Físico |
| SAMSUNG - Galaxy A51 | 10.0.0 |  | Físico |
| SAMSUNG - Galaxy A71 | 11.0.0 |  | Físico |
| SAMSUNG - Galaxy S20+ | 11.0.0 |  | Físico |
| SAMSUNG - s10e | 11.0.0 |  | Físico |
| XIAOMI - Mi 8 Lite | 9.0.0 |  | Físico |
| XIAOMI - Mi 8 Lite | 10.0.0 |  | Físico |
| XIAOMI - Poco X3 | 10.0.0 |  | Físico |
| XIAOMI - Redmi Note 8 | 10.0.0 |  | Físico |
| XIAOMI - Redmi Note 8 Pro | 10.0.0 |  | Físico |
| XIAOMI - Redmi Note 9 | 10.0.0 |  | Físico |
| XIAOMI - Redmi Note 9 Pro | 10.0.0 |  | Físico |
| GOOGLE - Pixel sailfish | 8.0.0 |  | Virtual (TestLab) |
| HUAWEY - ALE L23 | 5.0.0 |  | Virtual (TestLab) |
| HUAWEY - ANE LX1 | 9.0.0 |  | Virtual (TestLab) |
| HUAWEY - ANE LX2 | 9.0.0 |  | Virtual (TestLab) |
| HUAWEY - COR L29 | 8.1.0 |  | Virtual (TestLab) |
| HUAWEY - MHA L29 | 7.0.0 |  | Virtual (TestLab) |
| HUAWEY - NEO L29 | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SC 02J | 8.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G891A | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G930AZ | 8.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G935A | 8.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G965N | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G965U1 | 8.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM G981U1 | 10.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM J727V | 8.1.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N950F | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N950N | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N950U | 8.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N960F | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N960N | 9.0.0 |  | Virtual (TestLab) |
| SAMSUNG - SM N960U1 | 8.1.0 |  | Virtual (TestLab) |
## Instalando o SDK Android
Para implementar o SDK Android da plataforma Unico IDCloud ao seu aplicativo Android, siga o passo a passo listado abaixo:
{% stepper %}
{% step %}
### Configurando o Repositório Maven
O SDK Android é disponibilizado através de um Repositório Maven, adicione ao bloco repositories do arquivo **`build.gradle`** existente na raiz do seu projeto:
{% code title="/build.gradle" overflow="wrap" %}
```groovy
// Top-level build file where you can add configuration options common to all sub-projects/modules.
allprojects
{
repositories {
google()
maven {
url "https://maven-sdk.unico.run/sdk-mobile"
}
}
}
```
{% endcode %}
Habilite o suporte ao AndroidX ao em seu arquivo **`gradle.properties`** na raiz de seu projeto (isto garante uma melhor performance e funcionamento do frame de captura):
# Project-wide Gradle settings.
# https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true
{% endstep %}
{% step %}
### Permissões para utilização da Câmera e Internet
Para utilizar o método de abertura de câmera e internet em seu projeto é necessário adicionar as permissões em seu arquivo **`AndroidManifest.xml`**:
{% code title="AndroidManifest.xml" overflow="wrap" %}
```java
```
{% endcode %}
{% endstep %}
{% step %}
### Inclusão da dependência
Após configurar o SDK Android, basta importá-lo em seu projeto. Para isto, adicione **`acessobio-android`** ao bloco **`dependencies`** do arquivo **`app/build.gradle`**.
* A dependência deve ser incluída em um arquivo diferente do que foi utilizado no passo anterior. Neste passo, é necessário utilizar o arquivo **`build.gradle`** referente ao módulo e não ao projeto:
{% code title="app/build.gradle" overflow="wrap" %}
```java
/* unico */
implementation 'io.unico:capture:$version'
```
{% endcode %}
{% hint style="warning" %}
Ao compilar o projeto, você pode se deparar com o seguinte erro:
* `Invoke-customs are only supported starting with android 0 --min-api 26`
Por incompatibilidade da versão do frame min-26. Adicione as linhas a seguir ao bloco **compileOptions**, no mesmo arquivo **`app/build.gradle`**:
{% endhint %}
```java
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
```
{% endstep %}
{% step %}
### Obtendo as credenciais
* Entre em contato com o CSs e/ou time de Onboarding.
* Solicite a SDK Key informando os identificadores de suas aplicações: **PackageID** e **SHA-246** para Android.
* Os identificadores de suas aplicações serão vinculados a SDK Key pela equipe da Unico.
* Você recebe a sua SDK Key para implementar o **AcessoBioConfigDataSource.**
{% endstep %}
{% step %}
### Embarcando as credenciais em seu projeto
Implemente o protocolo **`AcessoBioConfigDataSource`** em sua classe:
{% tabs %}
{% tab title="Java" %}
{% code overflow="wrap" %}
```java
package
import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;
public class UnicoConfig implements AcessoBioConfigDataSource {
@Override
public String getBundleIdentifier() {
return BUNDLE_IDENTIFIER;
}
@Override
public String getHostKey() {
return SDK_KEY;
}
}
```
{% endcode %}
{% endtab %}
{% tab title="Kotlin" %}
```kotlin
import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource
class UnicoConfig : AcessoBioConfigDataSource {
override fun getBundleIdentifier(): String {
return BUNDLE_IDENTIFIER
}
override fun getHostKey(): String {
return SDK_KEY
}
}
```
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}
Método depreciado - Java
```java
package
import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;
public class UnicoConfig implements AcessoBioConfigDataSource {
@Override
public String getProjectNumber() {
return PROJECT_NUMBER;
}
@Override
public String getProjectId() {
return PROJECT_ID;
}
@Override
public String getMobileSdkAppId() {
return MOBILE_SDK_APP_ID;
}
@Override
public String getBundleIdentifier() {
return BUNDLE_IDENTIFIER;
}
@Override
public String getHostInfo() {
return HOST_INFO;
}
@Override
public String getHostKey() {
return HOST_KEY;
}
}
```
Método depreciado - Kotlin
```kotlin
package
import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource
class UnicoConfig : AcessoBioConfigDataSource {
override fun getProjectNumber(): String {
return PROJECT_NUMBER
}
override fun getProjectId(): String {
return PROJECT_ID
}
override fun getMobileSdkAppId(): String {
return MOBILE_SDK_APP_ID
}
override fun getBundleIdentifier(): String {
return BUNDLE_IDENTIFIER
}
override fun getHostInfo(): String {
return HOST_INFO
}
override fun getHostKey(): String {
return HOST_KEY
}
}
```
**Pronto**. Finalizada a instalação do SDK, siga para a implementação lendo o material a seguir:
{% embed url="" %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://devcenter.unico.io/unico-idcloud/by-client-integration/pt/sdk/sdks-disponiveis/sdk-android/guia-de-instalacao.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.