O Firebase vai estar no Google I/O em 10 de maio! Inscreva-se agora

Introdução à Configuração remota do Firebase

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.


Use a Configuração remota do Firebase para definir parâmetros no app e atualizar os respectivos valores na nuvem. Assim, você modifica a aparência e o comportamento do app sem precisar distribuir uma atualização.

A biblioteca da Configuração remota é usada para armazenar valores de parâmetro padrão no app, buscar valores de parâmetro atualizados no back-end do recurso e controlar quando eles são disponibilizados para o app. Saiba mais em Estratégias de carregamento da Configuração remota.

Etapa 1: adicionar o Firebase ao app

Antes de usar a Configuração remota, você precisa:

  • Registrar seu projeto em C++ e configurá-lo para usar o Firebase

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

  • 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 aberto em C++, como fazer o download dos arquivos de configuração do Firebase no console e mover esses arquivos para o projeto em C++.

Etapa 2: adicionar a 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 da 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 da Configuração remota, conforme mostrado:

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

Etapa 3: definir os valores de parâmetro padrão no app

Você pode definir os valores de parâmetro padrão no app no objeto da Configuração remota. Assim, o app se comporta de maneira previsível antes de se conectar ao back-end do recurso, e os valores padrão vão estar disponíveis se nenhum tiver 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>.

    Depois de configurar os valores de parâmetro do back-end da Configuração remota, faça o download de um arquivo com esses pares de chave-valor para criar seu objeto map. Para mais informações, consulte Fazer o download dos padrões do modelo da Configuração remota.

  2. Adicione esses valores ao objeto da Configuração remota usando SetDefaults().

Etapa 4: receber valores de parâmetro para uso no app

Agora você pode receber valores de parâmetro do objeto da Configuração remota. Se você definir valores no back-end da Configuração remota, buscá-los e ativá-los, eles vão estar disponíveis para o app. Caso contrário, receba os valores de parâmetro configurados no app usando SetDefaults().

Para isso, chame o método listado a seguir, que é associado ao tipo de dados esperado pelo app, fornecendo a chave de parâmetro como argumento:

Etapa 5: conectar o app no Console do Firebase

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

Etapa 6: definir os valores de parâmetro

  1. Abra seu projeto no Console do Firebase.
  2. Selecione Configuração remota no menu para explorar o painel do recurso.
  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. Saiba mais em Parâmetros e condições da Configuração remota.

Etapa 7: buscar e ativar valores

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

Próximas etapas

Se ainda não tiver feito isso, confira os casos de uso da Configuração remota, bem como alguns dos conceitos principais e a documentação de estratégias avançadas, que incluem: