Konfigurasi sakelar memungkinkan modifikasi dinamis terhadap logika pemrosesan dalam kode klien tanpa merilis versi baru. Klien mengontrol pemrosesan berdasarkan nilai sakelar yang dikonfigurasi oleh backend. Layanan konfigurasi sakelar memungkinkan Anda mengonfigurasi, memodifikasi, dan mendorong berbagai sakelar, yang merupakan pasangan key/value.
mPaaS menyediakan layanan manajemen konfigurasi (ConfigService) untuk mengimplementasikan konfigurasi sakelar. Logika tarikan default adalah sekali selama cold start atau ketika aplikasi kembali ke foreground setelah lebih dari 30 menit sejak tarikan terakhir. Layanan ini juga menyediakan antarmuka tarikan segera dan logika pemantauan untuk perubahan item konfigurasi, sehingga konfigurasi dapat diperbarui secara real-time.
Untuk mengelola konfigurasi sakelar, Anda perlu menambahkan iOS SDK yang sesuai, mengonfigurasi proyek, dan membaca konfigurasi.
Menggunakan konfigurasi sakelar melibatkan pemanggilan antarmuka rilis pembaruan MDS, yang akan memicu biaya panggilan antarmuka. Untuk detail penagihan, lihat deskripsi item penagihan MDS dalam mode Pascabayar.
Prasyarat
Proyek harus terhubung ke mPaaS. Untuk informasi lebih lanjut, lihat: Akses berbasis kerangka asli dan menggunakan Cocoapods.
Tentang tugas ini
Dokumen ini menjelaskan cara mengintegrasikan konfigurasi sakelar berdasarkan contoh kode konfigurasi sakelar.
Tambahkan SDK
Gunakan plugin cocoapods-mPaaS untuk menambahkan SDK.
Langkah-langkahnya adalah sebagai berikut:
Dalam Podfile, gunakan
mPaaS_pod "mPaaS_Config"untuk menambahkan dependensi komponen konfigurasi sakelar.
Lihat Panduan Pengguna Cocoapods, jalankan
pod installataupod update.
Konfigurasikan proyek
Langkah ini hanya berlaku untuk baseline 10.1.32. Fitur konfigurasi proyek sudah terintegrasi dalam baseline 10.1.60 dan 10.1.68. Anda dapat mengabaikan langkah ini jika menggunakan baseline tersebut.
mPaaS mengenkapsulasi kemampuan konfigurasi sakelar menjadi sebuah layanan. Daftarkan layanan ini di pengelola layanan sebelum digunakan, seperti yang ditunjukkan pada gambar berikut.
Baca konfigurasi
Nilai kunci sakelar dapat dirilis secara dinamis di konsol mPaaS. Di panel navigasi kiri, pilih Layanan Pengiriman Seluler > Manajemen Konfigurasi. Klik Kunci Konfigurasi untuk melihat detail konfigurasi.
Apa yang harus dilakukan selanjutnya
Peroleh nilai sakelar
Di Konsol mPaaS, tambahkan item konfigurasi sakelar yang diperlukan di Layanan Pengiriman Seluler > Manajemen Konfigurasi, dan atur distribusi bertarget berdasarkan platform, daftar putih, persentase, versi, model perangkat, versi iOS, dan informasi lainnya. Untuk detail operasi, lihat Kelola konfigurasi untuk Android/iOS.
Setelah kunci sakelar dirilis melalui konsol, klien dapat memperoleh nilai kunci yang sesuai dengan memanggil antarmuka yang relevan.
+ (void)testStringForKey
{
id<APConfigService>configService = [DTContextGet() findServiceByName:@"APConfigService"];
NSString *configValue = [configService stringValueForKey:@"BillEntrance"];
assert (configValue && [configValue isKindOfClass:[NSString class]]);
}Nilai kunci sakelar diperoleh melalui API RPC. Panggilan API RPC tidak selalu berhasil. Oleh karena itu, pertimbangkan logika pemrosesan lokal di klien untuk menangani kegagalan. Saran kami adalah mengatur nilai sakelar default di logika lokal. Ini memungkinkan klien menggunakan logika konfigurasi baru ketika konsol mengirimkan nilai sakelar baru dan menggunakan logika default lokal saat gagal memperoleh nilai kunci.
Operasi Lanjutan
Waktu klien menarik konfigurasi sakelar:
Selama cold start aplikasi
30 menit lebih lambat dari tarikan terakhir setelah aplikasi kembali ke foreground
CatatanInterval 30 menit adalah nilai default. Anda dapat memodifikasi interval dengan menambahkan sakelar
Load_Config_Intervaldi halaman Manajemen Sakelar Konfigurasi di bawah Layanan Pengiriman Seluler di konsol mPaaS. Untuk detail langkah-langkahnya, lihat Kelola konfigurasi untuk Android/iOS.
Pantau perubahan nilai sakelar secara dinamis
Tambahkan observer untuk kunci tertentu untuk memantau perubahan nilai sakelar secara dinamis.
Ketika klien menarik konfigurasi sakelar, peroleh nilai sakelar terbaru dari kunci tertentu di metode callback.
Tarik paksa nilai sakelar: SDK menyediakan metode untuk menarik paksa konfigurasi terbaru dari konsol.
