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
Android
Depois de adicionar o Firebase ao app:
Crie um app Firebase, transmitindo o ambiente JNI e a atividade:
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
Inicialize a biblioteca da Configuração remota, conforme mostrado:
::firebase::remote_config::Initialize(app);
iOS+
Depois de adicionar o Firebase ao app:
Crie um app Firebase:
app = ::firebase::App::Create(::firebase::AppOptions());
Inicialize a biblioteca da 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 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.
Defina um conjunto de valores padrão e nomes de parâmetro usando um objeto
std::map<const char*, const char*>
ou um objetostd::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.- Saiba mais sobre
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:
Conectar o app ao Console do Firebase
No Console do Firebase, adicione seu app ao projeto do Firebase.
Definir os valores de parâmetro
- Abra seu projeto no Console do Firebase.
- Selecione Configuração remota no menu para ver o painel.
- 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
- 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. - 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: