> 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-en/sdks/sdk-mobile/android-sdk/instalacion.md).

# Installation

Integrate the Facephi Mobile SDK into your Android application to run biometric verification processes quickly and securely.

## What's included in the SDK

The SDK Mobile consists of a set of **modular libraries (components)** that let you build a biometric solution tailored to each use case.

## Minimum requirements

Before you begin, make sure your project meets these requirements:

* **Android minSdk:** 24
* **Android compileSdk:** 35 or higher
* **Kotlin:** 2.2.21
* **Android Gradle Plugin:** 8.13.1
* **Gradle:** 8.13
* **Java (source/target compatibility):** 1.8

***

## 1. Configure the private repository

For security and maintenance reasons, the SDK Mobile components are distributed through a **private repository**.

To access it, you need credentials, which you must request from the **Facephi support team**.

Once you have them, add the repository to the `settings.gradle`:

```kts
dependencyResolutionManagement {
    repositories {
        google()
        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. Add the credentials**

Add the credentials to the `local.properties`

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

## 3. Declare the base dependency

The **required** dependency for using the SDK is:

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

From here, add the dependencies for the **components** you plan to use for your use case.

***

## Support

If you have any questions or issues during installation, contact **Facephi Technical Support**.
