Firebase Remote Config'i kullanmaya başlayın


Uygulamanızda parametreler tanımlamak ve bu parametrelerin değerlerini bulutta 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, Remote Config arka ucundan güncellenmiş parametre değerlerini getirmek ve getirilen değerlerin uygulamanızda ne zaman kullanılabileceğini 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 kullanabilmek için:

Firebase'i C++ projenize eklemenin hem Firebase konsolda 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:

  1. JNI ortamını ve etkinliğini 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+

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

Uygulamanızın Remote Config arka ucuna bağlanmadan önce amaçlandığı gibi davranması ve arka uçta ayarlanmamışsa varsayılan değerlerin kullanılabilmesi için uygulama içi varsayılan parametre değerlerini Remote Config nesnesinde ayarlayabilirsiniz.

  1. Dizi boyutuyla bir ConfigKeyValue* nesnesi veya ConfigKeyValueVariant* nesnesi kullanarak bir dizi parametre adı ve varsayılan parametre değeri tanımlayın.

    Remote Config arka uç parametre değerlerini zaten yapılandırdıysanız bu anahtar/değer çiftlerini içeren bir dosyayı indirebilir ve map nesnenizi oluşturmak için kullanabilirsiniz. Daha fazla bilgi için Şablon varsayılanlarını Remote Config indirme başlıklı makaleyi inceleyin.

  2. SetDefaults() kullanarak bu değerleri Remote Config nesnesine ekleyin.

4. adım: Uygulamanızda kullanmak için parametre değerleri edinin

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Remote Config arka ucunda değerler ayarlayıp bunları getirdikten ve etkinleştirdikten sonra bu 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 aşağıdaki yöntemi çağırın. Bu yöntem, parametre anahtarını bağımsız değişken olarak sağlayarak uygulamanızın beklediği veri türüyle eşlenir:

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. Uygulamanızda tanımladığınız parametrelerle aynı ada sahip parametreler tanımlayın. Her parametre için bir varsayılan değer (bu değer, uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerler ayarlayabilirsiniz. Daha fazla bilgi edinmek için Remote Config parametreleri ve koşulları başlıklı makaleyi inceleyin.

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

  1. Parametre değerlerini Remote Config arka ucundan getirmek için Fetch() yöntemini çağırın. Arka uçta ayarladığınız tüm değerler getirilip Remote Config nesnesinde önbelleğe alınır.
  2. Getirilen parametre değerlerini uygulamanızda kullanmak için ActivateFetched()

7. adım: Güncellemeleri anlık olarak dinleyin

Parametre değerlerini getirdikten sonra, Remote Config arka ucundan gelen güncellemeleri dinlemek için gerçek zamanlı Remote Config'yı kullanabilirsiniz. Güncellemeler kullanıma sunulduğunda bağlı cihazlara Remote Configanlık sinyaller gönderir ve yeni bir sürüm yayınladıktan sonra değişiklikleri otomatik olarak getirir.Remote Config

Anlık güncellemeler, Android ve Apple platformlarında Firebase C++ SDK v11.0.0 ve sonraki sürümlerinde desteklenir.

  1. Uygulamanızda, güncellemeleri dinlemeye başlamak ve yeni veya güncellenmiş parametre değerlerini otomatik olarak getirmek için AddOnConfigUpdateListener işlevini çağırın. Aşağıdaki örnek, güncellemeleri dinler ve Activate çağrıldığında yeni getirilen değerleri kullanarak güncellenmiş bir karşılama mesajı gösterir.
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);
      }
    });

Bir sonraki Remote Config 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 de dahil olmak üzere bazı temel kavramlar ile gelişmiş stratejilerle ilgili dokümanlara göz atın: