Firebase Remote Config'i kullanmaya başlayın

iOS Android Web Birlik C ++

Uygulamanızda parametreleri tanımlamak ve bunların değerlerini bulutta güncellemek için Firebase Remote Config'i kullanarak uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirebilirsiniz. Bu kılavuz gelen klon veya indirmek için kullanılabilir hepsi, başlamak için adım adım yürür ve bazı örnek kodu sağlar Firebase / hızlı başlangıç-android GitHub deposu.

Uygulamanıza Firebase ve Remote Config SDK'yı ekleyin

1. Eğer henüz yapmadıysanız, Android projeye Firebase ekleyin .

2. Uzaktan Config'de için, Google Analytics için gerekli olan uygulama örneklerinin şartlı hedefleme kullanıcı özellikleri, kitleler ve Firebase Tahminleri için. Emin olun Google Analytics etkinleştirmek projenizde.

3. Kullanılması Firebase Android Bom , senin modülü (uygulama düzeyinde) Gradle dosyası (genellikle Uzaktan Yapılandırma Android kütüphanesi için bağımlılık beyan app/build.gradle ).

   Ayrıca, Analytics kurulumunun bir parçası olarak, Google Analytics için Firebase SDK'sını uygulamanıza eklemeniz gerekir.

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:28.4.2')
   
       // Declare the dependencies for the Remote Config and Analytics libraries
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-config'
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

   (Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

   Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

   Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

   dependencies {
       // Declare the dependencies for the Remote Config and Analytics libraries
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-config:21.0.1'
       implementation 'com.google.firebase:firebase-analytics:19.0.2'
   }
   

   Kotlin+KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:28.4.2')
   
       // Declare the dependencies for the Remote Config and Analytics libraries
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-config-ktx'
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.

   (Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan

   Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.

   Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.

   dependencies {
       // Declare the dependencies for the Remote Config and Analytics libraries
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-config-ktx:21.0.1'
       implementation 'com.google.firebase:firebase-analytics-ktx:19.0.2'
   }
   

Not: Android SDK Uzaktan Yapılandırma REST API bağımlılık üzerinde olduğundan, tipik bir projede varsayılan olarak etkin değil devre dışı olduğunu API, yaptığınızdan emin olun.

Remote Config singleton nesnesini alın

Bir Remote Config nesne örneği alın ve sık yenilemelere izin vermek için minimum getirme aralığını ayarlayın:

Java

mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
        .setMinimumFetchIntervalInSeconds(3600)
        .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);
MainActivity.java

Kotlin+KTX

remoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)
MainActivity.kt

Singleton nesnesi, uygulama içi varsayılan parametre değerlerini depolamak, arka uçtan güncellenen parametre değerlerini almak ve alınan değerlerin uygulamanız için ne zaman kullanıma sunulacağını kontrol etmek için kullanılır.

Geliştirme sırasında, nispeten düşük bir minimum getirme aralığı ayarlamanız önerilir. Bkz Kısma fazla bilgi için.

Uygulama içi varsayılan parametre değerlerini ayarla

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

1. Parametre adları ve bir kullanarak varsayılan parametre değerlerinin bir dizi tanımlayın Harita nesne veya bir XML kaynak dosyası uygulamanızın saklanan res/xml klasörünün. Uzaktan Yapılandırma örnek uygulaması kullanan bir hızlı başlangıç XML dosyası varsayılan parametre adları ve değerleri tanımlamak için.
2. Kullanarak uzaktan Yapılandırma nesnesine bu değerleri ekleme setDefaultsAsync(int) gösterildiği gibi,:

Java

mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);

Kotlin+KTX

remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

Uygulamanızda kullanmak için parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerlerini alabilirsiniz. Arka uçta değerler ayarlarsanız, bunları getirir ve ardından etkinleştirirseniz, bu değerler uygulamanızda kullanılabilir. Aksi takdirde, kullandığınız yapılandırılmış uygulama içi parametre değerleri almak setDefaultsAsync(int) . Bu değerleri almak için, parametre anahtarını bağımsız değişken olarak sağlayarak, uygulamanız tarafından beklenen veri türüyle eşleşen aşağıda listelenen yöntemi çağırın:

• getBoolean()
• getDouble()
• getLong()
• getString()

Remote Config arka ucunda parametre değerlerini ayarlayın

Firebase konsolunu veya kullanma Uzaktan Yapılandırma arka uç API'leri , erişim engelleme uygulama içi değerleri istediğiniz koşullu mantık veya kullanıcı hedefleme göre yeni sunucu tarafı varsayılan değerler oluşturabilir. Bu bölüm, bu değerleri oluşturmaya yönelik Firebase konsol adımlarını açıklar.

1. In Firebase konsolunda , projenizi açın.
2. Uzaktan Yapılandırma panosunu görüntülemek için menüden Uzak Config'i seçin.
3. Uygulamanızda tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın. Her parametre için bir varsayılan değer ayarlayabilirsiniz (sonunda ilgili uygulama içi varsayılan değeri geçersiz kılar) ve ayrıca koşullu değerler de ayarlayabilirsiniz. Daha fazla bilgi için bkz Uzaktan Yapılandırma Parametreleri ve Koşulları .

