Catch up on everthing we announced at this year's Firebase Summit. Learn more

Inizia con Firebase Remote Config

Puoi utilizzare Firebase Remote Config per definire i parametri nella tua app e aggiornarne i valori nel cloud, consentendoti di modificare l'aspetto e il comportamento della tua app senza distribuire un aggiornamento dell'app. Questa guida ti guida attraverso i passi per iniziare e fornisce alcuni esempi di codice, ognuno dei quali è disponibile per clonare o il download dal QuickStart-js Firebase / repository GitHub.

Aggiungi Remote Config alla tua app

  1. Installare il Firebase SDK per Web.

  2. Creare l'oggetto Singleton Remote Config:

    Versione web 9

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

    Versione web 8

    const remoteConfig = firebase.remoteConfig();

    Questo oggetto viene usato per archiviare i valori dei parametri predefiniti in-app, recuperare i valori dei parametri aggiornati dal back-end di Remote Config e controllare quando i valori recuperati sono resi disponibili per la tua app.

  3. Imposta un intervallo di recupero minimo:

    Versione web 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Versione web 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Durante lo sviluppo, si consiglia di impostare un intervallo di recupero minimo relativamente basso. Vedere Throttling per ulteriori informazioni.

Imposta i valori dei parametri predefiniti in-app

È possibile impostare i valori dei parametri predefiniti in-app nell'oggetto Remote Config, in modo che l'app si comporti come previsto prima di connettersi al back-end di Remote Config e in modo che i valori predefiniti siano disponibili se non ne sono impostati sul back-end.

Versione web 9

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

Versione web 8

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

Ottieni i valori dei parametri da utilizzare nella tua app

Ora puoi ottenere i valori dei parametri dall'oggetto Remote Config. Se in seguito imposti i valori nel back-end, li recuperi e quindi li attivi, quei valori sono disponibili per la tua app. Per ottenere questi valori, chiamare il getValue() il metodo, che fornisce il tasto del parametro come argomento.

Versione web 9

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

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

Versione web 8

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

Imposta i valori dei parametri

Utilizzando la console Firebase o le API di back-end di configurazione remoto , è possibile creare nuovi valori di default sul lato server che sostituiscono i valori in-app in base alle proprie logica condizionale desiderato o targeting degli utenti. Questa sezione ti guida attraverso i passaggi della console Firebase per creare questi valori.

  1. Nella console Firebase , aprire il progetto.
  2. Selezionare Configurazione remota dal menu per visualizzare il cruscotto Configurazione remota.
  3. Definisci i parametri con gli stessi nomi dei parametri che hai definito nella tua app. Per ogni parametro, puoi impostare un valore predefinito (che alla fine sovrascriverà il valore predefinito in-app) e puoi anche impostare valori condizionali. Per ulteriori informazioni, consultare Remote Config parametri e condizioni .

Recupera e attiva i valori

  1. Per recuperare i valori dei parametri dal backend Configurazione remota, chiamare il fetchConfig() metodo. Tutti i valori impostati sul back-end vengono recuperati e memorizzati nella cache nell'oggetto Remote Config.
  2. Per rendere i valori dei parametri recuperati a disposizione per la vostra applicazione, chiamare activate() metodo.

Per i casi in cui si desidera recuperare e attivare i valori in una chiamata, usare fetchAndActivate() , come mostrato in questo esempio:

Versione web 9

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

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

Versione web 8

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

Poiché questi valori dei parametri aggiornati influiscono sul comportamento e sull'aspetto della tua app, dovresti attivare i valori recuperati in un momento che garantisca un'esperienza fluida per il tuo utente, ad esempio la prossima volta che l'utente apre la tua app. Vedere le strategie di carico di configurazione remota per ulteriori informazioni ed esempi.

Limitazione

Se un'app viene recuperata troppe volte in un breve periodo di tempo, le chiamate di recupero potrebbero essere limitate. In questi casi, l'SDK lancia un FETCH_THROTTLE errore. Si consiglia di rilevare questo errore e riprovare in modalità di backoff esponenziale, attendendo intervalli più lunghi tra le successive richieste di recupero.

Durante lo sviluppo dell'app, potresti voler aggiornare la cache molto frequentemente (più volte all'ora) per consentirti di eseguire rapidamente l'iterazione durante lo sviluppo e il test dell'app. Per ospitare iterazione rapida su un progetto con numerosi sviluppatori, è possibile aggiungere una proprietà temporaneo con un minimo basso prendere intervallo ( Settings.minimumFetchIntervalMillis ) nella vostra applicazione.

L'intervallo di recupero della produzione predefinito e consigliato per Remote Config è di 12 ore, il che significa che le configurazioni non verranno recuperate dal back-end più di una volta in una finestra di 12 ore, indipendentemente dal numero di chiamate di recupero effettivamente effettuate. In particolare, l'intervallo di recupero minimo è determinato nel seguente ordine:

  1. Il parametro in Settings.minimumFetchIntervalMillis .
  2. Il valore predefinito di 12 ore.

Prossimi passi

Se non l'hai già, esplorare le Configurazione remota casi d'uso , e dare un'occhiata ad alcuni dei concetti chiave e avanzati documentazione strategie, tra cui: