Ir para o console

Instruções do exemplo de app do Configuração remota do Firebase para iOS

English Context Link

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 Criar novo 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, uma instância de objeto do Configuração remota é recebida, e o modo de desenvolvedor é ativado no exemplo para que o cache seja sempre atualizado:

Swift

Objective-C

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

Swift

Objective-C

Agora, uma solicitação fetchWithExpirationDuration:completionHandler: é criada na amostra para buscar os valores do serviço Configuração remota e o activateFetched é chamado para disponibilizar esses valores para o app:

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:.

Armazenar em cache e controlar o fluxo

O Configuração remota armazena os valores localmente após a primeira solicitação bem-sucedida. Por padrão, o cache expira depois de 12 horas, mas você pode alterar esse tempo em uma busca específica. Basta informar o período de validade, em segundos, para fetchWithExpirationDuration:completionHandler:. Caso os valores no cache sejam anteriores à expiração, o Configuração remota solicita valores atualizados de configuração do serviço. Se o app solicita atualizações dos valores várias vezes com o fetchWithExpirationDuration:completionHandler:, elas são limitadas e ele passa a receber valores armazenados em cache.

Durante a fase de desenvolvimento e teste do app, atualize o cache várias vezes por hora para uma iteração rápida. Se quiser acomodar a iteração rápida em um projeto com até 10 desenvolvedores, adicione temporariamente ao aplicativo um objeto FIRRemoteConfigSettings com isDeveloperModeEnabled configurado como true, alterando as configurações de armazenamento em cache do objeto FIRRemoteConfig.