Inizia a utilizzare Firebase Remote Config

Puoi utilizzare Firebase Remote Config per definire parametri nella tua app e aggiornarne i valori nel cloud, consentendoti di modificarne l'aspetto e comportamento della tua app senza distribuire un aggiornamento.

La libreria Remote Config viene utilizzata per archiviare i valori parametro predefiniti in-app, Recuperare i valori dei parametri aggiornati dal backend Remote Config e quando i valori recuperati vengono resi disponibili per la tua app. Per saperne di più, consulta le strategie di caricamento di Remote Config.

Passaggio 1: aggiungi Firebase alla tua app

Prima di poter utilizzare Remote Config, devi:

• Registra il tuo progetto C++ e configuralo per utilizzare Firebase.

  Se il tuo progetto C++ utilizza già Firebase, significa che è già registrato e configurato per Firebase.

• Aggiungi l'SDK Firebase C++ al tuo progetto C++.

Tieni presente che l'aggiunta di Firebase al tuo progetto C++ comporta attività sia nel Console Firebase e nel tuo progetto C++ aperto (ad esempio, scarichi di configurazione di Firebase dalla console, quindi spostali nel progetto C++).

Passaggio 2: aggiungi Remote Config alla tua app

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 l'app si comporti come previsto prima di connettersi al backend Remote Config e che i valori predefiniti siano disponibili se non sono impostati nel backend.

1. Definisci un insieme di nomi e valori dei parametri predefiniti utilizzando un std::map<const char*, const char*> oggetto o un Oggetto std::map<const char*, firebase::Variant>.

   • Scopri di più su firebase::Variant.

   Se hai già configurato Remote Config parametro di backend , puoi scaricare un file contenente queste coppie chiave/valore e utilizzare per creare il tuo oggetto map. Per saperne di più, consulta Scarica i valori predefiniti del modelloRemote Config.

2. Aggiungi questi valori all'oggetto Remote Config utilizzando SetDefaults()

Passaggio 4: recupera i valori dei parametri da utilizzare nell'app

Ora puoi ottenere i valori dei parametri dall'oggetto Remote Config. Se imposti nel backend Remote Config, li ha recuperati e poi attivati, disponibili per la tua app. Altrimenti, otterrai il parametro in-app i valori configurati utilizzando SetDefaults()

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

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

Passaggio 5: imposta i valori dei parametri

1. Nella console Firebase, apri il tuo progetto.
2. Seleziona Remote Config dal menu per visualizzare la dashboard Remote Config.
3. Definisci i parametri con gli stessi nomi di quelli definiti in la tua app. Per ogni parametro puoi impostare un valore predefinito (che alla fine sostituiscono il valore predefinito in-app) e i valori condizionali. Per saperne di più, vedi Parametri e condizioni di Remote Config.

Passaggio 6: recupera e attiva i valori

1. Per recuperare i valori dei parametri dal backend Remote Config, chiama il metodo Fetch() . Tutti i valori impostati sul backend vengono recuperati memorizzati nella cache nell'oggetto Remote Config.
2. Per rendere disponibili per la tua app i valori dei parametri recuperati, chiama ActivateFetched()

Passaggio 7: ascolta gli aggiornamenti in tempo reale

Dopo aver recuperato i valori dei parametri, puoi utilizzare Remote Config in tempo reale per resta in ascolto degli aggiornamenti dal backend Remote Config. Remote Config in tempo reale segnala ai dispositivi connessi quando sono disponibili aggiornamenti e recupera automaticamente le modifiche dopo la pubblicazione di una nuova versione di Remote Config.

Gli aggiornamenti in tempo reale sono supportati dall'SDK C++ Firebase v11.0.0+ e successive per piattaforme Android e Apple.

1. Nell'app, chiama AddOnConfigUpdateListener per iniziare a monitorare gli aggiornamenti e recuperare automaticamente i valori dei parametri nuovi o aggiornati. Le seguenti esempio rimane in ascolto degli aggiornamenti e, quando viene chiamato Activate, utilizza sono stati recuperati per visualizzare un messaggio di benvenuto aggiornato.

remote_config->AddOnConfigUpdateListener(
    [](firebase::remote_config::ConfigUpdate&& config_update,
       firebase::remote_config::RemoteConfigError remote_config_error) {
      if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
        printf("Error listening for config updates: %d", remote_config_error);
      }
      // Search the `updated_keys` set for the key "welcome_message."
      // `updated_keys` represents the keys that have changed since the last
      // fetch.
      if (std::find(config_update.updated_keys.begin(),
                    config_update.updated_keys.end(),
                    "welcome_message") != config_update.updated_keys.end()) {
        remote_config->Activate().OnCompletion(
            [&](const firebase::Future& completed_future,
               void* user_data) {
              // The key "welcome_message" was found within `updated_keys` and
              // can be activated.
              if (completed_future.error() == 0) {
                DisplayWelcomeMessage();
              } else {
                printf("Error activating config: %d", completed_future.error());
              }
            },
            nullptr);
      }
    });

La prossima volta che pubblicherai una nuova versione di Remote Config, i dispositivi che eseguono la tua app e mentre ascoltano le modifiche chiamerà config di aggiornamento del listener.

Passaggi successivi

Se non l'hai ancora fatto, consulta i Remote Config casi d'uso e dai un'occhiata ad alcuni dei concetti chiave e della documentazione sulle strategie avanzate, tra cui:

• Gestisci le versioni di Remote Config dei modelli
• Strategie di caricamento della configurazione