# Adicione o SDK ao seu projeto

Este guia configura o SDK White Label em um projeto Android: a permissão, o Gradle JDK, os serviços obrigatórios do terminal e a dependência do SDK.

## Antes de começar

Confirme que você atende aos [Pré-requisitos](https://docs.globalgetnet.com/pt/products/in-store-payments/getnet-toolbox?doc=sdk-wl-prerequisites). Esta entrega fornece o material de homologação (HML), usado pelo build type `debug`.

## Passo 1: Adicione a permissão do Android

Adicione a permissão de internet ao seu `AndroidManifest.xml`:

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

O SDK usa essa permissão para se comunicar com os serviços de pagamento.

## Passo 2: Defina o Gradle JDK como 21

O projeto compila somente com o JDK 21. No Android Studio:

1. Abra **Settings → Build, Execution, Deployment → Build Tools → Gradle**.
2. Em **Gradle JDK**, selecione um JDK 21 — por exemplo, o JetBrains Runtime 21 que vem embutido (`jbr-21`).
3. Clique em **Apply** e execute o **Sync** do Gradle novamente.

O sync é concluído sem o erro `Unsupported class file major version`.

## Passo 3: Instale os serviços obrigatórios do terminal

O SDK depende de dois serviços instalados no terminal, entregues como APKs na pasta `apks/` do toolkit. Primeiro, verifique se eles já estão instalados: no terminal, abra **Settings → Apps** e procure pelos dois, ou use o `adb`:

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

Se os dois estiverem presentes, vá para o Passo 4. Caso contrário, ative a depuração USB no terminal e conecte-o. Depois, instale a **Platform** do seu fabricante e o **Middleware** comum:

```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"
```

## Passo 4: Adicione o repositório Maven

O SDK é distribuído como um repositório Maven local. Aponte `maven { url }` para a pasta `hml`, que o build type `debug` resolve. Use um caminho absoluto.

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

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

## Passo 5: Declare a dependência

Declare o material HML com `debugImplementation`:

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

A coordenada `com.pagonxt.sdk:brazil-hml:1.0.0-SNAPSHOT` é resolvida a partir do repositório Maven local.

## Próximos passos

* [Início rápido](https://docs.globalgetnet.com/pt/products/in-store-payments/getnet-toolbox?doc=sdk-wl-quick-start) — inicialize o SDK e execute sua primeira venda.