Primeiros passos com o recurso Mensagens no app do Firebase

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

Antes de começar

Antes de começar, adicione o Firebase ao seu projeto para 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.

No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas da Apple:

  https://github.com/firebase/firebase-ios-sdk

Escolha a biblioteca do Mensagens no app.
Para usar o Mensagens no app, é necessário ativar o Google Analytics no seu projeto do Firebase e adicionar o SDK do Firebase para Analytics ao seu app. Você pode selecionar a biblioteca com ou sem o recurso de coleta de IDFAs.
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:

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;
```
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];
```
Compile e execute seu aplicativo.

Observação: o Mensagens no app do Firebase requer o Firebase 5.6.0 ou versões posteriores. Se você estiver com problemas para compilar seu app, tente executar pod update no diretório do projeto do app. No entanto, lembre-se de que o comando atualiza todas as dependências do aplicativo, não apenas as do Firebase.

Enviar uma mensagem de teste

Receber o ID de instalação do app

Para economizar energia, o recurso de 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.

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

Com seu projeto do Xcode aberto, selecione Produto > Esquema > Editar esquema… na barra de menu superior.
Abra a guia Argumentos da caixa de diálogo mostrada.
Clique em + Adicionar itens em Argumentos transmitidos na inicialização.
Digite "-FIRDebugEnabled" no campo recém-criado.
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:

No Console do Firebase, abra Mensagens no app.
Clique em Nova campanha.
Digite um Título para sua primeira mensagem.
Clique em Testar no seu dispositivo.
Digite o ID de instalação do Firebase do seu app no campo Adicionar um ID de instalação.
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.