Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Android'de Firebase Remote Config'i kullanmaya başlayın

Uygulamanızda parametreleri tanımlamak ve buluttaki değerlerini güncellemek için Firebase Remote Config'i kullanarak, bir uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirmenize olanak tanır. Bu kılavuz, başlangıç ​​adımlarında size yol gösterir ve tümü firebase / quickstart-android GitHub deposundan klonlanıp indirilebilen bazı örnek kodlar sağlar.

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

  1. Henüz yapmadıysanız, Android projenize Firebase'i ekleyin .

  2. Remote Config için, uygulama örneklerinin kullanıcı mülklerine, kitlelere ve Firebase Predictions'a koşullu hedeflenmesi için Google Analytics gereklidir. Projenizde Google Analytics'i etkinleştirdiğinizden emin olun.

  3. Remote Config Android kitaplığının bağımlılığını modülünüze (uygulama düzeyi) Gradle dosyasına (genellikle app/build.gradle ) app/build.gradle .

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

    Java

    implementation 'com.google.firebase:firebase-config:19.2.0'
    implementation 'com.google.firebase:firebase-analytics:17.5.0'
    

    Kotlin + KTX

    implementation 'com.google.firebase:firebase-config-ktx:19.2.0'
    implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    

Remote Config singleton nesnesini alın

Bir Remote Config nesnesi örneği alın ve sık 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üncellenmiş parametre değerlerini almak ve getirilen değerlerin uygulamanızda 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. Daha fazla bilgi için Kısma bölümüne bakın.

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 uca bağlanmadan önce amaçlandığı gibi davranır ve böylece arka uçta hiçbiri ayarlanmadıysa varsayılan değerler kullanılabilir.

  1. Uygulamanızın res/xml klasöründe depolanan bir Map nesnesini veya XML kaynak dosyasını kullanarak bir dizi parametre adı ve varsayılan parametre değeri tanımlayın. Remote Config hızlı başlangıç ​​örnek uygulaması, varsayılan parametre adlarını ve değerlerini tanımlamak için bir XML dosyası kullanır.
  2. Bu değerleri gösterildiği gibi setDefaultsAsync (int) kullanarak Remote Config nesnesine ekleyin:

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ğerleri alabilirsiniz. Arka uçta değerler ayarlarsanız, bunları getirin ve ardından etkinleştirirseniz, bu değerler uygulamanızda kullanılabilir. Aksi takdirde, setDefaultsAsync (int) 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ğıda listelenen yöntemi çağırın ve parametre anahtarını bağımsız değişken olarak sağlayın:

Remote Config arka ucunda parametre değerlerini ayarlayın

Firebase konsolunu veya Remote Config arka uç API'larını kullanarak, istediğiniz koşullu mantığa veya kullanıcı hedeflemesine göre uygulama içi değerleri geçersiz kılan yeni sunucu tarafı varsayılan değerleri oluşturabilirsiniz. Bu bölüm, bu değerleri oluşturmak için Firebase konsolu adımlarında size yol gösterir.

  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ı adlara sahip parametreleri tanımlayın. Her parametre için, varsayılan bir değer belirleyebilir (sonuçta ilgili uygulama içi varsayılan değeri geçersiz kılar) ve ayrıca koşullu değerler de ayarlayabilirsiniz. Daha fazla bilgi edinmek için, bkz. Uzaktan Yapılandırma Parametreleri ve Koşulları .

Değerleri getir ve etkinleştir

  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 saklanır.
  2. Getirilen parametre değerlerini uygulamanızda kullanılabilir hale getirmek için, enable () yöntemini çağırın.

    Değerleri tek bir çağrıda almak ve etkinleştirmek istediğiniz durumlarda, Remote Config arka fetchAndActivate() değerleri almak ve bunları uygulamada kullanılabilir hale getirmek için fetchAndActivate() isteği kullanabilirsiniz:

    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, getirilen değerleri, örneğin kullanıcının uygulamanızı bir sonraki açışında olduğu gibi, kullanıcınız için sorunsuz bir deneyim sağlayan bir zamanda etkinleştirmelisiniz. Daha fazla bilgi ve örnekler için Remote Config yükleme stratejilerine bakın.

Kısma

Bir uygulama kısa bir süre içinde çok fazla kez getirilirse, getirme çağrıları FirebaseRemoteConfigFetchThrottledException ve SDK, FirebaseRemoteConfigFetchThrottledException döndürür. SDK sürüm 17.0.0'dan önce sınır, 60 dakikalık bir pencerede 5 getirme isteğiydi (daha yeni sürümler daha fazla izin verme sınırına sahiptir).

Uygulama geliştirme sırasında, uygulamanızı geliştirip test ederken hızlı bir şekilde yineleme yapmanıza olanak 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, yapılandırmaların arka uçtan 12 saatlik bir pencerede, gerçekte kaç getirme çağrısı yapıldığına bakılmaksızın birden fazla kez getirilmeyeceği anlamına gelir. Spesifik olarak, minimum getirme aralığı şu sırayla belirlenir:

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

Minimum getirme aralığını özel bir değere ayarlamak için FirebaseRemoteConfigSettings.Builder.setMinimumFetchIntervalInSeconds(long) kullanın.

Sonraki adımlar

Henüz yapmadıysanız, Remote Config kullanım örneklerini keşfedin ve aşağıdakiler dahil bazı temel kavramlara ve gelişmiş strateji belgelerine göz atın: