Uygulamanızda parametreleri tanımlamak için Firebase Remote Config kullanabilir ve değerlerini bulutta güncelleyerek görünümü ve uygulamanızın davranışını gösteren bir kontrol listesidir.
Remote Config kitaplığı, uygulama içi varsayılan parametre değerlerini depolamak için kullanılır. Remote Config arka ucundan güncellenmiş parametre değerlerini getir ve getirilen değerlerin uygulamanızda ne zaman kullanıma sunulacağını kontrol edebilirsiniz. Daha fazla bilgi edinmek için Remote Config yükleme stratejilerini inceleyin.
1. Adım: Firebase'i uygulamanıza ekleyin
Kullanmadan önce Remote Config, Yapmanız gerekenler:
C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.
C++ projeniz zaten Firebase'i kullanıyorsa zaten kayıtlıdır ve Firebase için yapılandırıldı.
Firebase C++ SDK'sını C++ projenize ekleyin.
Firebase'i C++ projenize eklediğinizde, hem Firebase konsolunda ve açık C++ projenizde (örneğin, Konsoldaki Firebase yapılandırma dosyalarını C++ projenize taşıyın).
2. Adım: Remote Config uygulamasını uygulamanıza 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ğıda gösterildiği gibi başlatın:
::firebase::remote_config::Initialize(app);
iOS ve üzeri
Firebase'i uygulamanıza ekledikten sonra:
Firebase uygulaması oluşturun:
app = ::firebase::App::Create(::firebase::AppOptions());
Remote Config kitaplığını aşağıda 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
Uygulama içi varsayılan parametre değerlerini Remote Config ile bağlantı kurmadan önce amaçlandığı gibi davranmasını sağlamak için Remote Config arka uç sağlar ve böylece hiçbir arka uç olmadığında varsayılan değerler kullanılabilir arka uçta ayarlanır.
Parametre adlarını ve varsayılan parametre değerlerini tanımlamak için
std::map<const char*, const char*>nesne veya astd::map<const char*, firebase::Variant>nesne algılandı.firebase::Varianthakkında bilgi edinin.
Daha önce Remote Config arka uç parametresini yapılandırdıysanız değerlerini içeren bir dosya indirebilir ve bu anahtar/değer çiftlerini
mapnesnenizi oluşturmayı deneyin. Daha fazla bilgi için bkz. İndir Remote Config şablon varsayılanları.Bu değerleri, şunu kullanarak Remote Config nesnesine ekleyin:
SetDefaults()
4. adım: Uygulamanızda kullanılacak parametre değerlerini alın
Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Mevcut
arka ucundaki değerleri Remote Config alıp getirdiyseniz ve bunları etkinleştirdikten sonra,
kullanılabilmesini sağlar. Aksi takdirde, uygulama içi parametreyi
değerleri
SetDefaults()
Bu değerleri almak için aşağıda listelenen ve veri türüyle eşleşen yöntemi çağırın parametre anahtarını bağımsız değişken olarak sağlar:
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 simgesini seçin.
- Şu parametrede tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın: en iyi şekilde yararlanabilirsiniz. Her parametre için bir varsayılan değer ( uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerleri geçersiz kılar. Daha fazla bilgi edinmek için bkz. Remote Config parametre ve koşulu.
6. Adım: Değerleri getirin ve etkinleştirin
- Remote Config arka ucundan parametre değerlerini getirmek için şunu çağırın:
Fetch()yöntemidir. Arka uçta ayarladığınız tüm değerler getirilir ve Remote Config nesnesinde önbelleğe alındı. - Getirilen parametre değerlerini uygulamanızda kullanılabilir hale getirmek için
ActivateFetched()
7. adım: Güncellemeleri gerçek zamanlı olarak dinleyin
Parametre değerlerini getirdikten sonra gerçek zamanlı Remote Config işlevini kullanarak Remote Config arka ucundan gelen güncellemeleri dinleyin. Gerçek zamanlı Güncelleme olduğunda bağlı cihazlara Remote Config sinyal geliyor ve yeni bir Remote Config yayınlamanızın ardından değişiklikleri otomatik olarak getirir sürümünü değil.
Gerçek zamanlı güncellemeler Firebase C++ SDK'sı tarafından desteklenir Android ve Apple platformları için v11.0.0+ ve sonraki sürümler.
- Güncellemeleri dinlemeye başlamak için uygulamanızda
AddOnConfigUpdateListenernumaralı telefonu arayın ve yeni veya güncellenen tüm parametre değerlerini otomatik olarak getirir. Aşağıdakiler örneğin, güncellemeleri dinler veActivateçağrıldığında, yeni güncellenmiş karşılama mesajını görüntülemek için değerler getirildi.
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);
}
});
Bundan sonra Remote Config cihazınızın yeni bir sürümünü yayınladığınızda, cihazlar çalışan ve değişiklikleri dinleyen bir uygulama kullanıyorsanız dinleyiciyi güncelleyin.
Sonraki adımlar
Henüz yapmadıysanız Remote Config hakkında bilgi edinin. kullanım alanlarına göz atın ve Aşağıdakileri içeren temel kavramlar ve gelişmiş stratejilerle ilgili belgeler: