# Instalação e Configuração

Este guia fornece instruções detalhadas sobre como integrar a `redsys-tpv-business-lib` em seu projeto Android. A biblioteca é entregue como um repositório Maven local, visando simplificar a integração offline e segura.

## Pré-requisitos

Antes de integrar a biblioteca, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes requisitos:

* **Versão do Java**: A biblioteca requer o **Java 21**.
* **Serviço de Pagamento**: O **Get Smart SDK Payment Service** (APK Android) deve estar instalado e em execução no terminal físico.
* **TPV Físico**: É necessário um TPV físico Android para validar as transações.

## Passo 1: Configurar o Java 21

Você deve configurar seu projeto Android para usar a compatibilidade com o Java 21. Abra o arquivo `build.gradle` do seu módulo de aplicação (geralmente `app/build.gradle`) e atualize o bloco `compileOptions`:

```java
android {
    // ... existing configuration

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_21
        targetCompatibility = JavaVersion.VERSION_21
    }
}
```

## Passo 2: Importar o Repositório

A Getnet entrega o SDK como um **arquivo ZIP** contendo uma estrutura de repositório Maven local. Isso inclui:

* **Arquivos AAR** para as bibliotecas.  
* **Javadoc** para documentação.  
* **Arquivos POM** para resolução automática de dependências.

### 1. Extrair os Arquivos

Descompacte o arquivo de entrega fornecido em um diretório dedicado em sua máquina de desenvolvimento.

* **Exemplo de Caminho**: `C:\\Users\\MeuUsuario\\RepositorioRedsys`

### 2. Registrar o Repositório

Você deve informar ao Gradle onde procurar pela biblioteca. Abra o arquivo `settings.gradle` do seu projeto e adicione o caminho do repositório local ao bloco `dependencyResolutionManagement`.

**Exemplo de Caminho Absoluto:**

```java
dependencyResolutionManagement {
    repositories {
        maven {
            url = uri("C:\\Users\\MyUser\\RedsysRepository")
        }
        google()
        mavenCentral()
    }
}
```

<Callout type="tip">

Para tornar seu projeto portátil entre diferentes máquinas (ex: para CI/CD ou colaboração em equipe), coloque a pasta do repositório dentro da raiz do seu projeto (ex: em uma pasta libs) e use um caminho relativo:

</Callout>

```java
url = uri("${rootDir}/libs/RedsysRepository")
```

## Passo 3: Adicionar a Dependência

Uma vez que o repositório esteja registrado, você pode adicionar a dependência específica da biblioteca ao seu módulo de aplicação.

Abra o seu arquivo `app/build.gradle` e adicione a seguinte linha ao bloco de dependências:

```java
dependencies {
    implementation("es.redsys.adquirencia.tpva.service:redsys-tpv-business-lib:1.3.2")
}
```

**Nota**: Certifique-se de que o número da versão (`1.3.2`) corresponda à versão específica fornecida em seu pacote de entrega.

### Resolução de Dependências

O **Get Smart SDK** é modular. Como o repositório fornecido inclui arquivos POM, o Gradle irá resolver e baixar automaticamente quaisquer dependências internas da Getnet exigidas pela `redsys-tpv-business-lib`. Você não precisa adicionar manualmente outros AARs do pacote.

## Próximos Passos

Com a biblioteca instalada e configurada, você pode agora prosseguir para:

1. **Injeção de Dependência**: Configurar a biblioteca usando o [Setup de Injeção de Dependência](/pt/get-smart/get-smart-sdk/first-steps/dependency-injection-setup).  
2. **Inicialização**: [Inicializar o TPV](/pt/get-smart/get-smart-sdk/integration-guides/payment-operations/initialize-the-tpv) para começar a comunicação com o Serviço de Pagamento.