Değerleri getir ve etkinleştir

1. Çağrı Uzaktan yapılandırma arka uç parametre değerleri almak için fetch() metodu. Arka uçta ayarladığınız tüm değerler alınır ve Remote Config nesnesinde saklanır.

2. Uygulamanıza getirilen parametre değerleri kullanılabilir hale getirmek için, çağrı activate() yöntemini.

   Getirmek istediğiniz ve bir çağrıda değerleri aktive durumlarda, bir kullanabilirsiniz fetchAndActivate() uygulaması için Uzaktan Yapılandırma arka uç değerleri alıp bunları kullanılabilir hale getirmek için istek:

   Java

   mFirebaseRemoteConfig.fetchAndActivate()
           .addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
               @Override
               public void onComplete(@NonNull Task<Boolean> task) {
                   if (task.isSuccessful()) {
                       boolean updated = task.getResult();
                       Log.d(TAG, "Config params updated: " + updated);
                       Toast.makeText(MainActivity.this, "Fetch and activate succeeded",
                               Toast.LENGTH_SHORT).show();
   
                   } else {
                       Toast.makeText(MainActivity.this, "Fetch failed",
                               Toast.LENGTH_SHORT).show();
                   }
                   displayWelcomeMessage();
               }
           });

   Kotlin+KTX

   remoteConfig.fetchAndActivate()
           .addOnCompleteListener(this) { task ->
               if (task.isSuccessful) {
                   val updated = task.result
                   Log.d(TAG, "Config params updated: $updated")
                   Toast.makeText(this, "Fetch and activate succeeded",
                           Toast.LENGTH_SHORT).show()
               } else {
                   Toast.makeText(this, "Fetch failed",
                           Toast.LENGTH_SHORT).show()
               }
               displayWelcomeMessage()
           }

Bu güncellenen parametre değerleri uygulamanızın davranışını ve görünümünü etkilediğinden, örneğin kullanıcının uygulamanızı bir sonraki açılışında olduğu gibi, kullanıcınız için sorunsuz bir deneyim sağlayan bir zamanda alınan değerleri etkinleştirmelisiniz. Bkz Uzaktan Yapılandırma yükleme stratejilerini daha fazla bilgi ve örnekler için.

Not: Uygulamanız Gradle ile inşa etmezse, el doğru eklemelisiniz google_app_id o Uzaktan Yapılandırma başlatmak böylece uygulamanıza dize kaynağı. google-services Gradle eklenti normalde otomatik olarak ekler, ancak uygun değerini bulabilirsiniz google-services.json Eğer Firebase konsolundan indirmek o dosyanın. Alma konusunda daha fazla bilgi için google_app_id değeri google-services.json dosyası, bkz JSON dosyası işleniyor .

kısma

Bir uygulama kısa bir süre içinde çok kez getirir, çağrılar daraltma edilir getirme ve SDK döndürür FirebaseRemoteConfigFetchThrottledException . SDK 17.0.0 sürümünden önce, sınır 60 dakikalık bir pencerede 5 getirme isteğiydi (daha yeni sürümlerde daha fazla izin verilen sınır var).

Uygulama geliştirme sırasında, uygulamanızı geliştirirken ve test ederken hızla yinelemenizi sağlamak için yapılandırmaları çok sık (saatte birçok kez) getirip etkinleştirmek isteyebilirsiniz. 10 geliştiricilere kadar olan bir proje üzerinde hızlı iterasyon yerleştirmek için, geçici bir ayarlayabilirsiniz FirebaseRemoteConfigSettings aralığı (getirme düşük minimum nesne setMinimumFetchIntervalInSeconds uygulamanızda).

Remote Config için varsayılan minimum getirme aralığı 12 saattir; bu, gerçekte kaç tane getirme çağrısı yapıldığından bağımsız olarak, yapılandırmaların arka uçtan 12 saatlik bir pencerede bir kereden fazla getirilmeyeceği anlamına gelir. Spesifik olarak, minimum getirme aralığı şu sırayla belirlenir:

1. Parametresi fetch(long)
2. Parametre FirebaseRemoteConfigSettings.setMinimumFetchIntervalInSeconds(long)
3. 12 saatlik varsayılan değer

En az bir özel bir değer, kullanımı aralığı getirme ayarlamak için FirebaseRemoteConfigSettings.Builder.setMinimumFetchIntervalInSeconds(long) .

Bu ayarın, üretimde çalışan bir uygulama için değil, yalnızca geliştirme için kullanılması gerektiğini unutmayın. Uygulamanızı 10 kişilik küçük bir geliştirme ekibiyle test ediyorsanız, saatlik hizmet tarafı kota sınırlarına ulaşmanız pek olası değildir. Ancak uygulamanızı çok düşük bir minimum getirme aralığıyla binlerce test kullanıcısına gönderirseniz, uygulamanız muhtemelen bu kotaya ulaşır.

Sonraki adımlar

Henüz varsa, Uzaktan Yapılandırma keşfetmek kullanım durumları ve anahtar kavramları ve gelişmiş stratejiler dokümantasyon dahil bazılarına bir göz atın:

• Şablonlar ve sürüm oluşturma
• Yükleme stratejilerini yapılandır