Comece a usar o recurso "Mensagens no app" do Firebase

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

Antes de começar

Antes de começar, adicione o Firebase ao seu projeto da Apple.

Adicionar o SDK do recurso "Mensagens no app" do Firebase ao seu projeto

Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.

  1. No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
  2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Escolha a biblioteca do Mensagens no app.
  5. Adicione a sinalização -ObjC à seção Outras sinalizações do vinculador das configurações de compilação do destino.
  6. Para usar o recurso "Mensagens no app", é necessário ativar o Google Analytics no seu projeto e adicionar o SDK do Firebase para Analytics ao app. É possível selecionar a biblioteca com ou sem o recurso de coleta de IDFAs.
  7. Quando terminar, o Xcode começará a resolução e fará o download das dependências em segundo plano automaticamente.

Agora, inicialize o SDK no seu app:

  1. Importe o módulo do Firebase na estrutura App ou UIApplicationDelegate, caso ainda não tenha feito isso:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Configure também uma instância compartilhada do FirebaseApp, normalmente no inicializador do App ou no método application(_:didFinishLaunchingWithOptions:) do delegado do app, caso ainda não tenha feito isso:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compile e execute seu aplicativo.

Enviar uma mensagem de teste

Receber o ID de instalação do app

Para economizar energia, o recurso "Mensagens no app" do Firebase 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.

O dispositivo de teste é determinado por um ID de instalação do Firebase fornecido pelo serviço de instalações do Firebase. Para encontrar o ID de instalação do aplicativo de teste, execute o aplicativo com o argumento de comando de ambiente de execução -FIRDebugEnabled:

  1. Abra seu projeto do Xcode e 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_INSTALLATION_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 a página Mensagens.
  2. Se esta for sua primeira campanha, clique em Criar sua primeira campanha.
    1. Selecione Mensagens no app do Firebase e clique em Criar.
  3. Caso contrário, na guia Campanhas, clique em Nova campanha.
    1. Selecione Mensagens no app.
  4. Digite um Título para sua primeira mensagem.
  5. Clique em Testar no dispositivo.
  6. Digite o ID de instalação do Firebase do seu app no campo Adicionar um ID de instalação.
  7. Clique em Testar para enviar a mensagem.

O Mensagens do app do Firebase envia sua notificação de teste assim que você clica em Testar. Para ver a mensagem, feche e abra novamente o app 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.