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ıç-js GitHub depo.

Uygulamanıza Remote Config ekleyin

  1. Firebase SDK'yı yükleyin Web için.

  2. Singleton Remote Config nesnesini oluşturun:

    Web sürümü 9

    import { getRemoteConfig } from "firebase/remote-config";
    
    const remoteConfig = getRemoteConfig();

    Web sürümü 8

    const remoteConfig = firebase.remoteConfig();

    Bu nesne, 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ız için ne zaman kullanıma sunulacağını kontrol etmek için kullanılır.

  3. Minimum bir getirme aralığı belirleyin:

    Web sürümü 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Web sürümü 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    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.

Web sürümü 9

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

Web sürümü 8

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

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

Artık Remote Config nesnesinden parametre değerlerini alabilirsiniz. Daha sonra arka uçta değerler ayarlarsanız, bunları getirir ve ardından etkinleştirirseniz, bu değerler uygulamanızda kullanılabilir. Bu değerler elde etmek için, çağrı getValue() bir bağımsız değişken olarak bir parametre anahtarı sağlayan bir yöntem.

Web sürümü 9

import { getValue } from "firebase/remote-config";

const val = getValue(remoteConfig, "welcome_messsage");

Web sürümü 8

const val = remoteConfig.getValue("welcome_messsage");

Parametre değerlerini ayarla

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şturmak için Firebase konsolu adımlarında size yol gösterir.

  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 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. Uzaktan yapılandırma arka uç parametre değerleri almak için, çağrı fetchConfig() metodu. Arka uçta ayarladığınız tüm değerler, Remote Config nesnesinde alınır ve önbelleğe alını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 durumlar için, kullanmak fetchAndActivate() bu örnekte görüldüğü gibi:

Web sürümü 9

import { fetchAndActivate } from "firebase/remote-config";

fetchAndActivate(remoteConfig)
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

Web sürümü 8

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

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 fazla getirirse, getirme çağrıları kısıtlanabilir. Bu gibi durumlarda, SDK atar FETCH_THROTTLE hatası. Bu hatayı yakalamanız ve sonraki getirme istekleri arasında daha uzun aralıklarla bekleyerek üstel geri çekme modunda yeniden denemeniz önerilir.

Uygulama geliştirme sırasında, uygulamanızı geliştirirken ve test ederken hızla yinelemenizi sağlamak için önbelleği çok sık (saatte birçok kez) yenilemek isteyebilirsiniz. Sayısız geliştiricileri ile bir proje üzerinde hızlı iterasyon yerleştirmek için, geçici aralığı (getirme düşük minimum bir özellik ekleyebilir Settings.minimumFetchIntervalMillis uygulamanızda).

Remote Config için varsayılan ve önerilen üretim getirme aralığı 12 saattir; bu, gerçekte kaç 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ığı aşağıdaki sırayla belirlenir:

  1. Parametresi Settings.minimumFetchIntervalMillis .
  2. 12 saatlik varsayılan değer.

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: