Uygulamanızda parametreler tanımlamak ve bulutta değerlerini güncellemek için Firebase Remote Config'ü kullanabilirsiniz. Böylece, uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirebilirsiniz.
Remote Config kitaplığı, uygulama içi varsayılan parametre değerlerini depolamak, güncellenen parametre değerlerini Remote Config arka ucundan almak ve alınan değerlerin uygulamanıza ne zaman sunulacağını kontrol etmek için kullanılır. Daha fazla bilgi edinmek için Remote Config yükleme stratejileri başlıklı makaleyi inceleyin.
1. adım: Firebase'i uygulamanıza ekleyin
Remote Config özelliğini kullanabilmek için:
C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.
C++ projeniz zaten Firebase kullanıyorsa Firebase için kayıtlı ve yapılandırılmış demektir.
Firebase C++ SDK'sını C++ projenize ekleyin.
Firebase'i C++ projenize eklemenin hem Firebase konsolunda hem de açık C++ projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip C++ projenize taşırsınız).
2. adım: Uygulamanıza Remote Config ekleyin
Android
Firebase'i uygulamanıza ekledikten sonra:
JNI ortamını ve Etkinliği ileterek bir Firebase uygulaması oluşturun:
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
Remote Config kitaplığını aşağıdaki gibi başlatın:
::firebase::remote_config::Initialize(app);
iOS+
Firebase'i uygulamanıza ekledikten sonra:
Firebase uygulaması oluşturun:
app = ::firebase::App::Create(::firebase::AppOptions());
Remote Config kitaplığını aşağıdaki gibi başlatın:
::firebase::remote_config::Initialize(app);
3. Adım: Uygulama içi varsayılan parametre değerlerini ayarlayın
Uygulamanızın Remote Config arka ucuna bağlanmadan önce istenen şekilde davranması ve arka uçta ayarlanmamışsa varsayılan değerlerin kullanılabilmesi için Remote Config nesnesinde uygulama içi varsayılan parametre değerleri ayarlayabilirsiniz.
Bir dizi parametre adı ve varsayılan parametre değeri tanımlamak için
ConfigKeyValue*nesnesi veya dizi boyutunu içeren birConfigKeyValueVariant*nesnesi kullanın.Remote Config arka uç parametre değerlerini daha önce yapılandırdıysanız bu anahtar/değer çiftlerini içeren bir dosya indirebilir ve
mapnesnenizi oluşturmak için kullanabilirsiniz. Daha fazla bilgi için Remote Config şablonu varsayılanlarını indirme başlıklı makaleyi inceleyin.SetDefaults()kullanarak bu değerleri Remote Config nesnesine ekleyin.
4. adım: Uygulamanızda kullanılacak parametre değerlerini alın
Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Remote Config arka ucunda ayarladığınız, getirdiğiniz ve etkinleştirdiğiniz değerler uygulamanızda kullanılabilir. Aksi takdirde, SetDefaults() kullanılarak yapılandırılan uygulama içi parametre değerlerini alırsınız.
Bu değerleri almak için, uygulamanızın beklediği veri türüyle eşleşen ve parametre anahtarını bağımsız değişken olarak sağlayan aşağıda listelenen yöntemi çağırın:
5. adım: Parametre değerlerini ayarlayın
- Firebase konsolunda projenizi açın.
- Remote Config kontrol panelini görüntülemek için menüden Remote Config'i seçin.
- Uygulamanızda tanımladığınız parametrelerle aynı ada sahip parametreler tanımlayın. Her parametre için bir varsayılan değer (sonunda uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerler ayarlayabilirsiniz. Daha fazla bilgi için Remote Config parametreleri ve koşulları başlıklı makaleyi inceleyin.
6. adım: Değerleri getirin ve etkinleştirin
- Remote Config arka ucundan parametre değerlerini almak için
Fetch()yöntemini çağırın. Arka uçta ayarladığınız tüm değerler getirilir ve Remote Config nesnesinde önbelleğe alınır. - Getirilen parametre değerlerini uygulamanızın kullanabileceği hale getirmek için
ActivateFetched()işlevini çağırın.
7. adım: Güncellemeleri anlık olarak dinleyin
Parametre değerlerini aldıktan sonra, Remote Config arka ucundan güncelleme dinlemek için gerçek zamanlı Remote Config kullanabilirsiniz. Güncellemeler mevcut olduğunda bağlı cihazlara Remote Config anlık sinyal gönderir ve yeni bir Remote Config sürümü yayınladıktan sonra değişiklikleri otomatik olarak getirir.
Android ve Apple platformları için Firebase C++ SDK v11.0.0 ve sonraki sürümler gerçek zamanlı güncellemeleri destekler.
- Uygulamanızda, güncellemeleri dinlemeye başlamak ve yeni veya güncellenmiş parametre değerlerini otomatik olarak almak için
AddOnConfigUpdateListenerişlevini çağırın. Aşağıdaki örnek, güncellemeleri izler veActivateçağrıldığında güncellenmiş bir karşılama mesajı görüntülemek için yeni getirilen değerleri kullanır.
remote_config->AddOnConfigUpdateListener(
[](firebase::remote_config::ConfigUpdate&& config_update,
firebase::remote_config::RemoteConfigError remote_config_error) {
if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
printf("Error listening for config updates: %d", remote_config_error);
}
// Search the `updated_keys` set for the key "welcome_message."
// `updated_keys` represents the keys that have changed since the last
// fetch.
if (std::find(config_update.updated_keys.begin(),
config_update.updated_keys.end(),
"welcome_message") != config_update.updated_keys.end()) {
remote_config->Activate().OnCompletion(
[&](const firebase::Future& completed_future,
void* user_data) {
// The key "welcome_message" was found within `updated_keys` and
// can be activated.
if (completed_future.error() == 0) {
DisplayWelcomeMessage();
} else {
printf("Error activating config: %d", completed_future.error());
}
},
nullptr);
}
});
Remote Config uygulamanızın yeni bir sürümünü yayınladığınızda, uygulamanızı çalıştıran ve değişiklikleri dinleyen cihazlar yapılandırma güncelleme dinleyicisini çağırır.
Sonraki adımlar
Henüz yapmadıysanız Remote Config kullanım alanlarını inceleyin ve aşağıdakiler gibi temel kavramlar ve gelişmiş strateji dokümanlarından bazılarına göz atın: