Mobile Platform as a Service：Android

Konfigurasi saklar memungkinkan modifikasi logika pemrosesan kode klien secara dinamis tanpa merilis versi baru. Klien mengontrol pemrosesan berdasarkan nilai saklar yang diperoleh dari konfigurasi dinamis latar belakang. Melalui layanan konfigurasi saklar, Anda dapat mengonfigurasi, memodifikasi, dan mendorong berbagai saklar. Saklar adalah pasangan nilai-kunci. Saat ini, integrasi fungsi konfigurasi saklar mendukung mode Native AAR atau mode Portal & Bundle.

Proses integrasi mencakup tiga langkah utama berikut:

1. Tambahkan SDK

2. Inisialisasi mPaaS (hanya untuk Native AAR)

3. Gunakan SDK

Prasyarat

• Jika menggunakan mode Native AAR, pastikan Anda telah menyelesaikan Prasyarat.

• Jika menggunakan mode Portal & Bundle, pastikan Anda telah menyelesaikan Langkah-langkah umum.

Tambahkan SDK

Mode Native AAR

Ikuti petunjuk di Manajemen Komponen AAR untuk menginstal komponen konfigurasi saklar CONFIGSERVICE melalui Manajemen Komponen (AAR).

Mode Portal & Bundle

Instal komponen konfigurasi saklar CONFIGSERVICE di proyek Portal dan Bundle melalui Manajemen Komponen (AAR).

Untuk informasi lebih lanjut, lihat Kelola Dependensi Komponen > Tambah/Hapus Dependensi Komponen.

Inisialisasi mPaaS

Jika mengintegrasikan MAS melalui Native AAR, Anda harus menginisialisasi mPaaS.

Tambahkan kode berikut ke objek Application:

public class MyApplication extends Application {
    
    @Override
    public void onCreate() {
        super.onCreate();
        // Inisialisasi mPaaS
        MP.init(this);    
    }
}

Untuk detail lebih lanjut, lihat Inisialisasi mPaaS.

Gunakan SDK

mPaaS menyediakan API manajemen konfigurasi saklar MPConfigService untuk mengimplementasikan konfigurasi saklar.

Lengkapi langkah-langkah berikut untuk mengimplementasikan konfigurasi saklar:

1. Di konsol mPaaS, buka halaman Mobile Delivery Service > Manage Configuration, tambahkan item konfigurasi saklar yang diperlukan, dan atur distribusi bertarget berdasarkan platform, daftar putih, persentase, nomor versi, model, dan versi Android. Untuk informasi lebih lanjut, lihat Manajemen Konfigurasi.

2. Setelah kunci saklar dirilis di konsol, klien dapat memanggil API tertentu untuk mendapatkan nilai kunci saklar.

   API manajemen konfigurasi saklar MPConfigService menyediakan berbagai API eksternal. Anda dapat memahami fungsi setiap API berdasarkan namanya. Berikut adalah antarmuka dan komentar terkait.

   Penting

   Pendengar akan disimpan sebagai referensi lemah, dan sistem akan mendaur ulangnya saat memori rendah. Hindari penggunaan pendengar global, dan gunakan pendengar saklar dengan mendaftarkannya saat diperlukan dan menghapusnya setelah digunakan.

    public class MPConfigService {
        /**
         * Dapatkan konfigurasi saklar
         *
         * @param key
         * @return
         */
        public static String getConfig(String key);
        /**
         * Muat konfigurasi saklar. Konfigurasi saklar terbaru diperoleh setiap setengah jam secara default.
         */
        public static void loadConfig();
        /**
         * Muat konfigurasi saklar segera.
         *
         * @param delay Penundaan setelah konfigurasi saklar dimuat, dalam ms. 0 menunjukkan bahwa konfigurasi saklar dimuat segera.
         */
        public static void loadConfigImmediately(long delay);
        /**
         * Daftarkan pendengar untuk mendengarkan perubahan konfigurasi saklar.
         * @param configChangeListener pendengar
         * @return
         */
        public static boolean addConfigChangeListener(ConfigService.ConfigChangeListener configChangeListener);
        /**
         * Hapus pendengar untuk mendengarkan perubahan konfigurasi saklar
         * @param configChangeListener pendengar
         */
        public static void removeConfigChangeListener(ConfigService.ConfigChangeListener configChangeListener);
    }