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, başlama adımlarında size yol gösterir ve tümü firebase/quickstart-js GitHub deposundan kopyalanabilen veya indirilebilen bazı örnek kodlar sağlar.

Remote Config SDK'yı ekleyin ve başlatın

  1. Henüz yapmadıysanız, Firebase JS SDK'yı yükleyin ve Firebase'i başlatın .

  2. Remote Config JS SDK'yı ekleyin ve Remote Config'i başlatın:

Web version 9

import { initializeApp } from "firebase/app";
import { getRemoteConfig } from "firebase/remote-config";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Remote Config and get a reference to the service
const remoteConfig = getRemoteConfig(app);

Web version 8

import firebase from "firebase/app";
import "firebase/remote-config";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Remote Config and get a reference to the service
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.

Minimum getirme aralığını ayarla

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.

Web version 9

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Web version 8

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

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 version 9

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

Web version 8

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

Remote Config arka uç parametre değerlerini zaten yapılandırdıysanız, tüm varsayılan değerleri içeren oluşturulmuş bir JSON dosyasını indirebilir ve bunu uygulama paketinize dahil edebilirsiniz:

DİNLENME

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=JSON -o remote_config_defaults.json

Firebase konsolu

  1. Parametreler sekmesinde Menüsünü açın ve Varsayılan değerleri indir öğesini seçin.
  2. İstendiğinde, web için .json'u etkinleştirin ve ardından Dosyayı indir öğesini tıklayın.

Aşağıdaki örnekler, uygulamanızda varsayılan değerleri içe aktarmanın ve ayarlamanın iki farklı yolunu gösterir. İlk örnek, uygulama paketinizde bulunan varsayılanlar dosyasına bir HTTP isteği yapacak olan fetch öğesini kullanır:


  const rcDefaultsFile = await fetch('remote_config_defaults.json');
  const rcDefaultsJson = await rcDefaultsFile.json();
  remoteConfig.defaultConfig = rcDefaultsJson;
  

Sonraki örnek, değerleri derleme zamanında uygulamanızda derleyen require öğesini kullanır:

  let rcDefaults = require('./remote_config_defaults.json');
  remoteConfig.defaultConfig = rcDefaults;

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 ayarlar, bunları getirir ve ardından etkinleştirirseniz, bu değerler uygulamanız için kullanılabilir. Bu değerleri almak için parametre anahtarını argüman olarak sağlayarak getValue() yöntemini çağırın.

Web version 9

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

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

Web version 8

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

Parametre değerlerini ayarla

Firebase konsolunu veya Remote Config arka uç API'lerini kullanarak, istediğiniz koşullu mantığa veya kullanıcı hedeflemeye 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 bir varsayılan değer ayarlayabilirsiniz (bu, sonunda 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. Remote Config Parameters and Conditions .

Değerleri getir ve etkinleştir

  1. Remote Config arka ucundan parametre değerlerini almak için fetchConfig() yöntemini çağırın. Arka uçta ayarladığınız tüm değerler, Remote Config nesnesinde alınır ve önbelleğe alınır.
  2. Getirilen parametre değerlerini uygulamanız için kullanılabilir hale getirmek için activate() yöntemini çağırın.

Bir çağrıda değerleri almak ve etkinleştirmek istediğiniz durumlarda, bu örnekte gösterildiği gibi fetchAndActivate() kullanın:

Web version 9

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

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

Web version 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. 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 getirirse, getirme çağrıları kısılabilir. Bu gibi durumlarda, SDK bir FETCH_THROTTLE hatası verir. 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. Çok sayıda geliştiriciye sahip bir projede hızlı yinelemeye uyum sağlamak için, uygulamanıza düşük minimum getirme aralığına ( Settings.minimumFetchIntervalMillis ) sahip bir mülkü geçici olarak ekleyebilirsiniz.

Remote Config için varsayılan ve önerilen üretim 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ığı aşağıdaki sırayla belirlenir:

  1. Settings.minimumFetchIntervalMillis içindeki parametre.
  2. 12 saatlik varsayılan değer.

Sonraki adımlar

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