Catch up on everthing we announced at this year's Firebase Summit. Learn more

Primeiros passos com o Configuração remota do Firebase

Use o Configuração remota do Firebase para definir parâmetros no seu app e atualizar os valores na nuvem, permitindo 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 de parâmetros padrão 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, 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 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âmetro 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 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

  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.

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: