Inizia con Firebase Remote Config

iOS+ Android Web Flutter Unity C++

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 passaggi per iniziare e fornisce del codice di esempio.

Passaggio 1: aggiungi Firebase e Remote Config SDK alla tua app

1. Installa e inizializza gli SDK Firebase per Flutter se non lo hai già fatto.

2. Per Remote Config, Google Analytics è necessario per il targeting condizionale delle istanze dell'app alle proprietà utente e ai segmenti di pubblico. Assicurati di abilitare Google Analytics nel tuo progetto.

3. Dalla directory root del tuo progetto Flutter, esegui il comando seguente per installare il plug-in Remote Config:

   flutter pub add firebase_remote_config
   

   Inoltre, come parte della configurazione di Remote Config, devi aggiungere l'SDK Firebase per Google Analytics alla tua app:

   flutter pub add firebase_analytics
   

4. Ricostruisci il tuo progetto:

   flutter run
   

5. Se utilizzi Remote Config su macOS, abilita la condivisione portachiavi in ​​Xcode.

Nota: poiché Remote Config SDK ha una dipendenza dall'API REST Remote Config, assicurati di non disabilitare tale API, che è abilitata per impostazione predefinita in un progetto tipico.

Passaggio 2: ottenere l'oggetto singleton Remote Config

Ottieni un'istanza dell'oggetto Remote Config e imposta l'intervallo di recupero minimo per consentire aggiornamenti frequenti:

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(hours: 1),
));

L'oggetto singleton viene utilizzato per archiviare i valori dei parametri predefiniti in-app, recuperare i valori dei parametri aggiornati dal back-end e controllare quando i valori recuperati vengono resi disponibili alla tua app.

Durante lo sviluppo, si consiglia di impostare un intervallo di recupero minimo relativamente basso. Per ulteriori informazioni, vedere Limitazione .

Passaggio 3: imposta i valori dei parametri predefiniti in-app

Puoi impostare i valori dei parametri predefiniti in-app nell'oggetto Remote Config, in modo che la tua app si comporti come previsto prima di connettersi al backend Remote Config e in modo che i valori predefiniti siano disponibili se non ne sono impostati nessuno nel backend.

Importante: non archiviare dati riservati nelle chiavi o nei valori dei parametri di Remote Config. I dati di Remote Config vengono crittografati durante il transito, ma gli utenti finali possono accedere a qualsiasi parametro Remote Config predefinito o recuperato disponibile per l'istanza dell'app client.

await remoteConfig.setDefaults(const {
    "example_param_1": 42,
    "example_param_2": 3.14159,
    "example_param_3": true,
    "example_param_4": "Hello, world!",
});

Passaggio 4: ottieni i valori dei parametri da utilizzare nella tua app

Ora puoi ottenere i valori dei parametri dall'oggetto Remote Config. Se imposti valori nel backend, li recuperi e quindi li attivi, tali valori saranno disponibili per la tua app. Altrimenti, ottieni i valori dei parametri in-app configurati utilizzando setDefaults() .

Per ottenere questi valori, chiama il metodo elencato di seguito che mappa il tipo di dati previsto dalla tua app, fornendo la chiave del parametro come argomento:

• getBool()
• getDouble()
• getInt()
• getString()

Passaggio 5: impostare i valori dei parametri nel backend Remote Config

Utilizzando la console Firebase o le API di backend Remote Config , puoi creare nuovi valori predefiniti lato server che sostituiscono i valori in-app in base alla logica condizionale o al targeting utente desiderato. Questa sezione descrive i passaggi della console Firebase per creare questi valori.

1. Nella console Firebase , apri il tuo progetto.
2. Selezionare Remote Config dal menu per visualizzare il dashboard Remote Config.
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 corrispondente) e puoi anche impostare valori condizionali. Per ulteriori informazioni, consulta Parametri e condizioni di configurazione remota .

Passaggio 6: recupera e attiva i valori

