راه‌اندازی سریع Android SDK

این سند راهنمای راه‌اندازی سریع برای انجام عملیات‌های معمول با استفاده از Android SDK ارائه می‌دهد. شما یاد می‌گیرید که چگونه SDK را نصب کنید، اعتبارهای دسترسی را پیکربندی کنید، و عملیات‌های پایه‌ای مانند دریافت آخرین اطلاعات به‌روزرسانی را انجام دهید.

نکات

• برای ارسال درخواست‌ها با استفاده از Android SDK، نیاز به راه‌اندازی یک نمونه Client دارید. این سند Client را با بارگذاری پیکربندی‌های پیش‌فرض ایجاد می‌کند. برای گزینه‌های پیکربندی بیشتر برای کلاینت، به Configuring the Client مراجعه کنید.

پیش‌نیازها

• قبلاً حساب UpgradeLink را ثبت کرده‌اید.
• AccessKey و AccessSecret را به‌دست آورده‌اید.
• استراتژی به‌روزرسانی برنامه URL را پیکربندی کرده‌اید.

دریافت اعتبارها

نصب SDK

• اضافه کردن وابستگی‌ها در پروژه Gradle (روش توصیه شده)

آدرس مخزن maven را اضافه کنید:

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

برای استفاده از SDK در پروژه Gradle، کافیست وابستگی مربوطه را به build.gradle اضافه کنید. به عنوان مثال، اضافه کردن وابستگی برای نسخه 2.3.0 در dependencies:

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) {
            // Print exception stack trace
            e.printStackTrace();
            // Let the test fail and give an error message
            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));
    }

}