Firebase Remote Config'i kullanmaya başlayın


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.

ziyaret edin.

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:

  1. JNI ortamını ve Etkinliği ileterek bir Firebase uygulaması oluşturun:

    app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

  2. 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:

  1. Firebase uygulaması oluşturun:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. 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.

  1. Parametre adlarını ve varsayılan parametre değerlerini tanımlamak için std::map<const char*, const char*> nesne veya a std::map<const char*, firebase::Variant> nesne algılandı.

    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 map nesnenizi oluşturmayı deneyin. Daha fazla bilgi için bkz. İndir Remote Config şablon varsayılanları.

  2. 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

  1. Firebase konsolunda projenizi açın.
  2. Remote Config kontrol panelini görüntülemek için menüden Remote Config simgesini seçin.
  3. Ş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

  1. 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ı.
  2. 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.

  1. Güncellemeleri dinlemeye başlamak için uygulamanızda AddOnConfigUpdateListener numaralı telefonu arayın ve yeni veya güncellenen tüm parametre değerlerini otomatik olarak getirir. Aşağıdakiler örneğin, güncellemeleri dinler ve Activate ç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: