Firebase Remote Config'i kullanmaya başlayın


Uygulamanızda parametreleri tanımlamak için Firebase Remote Config'i 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: Uygulamanıza Remote Config'i 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ğıdaki 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ğıdaki 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'de ayarlayabilirsiniz ile bağlantı kurmadan önce amaçlandığı gibi davranmasını sağlamak için Remote Config arka ucu; 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ı.

    Remote Config arka uç parametresini daha önce yapılandırdıysanız değerlerini içeren bir dosya indirebilir ve bu anahtar/değer çiftlerini map nesnenizi oluşturmak için kullanabilirsiniz. Daha fazla bilgi için bkz. İndir Remote Config şablonu varsayılanları.

  2. Bu değerleri Remote Config nesnesine eklemek için 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 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. Menüden Remote Config'i seçerek Remote Config kontrol panelini görüntüleyin.
  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 parametreleri ve koşulları.

6. Adım: Değerleri getirin ve etkinleştirin

  1. Remote Config arka ucundan parametre değerlerini almak için Fetch() yöntemidir. Arka uçta ayarladığınız tüm değerler getirilir ve Remote Config nesnesinde önbelleğe alınmış.
  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 özelliğini kullanarak Remote Config arka ucundan gelen güncellemeleri dinleyin. Gerçek zamanlı Remote Config, güncelleme olduğunda bağlı cihazlara sinyal gönderir 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);
      }
    });

Remote Config'inizin yeni bir sürümünü yayınladığınızda, ç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'i keşfedin kullanım alanlarına göz atın ve Aşağıdakileri içeren temel kavramlar ve gelişmiş stratejilerle ilgili belgeler: