C++'ta Remote Config'i kullanmaya başlama

Platform seçin:

iOS+ Android Web Flutter Unity C++

Uygulamanızda parametreleri tanımlamak ve buluttaki değerlerini güncellemek için Firebase Remote Config hizmetini kullanabilirsiniz. Böylece uygulama güncellemesi yayınlamadan 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 alınan değerlerin uygulamanızda ne zaman kullanılabilir hale getirileceğini kontrol etmek için kullanılır. Daha fazla bilgi için Remote Config yükleme stratejileri başlıklı makaleyi inceleyin.

1. adım: Firebase'i uygulamanıza ekleyin

Remote Config kullanmaya başlamak için şunları yapmanız gerekir:

• C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

  C++ projeniz Firebase'i kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmıştır.

• Firebase C++ SDK'sını C++ projenize ekleyin.

Bu ilk kurulum görevleriyle ilgili ayrıntılı talimatları C++ projenize Firebase ekleme başlıklı makalede bulabilirsiniz.

C++ projenize Firebase eklemek için hem Firebase konsolunda hem de açık C++ projenizde görevler gerçekleştirmeniz gerekir (ör. Firebase yapılandırma dosyalarını konsoldan indirip C++ projenize taşımanız gerekir).

2. adım: Uygulamanıza Remote Config 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ı gösterildiği gibi ilk kullanıma hazırlayın:

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

iOS+

Firebase'i uygulamanıza ekledikten sonra:

1. Firebase uygulaması oluşturma:

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

2. Remote Config kitaplığını gösterildiği gibi ilk kullanıma hazırlayın:

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

3. adım: Uygulama içi varsayılan parametre değerlerini ayarlama

Uygulama içi varsayılan parametre değerlerini Remote Config nesnesinde ayarlayabilirsiniz. Böylece uygulamanız, Remote Config arka ucuna bağlanmadan önce istediğiniz gibi davranır ve arka uçta herhangi bir değer ayarlanmamışsa varsayılan değerler kullanılabilir.

Önemli: Gizli verileri Remote Config parametre anahtarlarında veya değerlerinde saklamayın. Remote Config verileri aktarım sırasında şifrelenir ancak son kullanıcılar, istemci uygulama örneklerinde kullanılabilen tüm varsayılan veya getirilmiş Remote Config parametrelerine erişebilir.

1. Dizinin boyutuna göre 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 dosya indirip map nesnenizi oluşturmak için kullanabilirsiniz. Daha fazla bilgi için Remote Config şablonu varsayılanlarını 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ğerlerini alabilirsiniz. Remote Config arka ucunda değerler ayarladıysanız, bunları aldıysanız ve ardından etkinleştirdiyseniz 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 uygulamanızın beklediği veri türüyle eşleşen aşağıdaki yöntemlerden birini çağırın ve parametre anahtarını bağımsız değişken olarak sağlayın:

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

5. adım: Parametre değerlerini ayarlayın

1. Firebase konsolunda DevOps & Engagement > Remote Config'e gidin.

2. Uygulamanızda tanımladığınız parametrelerle aynı adlara sahip parametreler tanımlayın. Her parametre için varsayılan bir değer (sonuçta 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. Remote Config arka ucundan parametre değerlerini getirmek için Fetch() yöntemini çağırın. Arka uçta ayarladığınız tüm değerler getirilir ve Remote Config nesnesinde önbelleğe alınır.
2. Alınan parametre değerlerini uygulamanızda kullanılabilir hale getirmek için ActivateFetched() yöntemini çağırın.

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

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

Anlık güncellemeler, Android ve Apple platformları için Firebase C++ SDK'sının 11.0.0 ve sonraki sürümleri tarafından desteklenir.

Önemli: Gerçek zamanlı Remote Config için Firebase Remote Config Realtime API'nin de etkinleştirilmesi gerekir. Bu API'nin zaten etkinleştirilmiş olması gerekir. Doğrulamak için Google Cloud konsolunu açın, projenizi seçin ve API'ler ve Hizmetler sayfasını açın. API, etkin olarak görünmelidir. Eksikse veya etkinleştirilmemişse API'leri ve Hizmetleri Etkinleştir'i tıklayın, Firebase Remote Config Realtime API'yi arayın ve etkinleştirin.

1. Uygulamanızda, güncellemeleri dinlemeye başlamak ve yeni veya güncellenmiş parametre değerlerini otomatik olarak almak için AddOnConfigUpdateListener yöntemini çağırın. Aşağıdaki örnekte, güncellemeler dinlenir ve Activate çağrıldığında, güncellenmiş bir karşılama mesajı göstermek için yeni getirilen değerler kullanılı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 uygulamanızın yeni bir 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.