1. Per recuperare i valori dei parametri dal backend Remote Config, chiamare il metodo fetch() . Tutti i valori impostati nel backend vengono recuperati e archiviati nell'oggetto Remote Config.

2. Per rendere disponibili alla tua app i valori dei parametri recuperati, chiama il activate() .

   Nei casi in cui desideri recuperare e attivare valori in una chiamata, puoi utilizzare una richiesta fetchAndActivate() per recuperare valori dal backend Remote Config e renderli disponibili all'app:

   await remoteConfig.fetchAndActivate();
   

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. Per ulteriori informazioni ed esempi, vedere Strategie di caricamento di Remote Config .

Passaggio 7: ascolta gli aggiornamenti in tempo reale

Dopo aver recuperato i valori dei parametri, puoi utilizzare Remote Config in tempo reale per ascoltare gli aggiornamenti dal backend Remote Config. Remote Config in tempo reale segnala ai dispositivi collegati quando sono disponibili aggiornamenti e recupera automaticamente le modifiche dopo aver pubblicato una nuova versione di Remote Config.

Tieni presente che Remote Config in tempo reale non è disponibile per il Web.

1. Nella tua app, usa onConfigUpdated per iniziare ad ascoltare gli aggiornamenti e recuperare automaticamente eventuali nuovi valori dei parametri.

    remoteConfig.onConfigUpdated.listen((event) async {
      await remoteConfig.activate();
   
      // Use the new config values here.
    });
   

2. La prossima volta che pubblichi una nuova versione di Remote Config, i dispositivi che eseguono la tua app e sono in ascolto delle modifiche attiveranno la nuova configurazione.

Suggerimento: controlla l' esempio di Flutterfire Remote Config per un'implementazione di esempio.

Limitazione

Se un'app viene recuperata troppe volte in un breve periodo di tempo, le chiamate di recupero verranno limitate e il valore della proprietà lastFetchStatus di FirebaseRemoteConfig sarà RemoteConfigFetchStatus.throttle .

L'intervallo di recupero minimo predefinito per Remote Config è 12 ore, il che significa che le configurazioni non verranno recuperate dal backend più di una volta in una finestra di 12 ore, indipendentemente dal numero di chiamate di recupero effettivamente effettuate.

Suggerimento: a partire da Firebase SDK per Flutter v4.0.0, puoi utilizzare Remote Config in tempo reale per recuperare automaticamente i valori dei parametri aggiornati dal backend Remote Config non appena vengono pubblicati, ignorando qualsiasi impostazione dell'intervallo di recupero minimo. Per ulteriori informazioni, vedere Ascoltare gli aggiornamenti in tempo reale .

Durante lo sviluppo dell'app, se non utilizzi Remote Config in tempo reale (che consigliamo), potresti voler recuperare e attivare le configurazioni molto frequentemente (molte volte all'ora) per poter eseguire rapidamente l'iterazione mentre sviluppi e testi la tua app. Per consentire un'iterazione rapida su un progetto con un massimo di 10 sviluppatori, puoi impostare temporaneamente un intervallo di recupero minimo basso con setConfigSettings() .

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(minutes: 5),
));

Attenzione: tieni presente che questa impostazione deve essere utilizzata solo per lo sviluppo, non per un'app in esecuzione in produzione. Se stai semplicemente testando la tua app con un piccolo team di sviluppo di 10 persone, è improbabile che raggiunga i limiti di quota oraria sul lato servizio. Ma se distribuissi la tua app a migliaia di utenti di prova con un intervallo minimo di recupero molto basso, probabilmente raggiungerebbe questa quota.

Prossimi passi

Se non l'hai già fatto, esplora i casi d'uso di configurazione remota e dai un'occhiata ad alcuni dei concetti chiave e alla documentazione di strategie avanzate, tra cui:

• Gestisci versioni modello di configurazione remota
• Strategie di caricamento della configurazione