# Agrega el SDK a tu proyecto

Esta guía configura el SDK White Label en un proyecto Android: el permiso, el JDK de Gradle, los servicios requeridos en el terminal y la dependencia del SDK.

## Antes de comenzar

Confirma que cumples los [Requisitos previos](https://docs.globalgetnet.com/es/products/in-store-payments/getnet-toolbox?doc=sdk-wl-prerequisites). Esta entrega incluye el material de homologación (HML). El tipo de build `debug` lo usa.

## Paso 1: Agrega el permiso de Android

Agrega el permiso de internet a tu `AndroidManifest.xml`:

```xml
<uses-permission android:name="android.permission.INTERNET" />
```

El SDK lo usa para comunicarse con los servicios de pago.

## Paso 2: Configura el JDK de Gradle en 21

El proyecto compila solo con JDK 21. En Android Studio:

1. Abre **Settings → Build, Execution, Deployment → Build Tools → Gradle**.
2. En **Gradle JDK**, selecciona un JDK 21 — por ejemplo, el JetBrains Runtime 21 incluido (`jbr-21`).
3. Haz clic en **Apply** y ejecuta el **Sync** de Gradle otra vez.

La sincronización se completa sin el error `Unsupported class file major version`.

## Paso 3: Instala los servicios requeridos en el terminal

El SDK depende de dos servicios instalados en el terminal, entregados como APKs en la carpeta `apks/` del toolkit. Primero, verifica si ya están instalados: en el terminal, abre **Settings → Apps** y busca ambos, o usa `adb`:

```powershell
adb shell pm list packages | Select-String "com.pagonxt.hal.platform|com.getnet.posdigital.service"
```

Si ambos están presentes, pasa al Paso 4. Si no, habilita la depuración USB en el terminal, conéctalo e instala la **Platform** de tu fabricante más el **Middleware** común:

```powershell
## Platform — choose the APK for your terminal's manufacturer
adb install "apks\gertec\gertec-platform-1.1.4-release.apk"
adb install "apks\positivo\positivo-platform-1.0.59-release.apk"

## Middleware — common to all terminals
adb install "apks\common\middleware-4.0.0-release.apk"
```

## Paso 4: Agrega el repositorio Maven

El SDK se distribuye como un repositorio Maven local. Apunta `maven { url }` a la carpeta `hml`, que resuelve el tipo de build `debug`. Usa una ruta absoluta.

`settings.gradle.kts` (Kotlin DSL):

```kotlin
dependencyResolutionManagement {
    repositories {
        // ...
        maven { url = uri(".../apolo-sdk/hml") } // used by the debug build type
    }
}
```

## Paso 5: Declara la dependencia

Declara el material HML con `debugImplementation`:

```kotlin
dependencies {
    // ...
    debugImplementation("com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT") // debug → HML
}
```

La coordenada `com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT` se resuelve desde el repositorio Maven local.

## Siguientes pasos

* [Inicio rápido](https://docs.globalgetnet.com/es/products/in-store-payments/getnet-toolbox?doc=sdk-wl-quick-start) — inicializa el SDK y ejecuta tu primera venta.