O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Primeiros passos com o Configuração remota do Firebase na Web

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.

Veja neste guia as etapas para os primeiros passos e códigos de amostra, que estão disponíveis para clonagem ou download no repositório GitHub firebase/quickstart-js.

Adicionar o Configuração remota ao seu app

  1. Instale o SDK do Firebase para Web.

  2. Crie o objeto singleton do Configuração remota:

    const remoteConfig = firebase.remoteConfig();

    Esse objeto é usado para armazenar valores de parâmetros padrão no app, buscar valores de parâmetros atualizados do back-end do Configuração remota e controlar quando os valores buscados são disponibilizados ao app.

  3. Defina um intervalo de busca mínimo:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Durante o desenvolvimento, recomendamos definir um intervalo de busca mínimo relativamente baixo. Para mais informações, consulte Limitação.

Definir valores padrão de parâmetros 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.

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

Receber valores de parâmetro para uso no app

É possível receber valores de parâmetro do objeto do Configuração remota. Se posteriormente você definir valores no back-end do Configuração remota, buscá-los e ativá-los, eles estarão disponíveis para seu app. Para acessar esses valores, chame o método getValue(), fornecendo a chave de parâmetro como um argumento.

const val = remoteConfig.getValue("welcome_messsage");

Definir os valores de parâmetro

Por meio do Console do Firebase ou das APIs de back-end do Configuração remota, é possível criar novos valores padrão do lado do servidor que substituem os valores no aplicativo de acordo com a lógica condicional ou a segmentação por usuário desejadas. Veja nesta seção as etapas do Console do Firebase para criar esses valores.

  1. Abra seu projeto no Console do Firebase.
  2. Selecione Configuração remota no menu para ver o painel do recurso.
  3. Defina os parâmetros com os mesmos nomes dos definidos no seu app. Para cada um, é possível determinar um valor padrão (que possivelmente substituirá o valor padrão no app), além de valores condicionais. Para saber mais, consulte Parâmetros e condições do Configuração remota.

Buscar e ativar valores

  1. Para recuperar os valores de parâmetro usando o back-end do Configuração remota, chame o método fetch(). Todos os valores definidos no back-end são recuperados e armazenados em cache no objeto Configuração remota.
  2. Para disponibilizar esse valores de parâmetro recuperados ao aplicativo, chame o método activate().

Para casos em que você quer buscar e ativar valores em uma chamada, use fetchAndActivate() conforme mostrado neste exemplo:

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

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 o usuário abrir o app. Consulte Estratégias de carregamento do Configuração remota para mais informações e exemplos.

Limitação

Se um aplicativo fizer buscas muitas vezes em um período curto, essas chamadas de busca podem ser limitadas. Nesses casos, o SDK lança um erro FETCH_THROTTLE. Recomendamos que você veja esse erro e tente novamente no modo de espera exponencial, aguardando intervalos mais longos entre as solicitações de busca subsequentes.

Durante o desenvolvimento de apps, convém atualizar o cache com muita frequência (muitas vezes por hora) para permitir a iteração rápida à medida que você desenvolve e testa seu app. Para possibilitar a iteração rápida em um projeto com vários desenvolvedores, você pode adicionar temporariamente uma propriedade com um intervalo mínimo de busca baixo (Settings.minimumFetchIntervalMillis) no seu aplicativo.

O intervalo de busca de produção padrão e recomendado para o Configuração remota é de 12 horas, o que significa que a busca pelas configurações no back-end não acontecerá mais de uma vez em um período de 12 horas, independentemente de quantas chamadas de busca forem realmente realizadas. O intervalo mínimo de busca é determinado especificamente na seguinte ordem:

  1. O parâmetro em Settings.minimumFetchIntervalMillis.
  2. O valor padrão de 12 horas.

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: