Android SDK 빠른 시작

이 문서는 Android SDK를 사용하여 일반적인 작업을 수행하는 빠른 시작 가이드를 제공합니다. SDK를 설치하는 방법, 액세스 자격 증명을 구성하는 방법, 최신 업그레이드 정보를 검색하는 등의 기본 작업을 학습하게 됩니다.

참고 사항

• Android SDK를 사용하여 요청을 보내려면 Client 인스턴스를 초기화해야 합니다. 이 문서에서는 기본 구성을 로드하여 Client를 생성합니다. 클라이언트에 대한 자세한 구성 옵션은 클라이언트 구성을 참조하세요.

전제 조건

• 이미 UpgradeLink 계정을 등록했습니다.
• AccessKey 및 AccessSecret을 얻었습니다.
• URL 애플리케이션 업그레이드 전략을 구성했습니다.

자격 증명 가져오기

SDK 설치

• Gradle 프로젝트에 종속성 추가 (권장 방법)

Maven 리포지토리 주소 추가:

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

Gradle 프로젝트에서 SDK를 사용하려면 build.gradle에 해당 종속성을 추가하기만 하면 됩니다. dependencies에서 버전 2.3.0의 종속성을 추가하는 예제:

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

빠른 사용

다음 예제 프로그램은 Client를 초기화하고 URL 애플리케이션의 최신 업그레이드 정보를 검색하는 방법을 보여줍니다.

URL 애플리케이션 최신 업그레이드 정보 가져오기 - 동기 호출

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("getUrlUpgrade request response: " + response.toString());
        } catch (Exception e) {
            // 예외 스택 트레이스 출력
            e.printStackTrace();
            // 테스트를 실패시키고 오류 메시지 제공
            Assert.fail("getUrlUpgrade request failed: " + e.getClass().getSimpleName() + ": " + e.getMessage());
        }
    }

}

URL 애플리케이션 최신 업그레이드 정보 가져오기 - 비동기 호출

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("getUrlUpgrade request response: " + response.toString());
                latch.countDown();
            }

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

        client.getUrlUpgradeAsync(request, callback);
        Assert.assertTrue("Test timed out", latch.await(15, TimeUnit.SECONDS));
    }

}