Uygulamanızdaki parametreleri tanımlamak ve buluttaki değerlerini güncellemek için Firebase Remote Config'i kullanabilirsiniz, böylece bir 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, Remote Config arka ucundan güncellenmiş parametre değerlerini almak ve getirilen değerlerin uygulamanız tarafından ne zaman kullanılabilir hale getirileceğini kontrol etmek için kullanılır. Daha fazla bilgi edinmek için bkz. Remote Config yükleme stratejileri .
1. Adım: Firebase'i uygulamanıza ekleyin
Remote Config'i kullanmadan önce yapmanız gerekenler:
C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.
C++ projeniz zaten Firebase kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmıştır.
Firebase C++ SDK'yı 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 indirir, ardından bunları C++ projenize taşırsınız).
2. Adım: Uygulamanıza Remote Config ekleyin
Android
Firebase'i uygulamanıza ekledikten sonra:
JNI ortamında ve Activity:
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
geçen bir Firebase Uygulaması oluşturunRemote Config kitaplığını gösterildiği gibi başlatın:
::firebase::remote_config::Initialize(app);
iOS+
Firebase'i uygulamanıza ekledikten sonra:
Bir Firebase Uygulaması Oluşturun:
app = ::firebase::App::Create(::firebase::AppOptions());
Remote Config kitaplığını gösterildiği gibi başlatın:
::firebase::remote_config::Initialize(app);
3. Adım: Uygulama içi varsayılan parametre değerlerini ayarlayın
Remote Config nesnesinde uygulama içi varsayılan parametre değerlerini ayarlayabilirsiniz, böylece uygulamanız Remote Config arka ucuna bağlanmadan önce istendiği gibi davranır ve böylece arka uçta hiçbiri ayarlanmazsa varsayılan değerler kullanılabilir.
Bir
std::map<const char*, const char*>nesnesi veya birstd::map<const char*, firebase::Variant>nesnesi kullanarak bir dizi parametre adı ve varsayılan parametre değerleri tanımlayın.-
firebase::Varianthakkında bilgi edinin.
Remote Config arka uç parametre değerlerini zaten yapılandırdıysanız, bu anahtar/değer çiftlerini içeren bir dosyayı indirebilir ve
mapnesnenizi oluşturmak için kullanabilirsiniz. Daha fazla bilgi için bkz. Remote Config şablonu varsayılanlarını indirme .-
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 değerler ayarlayıp getirdiyseniz ve ardından etkinleştirdiyseniz, bu değerler uygulamanız tarafından 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, parametre anahtarını bağımsız değişken olarak sağlayarak, uygulamanızın beklediği veri türüyle eşleşen aşağıda listelenen yöntemi çağırın:
5. Adım: Uygulamanızı Firebase konsoluna bağlayın
Firebase konsolunda , uygulamanızı Firebase projenize ekleyin.
Adım 6: Parametre değerlerini ayarlayın
- Firebase konsolunda projenizi açın.
- Remote Config panosunu görüntülemek için menüden Remote Config'i seçin.
- Uygulamanızda tanımladığınız parametrelerle aynı ada sahip parametreleri tanımlayın. Her parametre için bir varsayılan değer (eninde sonunda uygulama içi varsayılan değeri geçersiz kılacaktır) ve koşullu değerler ayarlayabilirsiniz. Daha fazla bilgi edinmek için bkz. Remote Config parametreleri ve koşulları .
7. 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 alınır ve Remote Config nesnesinde önbelleğe alınır. - Getirilen parametre değerlerini uygulamanızın kullanımına sunmak için
ActivateFetched()işlevini çağırın.
8. Adım: Güncellemeleri gerçek zamanlı olarak dinleyin
Parametre değerlerini getirdikten sonra, Remote Config arka ucundan güncellemeleri dinlemek için gerçek zamanlı Remote Config'i kullanabilirsiniz. Gerçek Zamanlı Remote Config, güncellemeler mevcut olduğunda bağlı cihazlara sinyal verir ve siz yeni bir Remote Config sürümü yayınladıktan sonra değişiklikleri otomatik olarak getirir.
Gerçek zamanlı güncellemeler, Android ve Apple platformları için Firebase C++ SDK v11.0.0+ ve üstü tarafından desteklenir.
- Uygulamanızda, güncellemeleri dinlemeye başlamak ve yeni veya güncellenmiş parametre değerlerini otomatik olarak getirmek için
AddOnConfigUpdateListenerarayın. Aşağıdaki örnek, güncellemeleri dinler veActivateçağrıldığında, güncellenmiş bir karşılama mesajını 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'inizin yeni bir sürümünü bir sonraki yayınlayışınızda, uygulamanızı çalıştıran ve değişiklikleri dinleyen cihazlar, yapılandırma güncelleme dinleyicisini çağırır.
Next steps
If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: