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

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

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.

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 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++.

Etapa 2: adicionar a Configuração remota ao seu app

Etapa 3: definir os valores de parâmetro 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().

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

É possível receber valores de parâmetro do objeto do recurso 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ê vai receber os valores de parâmetro configurados no app usando 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()

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 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.

Etapa 7: buscar e ativar valores

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 ActivateFetched().

Próximas etapas

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

• Gerenciar versões do modelo da Configuração remota
• Estratégias de carregamento de configuração