Firebase Remote Config'i kullanmaya başlayın


Uygulamanızda parametreleri tanımlamak için Firebase Remote Config kullanabilir ve değerlerini bulutta güncelleyerek görünümü ve uygulamanızın davranışını gösteren bir kontrol listesidir. Bu kılavuzda adımları uygulayın ve size birkaç örnek kod sağlayın. Bu kodun şuradan klonlayabilir veya indirilebilir: firebase/quickstart-js GitHub deposu.

1. Adım: Remote Config SDK'sını 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'sını ekleyin ve Remote Config uygulamasını başlatın:

Web

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

import firebase from "firebase/compat/app";
import "firebase/compat/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 için kullanılır, getirme güncellendi Remote Config arka ucundan parametre değerleri ve getirildiğinde kontrol değerleri, uygulamanız için kullanılabilir hale gelir.

2. Adım: Minimum getirme aralığını ayarlayın

Geliştirme sırasında, nispeten düşük bir minimum getirme değeri ayarlamanız önerilir. seçebilirsiniz. Aşağıdakiler için Throttling bölümünü inceleyin: daha fazla bilgi edinin.

Web

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Web

remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

3. Adım: Uygulama içi varsayılan parametre değerlerini ayarlayın

Uygulama içi varsayılan parametre değerlerini Remote Config Böylece, uygulamanız başka bir cihaza bağlanmadan önce beklendiği gibi Remote Config arka ucuna erişebilir, böylece arka uçta hiçbiri ayarlanmadı.

Web

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

Web

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

Hâlihazırda Remote Config arka uç parametre değerini yapılandırdıysanız tüm varsayılan değerleri ve referans değeri içeren, oluşturulmuş bir JSON dosyasını bunu uygulama paketinize dahil edin:

REST

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ü'yü açın ve Varsayılan değerleri indirin.
  2. İstendiğinde web için.json dosyasını etkinleştirin ve ardından Dosyayı indir'i tıklayın.

Aşağıdaki örneklerde, içe aktarma ve varsayılan olarak ayarlama için kullanabileceğiniz iki farklı yöntem gösterilmektedir değeri hakkında daha fazla bilgi edinin. İlk örnekte fetch kullanılmıştır. Bu, Uygulama paketinizde bulunan varsayılan dosyaya HTTP isteği:

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

Sonraki örnekte, değerleri uygulamanızda derleyen require kullanılır. derleme sırasında:

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

4. adım: Uygulamanızda kullanılacak parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Daha sonra arka uçta değerler ayarlar, bunları getirir ve sonra etkinleştirirseniz bu değerler kullanabilirsiniz.Bu değerleri almak için getValue() yöntemini kullanarak parametresini kullanabilirsiniz.

Web

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

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

Web

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

5. adım: Parametre değerlerini ayarlayın

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

  1. Firebase konsolunda projenizi açın.
  2. Remote Config öğesini görüntülemek için menüden Remote Config öğesini seçin. kontrol paneli
  3. Şu parametrede tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın: en iyi şekilde yararlanabilirsiniz. Her parametre için bir varsayılan değer ( uygulama içi varsayılan değeri geçersiz kılabilir) koşullu değerlerdir. Daha fazla bilgi edinmek için bkz. Remote Config Parametreler ve Koşullar

6. Adım: Değerleri getirin ve etkinleştirin

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

Değerleri tek bir çağrıda getirmek ve etkinleştirmek istediğiniz durumlarda fetchAndActivate() aşağıdaki örnekte gösterildiği gibi:

Web

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

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

Web

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

Bu güncellenen parametre değerleri davranışı ve görünümü etkilediği için getirmeyi seçerseniz, getirilen değerleri uygulamanın sağlandığından sorunsuz bir deneyim sunmasını sağlar (örneğin, kullanıcı uygulamasını indirin. Remote Config yükleme stratejilerine bakın daha fazla bilgi ve örnek bulabilirsiniz.

Kısıtlama

Bir uygulama kısa bir süre içinde çok fazla veri getirirse getirme aramaları daraltılır. Böyle durumlarda SDK bir FETCH_THROTTLE hatası gönderir. Bu hatayı yakalayıp eksponansiyel geri yükleme modunda yeniden denemeniz önerilir. sonraki getirme istekleri arasında daha uzun aralıklar bekleniyor.

Uygulama geliştirme sürecinde önbelleği sık sık yenilemek isteyebilirsiniz. (saatte birçok kez) bu özellik, geliştirme ve test etme sürecinde hızla yineleme uygulamasını indirin. Çok sayıda geliştiricinin bulunduğu bir projede hızlı iterasyon yapabilmek için geçici olarak, düşük minimum getirme aralığına sahip bir mülk ekleyebilir (Settings.minimumFetchIntervalMillis) inceleyebilirsiniz.

Remote Config için varsayılan ve önerilen üretim getirme aralığı 12 saat. Bu, yapılandırmaların 12 saat içinde arka uçtan bir kereden fazla alınmadığı anlamına gelir sayısını belirler. Daha ayrıntılı belirtmek gerekirse, minimum getirme aralığı şu sırayla belirlenir:

  1. Settings.minimumFetchIntervalMillis hücresindeki parametre.
  2. Varsayılan değer olan 12 saat.
ziyaret edin.

Sonraki adımlar

Henüz yapmadıysanız Remote Config hakkında bilgi edinin. kullanım alanlarına göz atın ve Aşağıdakileri içeren temel kavramlar ve gelişmiş stratejilerle ilgili belgeler: