Usar o Configuração remota do Firebase com C++

Use o Configuração remota do Firebase para definir parâmetros no seu app e atualizar os valores na nuvem e, com isso, modificar a aparência e o comportamento do app sem a necessidade de distribuir uma atualização.

A biblioteca do Configuração remota é usada para armazenar valores padrão de parâmetros dentro do app, buscar valores atualizados de parâmetros do serviço e controlar quando os valores buscados são disponibilizados ao app. Para saber mais, consulte Estratégias de carregamento do Configuração remota.

Adicionar o Firebase ao app

Antes de usar o Configuração remota do Firebase, faça o seguinte:

  • Registre seu projeto do C++ e configure-o para usar o Firebase:

    Se o projeto em C++ já usa o Firebase, então ele já está registrado e configurado para o Firebase.

  • No arquivo build.gradle no nível do projeto, inclua o repositório Maven do Google nas seções buildscript e allprojects.

  • Adicionar o SDK do Firebase para C++ ao seu projeto em C ++.

A adição do Firebase ao projeto em C++ envolve tarefas no Console do Firebase e no projeto em C++ aberto (por exemplo, você faz o download dos arquivos de configuração do Firebase no console e os move para o projeto em C++).

Adicionar o Configuração remota ao seu app

Android

Depois de adicionar o Firebase ao app:

  1. Crie um app Firebase, transmitindo o ambiente JNI e a atividade:

    app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

  2. Inicialize a biblioteca de Configuração remota, conforme mostrado:

    ::firebase::remote_config::Initialize(app);

iOS

Depois de adicionar o Firebase ao app:

  1. Crie um app Firebase:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. Inicialize a biblioteca de Configuração remota, conforme mostrado:

    ::firebase::remote_config::Initialize(app);

Definir valores de parâmetros padrão no app

É possível definir os valores de parâmetros padrão no app por meio do objeto do configuração remota. Assim, o app se comporta de maneira previsível antes de se conectar ao back-end do configuração remota e os valores padrão estarão disponíveis, caso nenhum tenha sido definido no back-end.

  1. Defina um conjunto de valores padrão e nomes de parâmetro usando um objeto std::map<const char*, const char*> ou um objeto std::map<const char*, firebase::Variant>.
  2. Adicione esses valores ao objeto do Configuração remota usando SetDefaults().

Receber valores de parâmetros para uso no app

É possível receber valores de parâmetros do objeto do Configuração remota. Se você definir valores no back-end do Configuração remota, buscá-los e, depois, ativá-los, eles estarão disponíveis para seu app. Caso contrário, você receberá os valor de parâmetros no app configurado usando o SetDefaults().

Para ter esses valores, chame o método listado a seguir que está mapeado ao tipo de dado esperado pelo app, fornecendo a chave de parâmetro como argumento:

Conectar o app ao Console do Firebase

No Console do Firebase, adicione seu app ao projeto do Firebase.

Defina os valores de parâmetro

  1. Abra seu projeto no Console do Firebase.
  2. Selecione Configuração remota no menu para ver o painel.
  3. Defina os parâmetros com os mesmos nomes dos definidos no seu app. Para cada um, é possível definir um valor padrão (que, por fim, substituirá o valor padrão no app) e valores condicionais. Para saber mais, consulte Parâmetros e condições de Configuração remota.

Valores de busca e ativação

  1. Para recuperar os valores de parâmetros usando o back-end do Configuração remota, chame o método Fetch(). Todos os valores definidos no back-end são obtidos e armazenados em cache no objeto Configuração remota.
  2. Para disponibilizar valores de parâmetro buscados ao seu app, chame o método ActivateFetched().

Como esses valores de parâmetro atualizados afetam o comportamento e a aparência do app, ative-os quando isso não prejudicar a experiência do usuário. Por exemplo, na próxima vez em que ele abrir o app.