Firebase Remote Config'i kullanmaya başlayın

Uygulamanızda parametreleri tanımlamak ve bulutta değerlerini 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, güncellenen parametre değerlerini Remote Config arka ucundan almak ve alınan değerlerin uygulamanıza ne zaman sunulacağını 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 özelliğini kullanabilmek için:

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

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

• Firebase C++ SDK'sını 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 indirip C++ projenize taşırsınız).

2. adım: Uygulamanıza Remote Config ekleyin

3. Adım: Uygulama içi varsayılan parametre değerlerini ayarlayın

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

1. Bir dizi parametre adı ve varsayılan parametre değeri tanımlamak için ConfigKeyValue* nesnesi veya dizi boyutunu içeren bir ConfigKeyValueVariant* nesnesi kullanın.

   Remote Config arka uç parametre değerlerini daha önce yapılandırdıysanız bu anahtar/değer çiftlerini içeren bir dosya indirebilir ve 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 kullanılacak parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Remote Config arka ucunda ayarladığınız, getirdiğiniz ve etkinleştirdiğiniz 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, uygulamanızın beklediği veri türüyle eşleşen ve parametre anahtarını bağımsız değişken olarak sağlayan aşağıda listelenen yöntemi çağırın:

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

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'i 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 (sonunda uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerler ayarlayabilirsiniz. Daha fazla bilgi 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 almak 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. Getirilen parametre değerlerini uygulamanızın kullanabileceği hale getirmek için ActivateFetched() işlevini çağırın.

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

Parametre değerlerini aldıktan sonra, Remote Config arka ucundan güncelleme dinlemek için gerçek zamanlı Remote Config kullanabilirsiniz. Güncellemeler mevcut olduğunda bağlı cihazlara anlık Remote Config sinyalleri gönderir ve yeni bir Remote Config sürümü yayınladıktan sonra değişiklikleri otomatik olarak getirir.

Android ve Apple platformları için Firebase C++ SDK v11.0.0 ve sonraki sürümler gerçek zamanlı güncellemeleri destekler.

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

Sonraki adımlar

Henüz yapmadıysanız Remote Config kullanım alanlarını inceleyin ve aşağıdakiler gibi temel kavramlar ve gelişmiş strateji dokümanlarından bazılarına göz atın:

• Remote Config şablon sürümlerini yönetme
• Yapılandırma yükleme stratejileri