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:

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:

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

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:

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.
2. Inicialização: Inicializar o TPV para começar a comunicação com o Serviço de Pagamento.