Ir para o console

Tutorial do app de amostra do Configuração remota do Firebase para iOS

Neste guia, você encontra as etapas necessárias para integrar o Configuração remota com o seu app para iOS. Para saber mais sobre a Remote Config API para iOS, consulte FIRRemoteConfig.

Requisitos

Configure o projeto seguindo as instruções fornecidas em Adicionar o Firebase ao projeto do iOS.

Instalar a biblioteca de cliente

  1. Adicione a seguinte dependência ao Podfile:

    pod 'Firebase/RemoteConfig'
    

  2. Salve o arquivo e execute o seguinte comando:

    pod install
    

Isso cria um arquivo .xcworkspace para o seu app. Se necessário, use esse arquivo no desenvolvimento do aplicativo.

Criar um projeto de Configuração remota para a amostra de início rápido

Esse exemplo de início rápido mostra como usar o Configuração remota para definir a mensagem de boas-vindas do app de amostra. Antes de executá-lo, configure um projeto do Configuração remota.

No Console do Firebase, clique em Adicionar projeto e siga as instruções para Configurar um projeto do Configuração remota do Firebase com os parâmetros a seguir:

Chave do parâmetro Valor padrão Observações
welcome_message Welcome to this sample app Altere para usar uma mensagem diferente de boas-vindas.
welcome_message_caps false Defina como true para que a mensagem de boas-vindas seja exibida em maiúsculas.

Depois de configurar o projeto, execute a amostra de início rápido para ver a mensagem de boas-vindas definida no Console do Firebase. Altere os valores dos parâmetros no projeto e toque em Buscar Configuração remota nessa amostra para ver como ele funciona para atualizar um app.

Criar e executar a amostra de início rápido

  1. Faça o download da amostra de início rápido e descompacte o arquivo zip.

  2. Abra uma janela do terminal e navegue até o local do projeto de amostra. Execute pod install e abra o arquivo .xcworkspace.

  3. Crie e execute a amostra.

Como funciona

Primeiro, a amostra recebe uma instância de objeto do Configuração Remota e define o intervalo mínimo de busca para permitir atualizações frequentes:

Swift

Objective-C

Depois, um arquivo plist é utilizado para definir os valores padrão do aplicativo no exemplo:

Swift

Objective-C

Nesse momento, o exemplo busca valores do serviço do Configuração remota (e não valores em cache) e chama activateWithCompletionHandler: para disponibilizá-los ao aplicativo:

Swift

Objective-C

Agora que a mensagem de boas-vindas foi atualizada, exiba-a no app:

Swift

Objective-C

Acesse os parâmetros do Configuração remota usando as propriedades stringValue, numberValue, dataValue ou boolValue, ou os métodos do configValueForKey:.

Controle de fluxo

Se um aplicativo fizer buscas muitas vezes em um curto período, essas chamadas de busca podem ser controladas. Nesses casos, o back-end retorna FIRRemoteConfigFetchStatusThrottled. Recomendamos que você veja esse erro e tente novamente no modo de backoff exponencial, aguardando intervalos mais longos entre as solicitações de busca subsequentes.

Durante a fase de desenvolvimento e teste do app, atualize o cache várias vezes por hora para uma iteração rápida. Para acomodar a iteração rápida em um projeto com até 10 desenvolvedores, é possível adicionar temporariamente uma propriedade FIRRemoteConfigSettings com um intervalo de busca mínimo baixo (MinimumFetchInterval) no seu app.

O intervalo de busca mínimo padrão do 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 uma janela 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 fetch(long)
  2. O parâmetro em FIRRemoteConfigSettings.MinimumFetchInterval
  3. O valor padrão de 12 horas