Buka konsol

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 kerjanya

Pertama, contoh mendapatkan instance objek Remote Config dan mengaktifkan mode developer agar cache dapat direfresh lebih sering:

Swift

Objective-C

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

Swift

Objective-C

Sekarang, contoh ini akan membuat permintaan fetchWithExpirationDuration:completionHandler: untuk mengambil nilai dari layanan Remote Config dan memanggil activateFetched untuk menyediakan nilai tersebut bagi aplikasi:

Swift

Objective-C

Setelah pesan sambutan 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:.

Caching dan throttling

Remote Config memasukkan nilai ke cache lokal setelah permintaan pertama yang berhasil. Secara default, cache akan berakhir setelah 12 jam, tetapi Anda bisa mengubah masa berakhir cache untuk permintaan tertentu dengan meneruskan masa berakhir cache yang diinginkan dalam satuan detik ke fetchWithExpirationDuration:completionHandler:. Jika nilai pada cache lebih tua daripada masa berakhir cache yang diinginkan, Remote Config akan meminta nilai konfigurasi baru dari layanan tersebut. Jika aplikasi Anda meminta nilai baru menggunakan fetchWithExpirationDuration:completionHandler: beberapa kali, permintaan akan dihambat dan aplikasi Anda akan diberi nilai yang telah dimasukkan ke cache.

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 sangat cepat pada sebuah project dengan tim developer yang berisi hingga 10 orang, Anda dapat menambahkan properti FIRRemoteConfigSettings untuk sementara dan menetapkan isDeveloperModeEnabled ke true pada aplikasi Anda sehingga mengubah setelan caching untuk objek FIRRemoteConfig.