> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-mobile/android-sdk/instalacion.md).

# Instalação

## O que inclui o SDK

O SDK Mobile é composto por um conjunto de **bibliotecas modulares (componentes)** que permitem construir uma solução biométrica adaptada a cada caso de uso.

## Requisitos mínimos

Antes de começar, certifique-se de que seu projeto atende a estes requisitos:

* **Android minSdk:** 24
* **Android API:** 35
* **Kotlin:** 2.2.21
* **Android Gradle Plugin:** 8.13.1

***

## 1. Configurar o repositório privado

Por motivos de segurança e manutenção, os componentes do SDK Mobile são distribuídos por meio de um **repositório privado**.

Para acessá-lo, você precisa de credenciais, que deve solicitar à **equipe de suporte de Facephi**.

Depois de obtê-las, adicione o repositório no arquivo `settings.gradle`:

```kts
mavenCentral()
maven {
    Properties props = new Properties()
    def propsFile = new File('local.properties')
    if(propsFile.exists()){
        props.load(new FileInputStream(propsFile))
    }
    name="external"
    url = uri("https://facephicorp.jfrog.io/artifactory/maven-pro-fphi")
    credentials {
        username = props["artifactory.user"] ?: System.getenv("USERNAME_ARTIFACTORY")
        password = props["artifactory.token"] ?: System.getenv("TOKEN_ARTIFACTORY")
    }
}
```

## **2. Adicionar as credenciais**

Inclua as credenciais no arquivo `local.properties`

```kts
artifactory.user=YOUR_CREDENTIALS_USERNAME
artifactory.token=YOUR_CREDENTIALS_TOKEN
```

## 3. Declarar a dependência base

A dependência **obrigatória** para usar o SDK é a seguinte:

```kts
implementation "com.facephi.androidsdk:sdk:$version"
```

A partir daqui, adicione as dependências dos **componentes** que você for utilizar conforme o seu caso de uso.

***

## Suporte

Se tiver dúvidas ou problemas durante a instalação, entre em contato com o **Suporte Técnico de Facephi**.
