Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Firebase Remote Config'i kullanmaya başlayın

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'
    }
    

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);

Kotlin+KTX

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

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:

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.

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

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: