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

Instale o SDK do Firebase e lembre-se de adicionar a dependência do Configuração remota ao arquivo build.gradle no nível do aplicativo durante esta etapa:

implementation 'com.google.firebase:firebase-config:16.3.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.

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 nomes e valores de parâmetro padrão 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 setDefaults(), conforme exibido no aplicativo de amostra do Guia de início rápido do Configuração remota.

Receber parameter values 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âmetros no app configurados 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:

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 parameter values a partir do serviço Configuração remota, chame o método fetch(). Todos os valores definidos nesse serviço são recuperados e armazenados no cache do objeto do Configuração remota.
  2. Para disponibilizar no app os parameter values recuperados, chame o método activateFetched().

Como esses valores de parâmetro atualizados afetam o comportamento e a aparência do seu app, ative os valores recuperados 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.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.