Panduan Aplikasi Contoh iOS Firebase Remote Config

Panduan ini menuntun Anda untuk menjalankan langkah-langkah yang diperlukan untuk mengintegrasikan Remote Config ke dalam aplikasi iOS. Untuk mempelajari lebih lanjut tentang Remote Config API untuk iOS, lihat FIRRemoteConfig.

Persyaratan

Siapkan project Anda menggunakan petunjuk yang tersedia di Menambahkan Firebase ke project iOS Anda.

Menginstal library klien

  1. Tambahkan dependensi berikut ke Podfile Anda:

    pod 'Firebase/RemoteConfig'
    

  2. Simpan file dan jalankan perintah berikut ini:

    pod install
    

File .xcworkspace akan dibuat untuk aplikasi Anda. Gunakan file ini untuk semua pengembangan aplikasi Anda di masa mendatang.

Membuat project Remote Config untuk contoh panduan mulai cepat

Contoh panduan mulai cepat menunjukkan contoh penggunaan Remote Config untuk mengatur pesan sambutan pada aplikasi contoh. Sebelum menjalankan contoh panduan mulai cepat, sebaiknya siapkan project Remote Config.

Di Firebase console, klik Buat Project Baru, lalu ikuti petunjuk untuk Menyiapkan Project Firebase Remote Config dengan parameter berikut:

Kunci parameter Nilai default Catatan:
welcome_message Welcome to this sample app Ubahlah untuk menggunakan pesan sambutan yang berbeda.
welcome_message_caps false Setel ke true agar pesan sambutan ditampilkan dalam huruf besar semua.

Setelah mengonfigurasi project, jalankan contoh panduan mulai cepat untuk melihat pesan sambutan yang Anda tentukan di Firebase console. Anda dapat mengubah nilai parameter ini pada project, lalu tap Ambil Remote Config pada contoh panduan mulai cepat untuk melihat cara untuk mengupdate aplikasi dengan Remote Config.

Membuat dan menjalankan contoh panduan mulai cepat

  1. Download kode contoh panduan mulai cepat dan unzip.

  2. Buka jendela terminal dan arahkan ke lokasi project contoh. Jalankan pod install, lalu buka file .xcworkspace.

  3. Buat dan jalankan contoh.

Cara kerja

Pertama, contoh ini akan mendapatkan instance objek Remote Config dan menetapkan interval pengambilan minimum agar dapat direfresh lebih sering:

Swift

Objective-C

Selanjutnya, contoh ini menetapkan nilai default dalam aplikasi dari file plist:

Swift

Objective-C

Sekarang, sampel akan membuat permintaan fetch dari Remote Config service (bukan nilai dalam cache) dan memanggilactivateWithCompletionHandler: agar aplikasi dapat menggunakan nilai tersebut:

Swift

Objective-C

Setelah pesan selamat datang diperbarui, Anda bisa menampilkannya di aplikasi:

Swift

Objective-C

Anda dapat mengakses parameter Remote Config menggunakan salah satu properti stringValue, numberValue, dataValue, atau boolValue, atau menggunakan metode configValueForKey:.

Throttling

Jika aplikasi terlalu sering melakukan pengambilan dalam jangka waktu yang singkat, panggilan pengambilan dapat dibatasi. Dalam kasus seperti itu, backend akan menampilkan FIRRemoteConfigFetchStatusThrottled. Sebaiknya catat error ini dan coba lagi dalam mode backoff eksponensial, menunggu dengan selang waktu interval yang lebih lama antara permintaan pengambilan berikutnya.

Selama pengembangan aplikasi, sebaiknya Anda sering merefresh cache (beberapa kali per jam) agar dapat melakukan iterasi dengan cepat ketika mengembangkan dan menguji aplikasi. Untuk mengakomodasi iterasi yang cepat pada project yang berisi hingga 10 developer, Anda dapat menambahkan properti FIRRemoteConfigSettings untuk sementara dengan interval pengambilan minimum yang rendah (MinimumFetchInterval) di aplikasi Anda.

Interval pengambilan minimum default untuk Remote Config adalah 12 jam. Artinya, konfigurasi tidak akan diambil dari backend lebih dari sekali dalam jangka waktu 12 jam, terlepas dari berapa banyak panggilan pengambilan yang sebenarnya dibuat. Secara khusus, interval pengambilan minimum ditentukan dalam urutan sebagai berikut:

  1. Parameter di fetch(long)
  2. Parameter di FIRRemoteConfigSettings.MinimumFetchInterval
  3. Nilai default 12 jam