Primeiros passos com a Configuração remota do Firebase

Use a Configuração remota do Firebase para definir parâmetros no app e atualizar os valores na nuvem. Dessa forma, é possível modificar a aparência e o comportamento do seu app sem distribuir uma atualização dele.

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

Adicionar o Firebase ao app

Antes de usar a Configuração remota, você precisa realizar as seguintes ações:

• 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 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 a Configuração remota ao seu app

Definir valores de parâmetros padrão no app

É possível definir os valores de parâmetros padrão no app usando o objeto da Configuração remota. Assim, o app se comporta de maneira previsível antes de se conectar ao back-end da Configuração remota, e os valores padrão vão estar 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>.

   • Saiba mais sobre firebase::Variant.

   Depois de configurar os valores de parâmetros de back-end do Configuração remota, é possível fazer o download de um arquivo que contenha esses pares de chave-valor para criar seu objeto map. Para mais informações, consulte Fazer o download dos padrões do modelo do Configuração remota.

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

Receber valores de parâmetros para uso no app

É possível 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, depois, ativá-los, eles estarão disponíveis para seu app. Caso contrário, você receberá os valores 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:

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

Conectar o app ao Console do Firebase

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

Definir 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 do recurso Configuração remota.

Buscar e ativar valores

1. Para recuperar os valores de parâmetros usando o back-end do recurso 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 ActivateFetched().

Próximas etapas

Se ainda não tiver feito isso, veja os casos de uso do recurso Configuração remota e analise alguns dos principais conceitos e documentação de estratégias avançadas, incluindo:

• Modelos e controle de versões
• Estratégias de carregamento de configuração