Ir para o console

Usar o Configuração remota do Firebase no Android

Você pode usar o Firebase Configuração remota para definir parâmetros no app e atualizar os valores dele na nuvem, o que permite que você modifique a aparência e o comportamento do seu app sem distribuir uma atualização dele. Este guia mostra como usar o Configuração remota no seu app, seguindo estas etapas:

  1. Adicionar o Firebase ao seu app.
  2. Ter o objeto singleton do Configuração remota.
  3. Definir valores padrão de parâmetros dentro do app.
  4. Receber valores de parâmetros para uso no app.
  5. Definir valores de parâmetros no serviço Configuração remota (conforme necessário).
  6. Recuperar e ativar valores do serviço Configuração remota (conforme necessário).

Adicionar o Firebase ao app

  1. Adicione o Firebase ao projeto para Android, caso ainda não tenha feito isso.

  2. No arquivo build.gradle do nível do projeto, certifique-se de incluir o repositório Maven do Google nas seções buildscript e allprojects.

  3. Adicione a dependência da biblioteca Android do Configuração remota ao seu arquivo Gradle do módulo (nível do app), geralmente app/build.gradle:

    implementation 'com.google.firebase:firebase-config:17.0.0'
    

Receber o objeto singleton do Configuração remota

Use o método FirebaseRemoteConfig.getInstance() para receber o objeto singleton do Configuração remota, conforme mostrado no aplicativo de amostra do Guia de início rápido do Configuração remota (em inglês).

O objeto singleton é usado para armazenar valores de parâmetro padrão no aplicativo, recuperar valores de parâmetro atualizados do serviço e controlar quando eles são disponibilizados no aplicativo. Para saber mais, consulte Visão geral da API do Firebase Configuração remota.

Definir valores padrão de parâmetros dentro do app

É preciso definir os parameter values padrão no app no objeto do Configuração remota. Assim, o app se comporta de maneira previsível antes de recuperar valores do serviço Configuração remota:

  1. Defina um conjunto de valores e nomes padrão de parâmetro usando um objeto Map ou um arquivo de recursos XML armazenado na pasta res/xml do aplicativo. O app de amostra no guia de início rápido do Configuração remota usa um arquivo XML para definir valores e nomes de parâmetros padrão.
  2. Adicione esses valores ao objeto do Configuração remota usando setDefaultsAsync(int), conforme mostrado no aplicativo de amostra do Guia de início rápido do Configuração remota (em inglês).

Receber valores de parâmetro para uso no app

Agora, é possível receber valores de parâmetros do objeto do Configuração remota. Se você definir valores no serviço do Configuração remota, recuperar esses valores e os ativar, eles estarão disponíveis no app. Caso contrário, você recebe os valores de parâmetro no aplicativo configurados usando setDefaultsAsync(int). 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:

Definir valores de parâmetro no serviço (conforme necessário)

  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 que você definiu no app. Para cada parâmetro, você pode definir um valor padrão (que no final modificará o valor padrão correspondente dentro do app) e valores condicionais. Para saber mais, consulte Parâmetros e condições do Configuração remota.

Recuperar e ativar valores do serviço (conforme necessário)

  1. Para recuperar valores de parâmetro a partir do serviço do Configuração remota, chame o método fetch(). Todos os valores definidos nesse serviço são recuperados e armazenados do objeto do Configuração remota.
  2. Para disponibilizar os valores de parâmetros recuperados ao aplicativo, chame o método activate().

Como esses valores de parâmetro atualizados afetam o comportamento e a aparência do app, ative-os quando isso não prejudicar a experiência do usuário. Por exemplo, na próxima vez em que ele abrir o app.

Próximas etapas

Para uma visão profunda do app de amostra do início rápido do Configuração remota, consulte Instruções do app de amostra Android do Firebase Configuração remota.

Para saber como usar o Configuração remota no seu aplicativo, consulte as "Perguntas frequentes do Configuração remota" sobre como recuperar e ativar os valores de parâmetro, modo de desenvolvedor e controle de fluxo e tempo de recuperação.