Inicio Rápido del SDK de Android

Este documento proporciona un guía de inicio rápido para realizar operaciones comunes usando el SDK de Android. Aprenderás cómo instalar el SDK, configurar las credenciales de acceso y realizar operaciones básicas como recuperar la información de actualización más reciente.

Notas

• Para hacer solicitudes usando el SDK de Android, necesitas inicializar una instancia de Client. Este documento crea un Client cargando configuraciones predeterminadas. Para más opciones de configuración para el cliente, por favor consulta Configuración del Cliente.

Requisitos Previos

• Ya has registrado una cuenta de UpgradeLink.
• Has obtenido AccessKey y AccessSecret.
• Has configurado una estrategia de actualización de aplicación URL.

Obtener Credenciales

Instalar el SDK

• Agregar dependencias en un proyecto Gradle (método recomendado)

Agregar la dirección del repositorio maven:

pluginManagement {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Para usar el SDK en un proyecto Gradle, simplemente agrega la dependencia correspondiente a build.gradle. Tomando como ejemplo agregar la dependencia de versión 2.3.0 en dependencies:

implementation 'com.github.toolsetlink:upgradelink-api-android:2.3.0'

Uso Rápido

El siguiente programa de ejemplo demuestra cómo inicializar un Client y recuperar la información de actualización más reciente para una aplicación URL.

Obtener Información de Actualización Más Reciente de Aplicación URL - Llamada Sincrónica

package com.toolsetlink.upgradelink.api;

import com.toolsetlink.upgradelink.api.models.*;
import org.junit.*;
import java.io.IOException;
import java.util.concurrent.*;

public class SimpleClientTest {

    private Client client;

    @Before
    public void setUp() {
        Config config = new Config();
        config.accessKey = "mui2W50H1j-OC4xD6PgQag";
        config.secretKey = "PEbdHFGC0uO_Pch7XWBQTMsFRxKPQAM2565eP8LJ3gc";
        client = new Client(config);
    }

    @Test
    public void getUrlUpgrade_shouldCallCallbackOnSuccess() throws Exception {
        UrlUpgradeRequest request = new UrlUpgradeRequest(
                "uJ47NPeT7qjLa1gL3sVHqw",
                1,
                0,
                "",
                ""
        );

        try {
            UrlUpgradeResponse response = client.getUrlUpgrade(request);
            System.out.println("Respuesta de la solicitud getUrlUpgrade: " + response.toString());
        } catch (Exception e) {
            // Imprimir traza de la excepción
            e.printStackTrace();
            // Hacer que la prueba falle y dar un mensaje de error
            Assert.fail("Solicitud getUrlUpgrade fallida: " + e.getClass().getSimpleName() + ": " + e.getMessage());
        }
    }

}

Obtener Información de Actualización Más Reciente de Aplicación URL - Llamada Asincrónica

package com.toolsetlink.upgradelink.api;

import com.toolsetlink.upgradelink.api.models.*;
import org.junit.*;
import java.io.IOException;
import java.util.concurrent.*;

public class SimpleClientTest {

    private Client client;

    @Before
    public void setUp() {
        Config config = new Config();
        config.accessKey = "mui2W50H1j-OC4xD6PgQag";
        config.secretKey = "PEbdHFGC0uO_Pch7XWBQTMsFRxKPQAM2565eP8LJ3gc";
        client = new Client(config);
    }

    @Test
    public void getUrlUpgradeAsync_shouldCallCallbackOnSuccess() throws Exception {
        UrlUpgradeRequest request = new UrlUpgradeRequest(
                "uJ47NPeT7qjLa1gL3sVHqw",
                1,
                0,
                "",
                ""
        );
        CountDownLatch latch = new CountDownLatch(1);

        Client.Callback<UrlUpgradeResponse> callback = new Client.Callback<>() {
            @Override
            public void onSuccess(UrlUpgradeResponse response) {
                System.out.println("Respuesta de la solicitud getUrlUpgrade: " + response.toString());
                latch.countDown();
            }

            @Override
            public void onFailure(Throwable t) {
                t.printStackTrace();
                Assert.fail("Solicitud getUrlUpgrade fallida: " + t.getClass().getSimpleName() + ": " + t.getMessage());
                latch.countDown();
            }
        };

        client.getUrlUpgradeAsync(request, callback);
        Assert.assertTrue("La prueba se agotó", latch.await(15, TimeUnit.SECONDS));
    }

}