Ir para o console

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 9.2 ou posterior: o recurso de mensagens no app precisa de uma versão recente do Xcode para ser executada. 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 no site do CocoaPods (em inglês).

Adicionar o SDK de mensagens no app ao seu projeto

Para começar, adicione ao seu projeto os arquivos da biblioteca do SDK de mensagens no app 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/InAppMessagingDisplay'
    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 do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do app, se ainda não tiver:
    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

Encontre o código da instância do seu 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 FirebaseInstanceID. Para encontrar o código da instância do seu app de teste, execute o aplicativo com o argumento de comando de ambiente 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 Instance ID YOUR_APP_ID

Enviar uma mensagem para seu dispositivo de teste

Depois de lançar o aplicativo no dispositivo de teste e acessar o código da instância, teste a configuração do recurso ao enviar uma mensagem de teste:

  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. Insira o código da instância do seu aplicativo no campo Adicionar um código da instância.
  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.