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 12.2 ou posterior: o Mensagens no app do Firebase 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 mais recentes: 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 framework do SDK de Mensagens no app do Firebase ao incluir o CocoaPods do recurso:
- Abra uma nova janela do terminal e navegue até o diretório do projeto Xcode.
- 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
- A partir do seu terminal, instale as dependências do pod:
pod install
- Abra o projeto do seu aplicativo no Xcode:
open YOUR-PROJECT.xcworkspace
- Importe o módulo do Firebase no seu
UIApplicationDelegate
, caso ainda não tenha feito isso:Swift
import Firebase
Objective-C
@import Firebase;
- Configure também uma instância compartilhada
FirebaseApp
, normalmente no métodoapplication: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];
- Compile e execute seu aplicativo.
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_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:
- 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.