Instalación

Esta guía te ayudará a instalar el SDK de Retorna para Java en tu proyecto.

Opción 1: Instalación Local (Desarrollo)

Paso 1: Clonar e Instalar el SDK

git clone https://github.com/retorna/retorna-java-sdk.git
cd retorna-java-sdk
mvn clean install

Esto compilará, ejecutará los tests e instalará el SDK en tu repositorio local de Maven (~/.m2/repository).

Paso 2: Agregar la Dependencia

En el pom.xml de tu proyecto, agrega:

<dependencies>
    <dependency>
        <groupId>com.retorna</groupId>
        <artifactId>retorna-java-sdk</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </dependency>
</dependencies>

Opción 2: Maven Central (Producción)

Cuando el SDK esté disponible en Maven Central, podrás agregarlo directamente:

<dependencies>
    <dependency>
        <groupId>com.retorna</groupId>
        <artifactId>retorna-java-sdk</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

Opción 3: Repositorio Privado

Si tienes acceso a un repositorio Maven privado, configura pom.xml:

<repositories>
    <repository>
        <id>retorna-repo</id>
        <url>https://repo.retorna.com/maven</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.retorna</groupId>
        <artifactId>retorna-java-sdk</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

Verificar la Instalación

Crea un archivo de prueba para verificar que la instalación fue exitosa:

import com.retorna.sdk.core.RetornaClient;
import com.retorna.sdk.core.RetornaClientOptions;
import com.retorna.sdk.config.Environment;
import com.retorna.sdk.config.LoggingLevel;

public class TestInstallation {
    public static void main(String[] args) {
        try {
            RetornaClient client = RetornaClient.create(
                RetornaClientOptions.builder()
                    .environment(Environment.DEVELOP)
                    .loggingLevel(LoggingLevel.INFO)
                    .clientId("test")
                    .clientSecret("test")
                    .privateKey("-----BEGIN PRIVATE KEY-----\ntest\n-----END PRIVATE KEY-----")
                    .build()
            );
            System.out.println("✅ SDK instalado correctamente!");
        } catch (Exception e) {
            System.err.println("❌ Error: " + e.getMessage());
        }
    }
}

Compila y ejecuta:

mvn clean compile
mvn exec:java -Dexec.mainClass="TestInstallation"

Dependencias del SDK

El SDK incluye las siguientes dependencias (se instalan automáticamente):

• Jackson (2.15.2) - Para serialización/deserialización JSON
• BouncyCastle (1.78.1) - Para criptografía y firmas RSA

Solución de Problemas

Error: "Could not find artifact"

Si Maven no encuentra el artefacto:

1. Verifica que ejecutaste mvn clean install en el directorio del SDK
2. Verifica que la versión en tu pom.xml coincide con la versión instalada
3. Limpia el caché de Maven: mvn dependency:purge-local-repository

Error: "UnsupportedClassVersionError"

Asegúrate de estar usando Java 17 o superior:

java -version

Deberías ver algo como:

openjdk version "17.0.x"

Siguiente Paso

Una vez instalado, continúa con la Configuración del SDK.