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

Primeiros passos com o recurso de mensagens no app do Firebase

Veja neste guia de início rápido como configurar o recurso do Firebase de mensagens no app e enviar sua primeira mensagem.

Antes de começar

Antes de começar, é preciso configurar o ambiente com:

  • App com o Firebase ativado: adicione o Firebase ao seu projeto do iOS, caso ainda não tenha feito isso.
  • Xcode 11.0 ou posterior: o recurso do Firebase de mensagens no app precisa de uma versão recente do Xcode para ser executado. Você pode encontrar a versão mais recente no site Xcode da Apple.
  • CocoaPods 1.4.0 ou versões posteriores: o recurso de mensagens no app do Firebase usa o CocoaPods para gerenciar as dependências no iOS. É possível instalá-lo a partir do site do CocoaPods.

Adicionar o SDK de Mensagens no app do Firebase ao seu projeto

Para começar, adicione ao seu projeto os arquivos da biblioteca do SDK de Mensagens no app do Firebase ao incluir o CocoaPods do recurso:

  1. Abra uma nova janela do terminal e navegue até o diretório do projeto Xcode.
  2. Abra seu Podfile e adicione as linhas destacadas:
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. A partir do seu terminal, instale as dependências do pod:
    pod install
  4. Abra o projeto do seu aplicativo no Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Importe o módulo do Firebase no seu UIApplicationDelegate, caso ainda não tenha feito isso:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. Configure também uma instância compartilhada FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do app, caso ainda não tenha feito isso:
    Swift
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. Compile e execute seu aplicativo.

Enviar uma mensagem de teste

Receber o código de instalação do app

Para economizar energia, o recurso de mensagens no app só recupera notificações do servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o Console do Firebase permite especificar um dispositivo de teste que exibe mensagens sob demanda.

Este dispositivo de teste é determinado por um código de instalação do Firebase fornecido pelo serviço de instalações do Firebase. Para encontrar o código de instalação do aplicativo de teste, execute o aplicativo com o argumento de comando de tempo de execução -FIRDebugEnabled:

  1. Com seu projeto do Xcode aberto, selecione Produto > Esquema > Editar esquema… na barra de menu superior.
  2. Abra a guia Argumentos da caixa de diálogo mostrada.
  3. Clique em + Adicionar itens em Argumentos transmitidos na inicialização.
  4. Digite "-FIRDebugEnabled" no campo recém-criado.
  5. Clique em Fechar e execute seu aplicativo.

Depois que seu aplicativo começar a ser executado, procure a seguinte linha nos registros do console do Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID

Enviar uma mensagem para seu dispositivo de teste

Depois de iniciar o app no dispositivo de teste e receber o ID de instalação do Firebase (FID, na sigla em inglês), envie uma mensagem para testar a configuração do recurso:

  1. No Console do Firebase, abra Mensagens no app.
  2. Em seguida, clique em Nova campanha.
  3. Digite um Título para sua primeira mensagem.
  4. Clique em Testar no seu dispositivo.
  5. Digite o ID de instalação do Firebase do seu app no campo Adicionar um ID de instalação.
  6. Clique em Testar para enviar a mensagem.

O recurso do Firebase de mensagens no app envia sua notificação de teste assim que você clica em Testar. Para vê-la, feche e abra novamente o aplicativo no dispositivo de teste.

Para confirmar se o dispositivo é de teste, procure a seguinte mensagem de registro:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.