了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Firebase Remote Config'i kullanmaya başlayın


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:

  1. JNI ortamında ve Activity:

    app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
    geçen bir Firebase Uygulaması oluşturun

  2. Remote Config kitaplığını gösterildiği gibi başlatın:

    ::firebase::remote_config::Initialize(app);

iOS+

Firebase'i uygulamanıza ekledikten sonra:

  1. Bir Firebase Uygulaması Oluşturun:

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

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

  1. Bir std::map<const char*, const char*> nesnesi veya bir std::map<const char*, firebase::Variant> nesnesi kullanarak bir dizi parametre adı ve varsayılan parametre değerleri 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 bkz. Remote Config şablonu varsayılanlarını indirme .

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

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

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

  1. Uygulamanızda, güncellemeleri dinlemeye başlamak ve yeni veya güncellenmiş parametre değerlerini otomatik olarak getirmek için AddOnConfigUpdateListener arayın. Aşağıdaki örnek, güncellemeleri dinler ve Activate ç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.

Sonraki adımlar

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: