Neste guia de início rápido, mostramos como configurar o Firebase In-App Messaging e enviar sua primeira mensagem.
Antes de começar
Antes de começar, adicione o Firebase ao seu projeto da Apple.
Adicionar o SDK Firebase In-App Messaging 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 Apple:
- Escolha a biblioteca In-App Messaging.
- Adicione a sinalização
-ObjC
à seção Outras sinalizações do vinculador das configurações de compilação do destino. - Para usar In-App Messaging, é necessário ativar Google Analytics no seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao app. É possível selecionar a biblioteca com ou sem o recurso de coleta de IDFAs.
- Quando terminar, o Xcode começará a resolver e fazer o download das dependências em segundo plano automaticamente.
https://github.com/firebase/firebase-ios-sdk.git
Agora, inicialize o SDK no seu app:
- Importe o módulo do Firebase na estrutura
App
ouUIApplicationDelegate
, 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 doApp
ou no métodoapplication(_:didFinishLaunchingWithOptions:)
do delegado do app, caso ainda não tenha feito isso:Swift
FirebaseApp.configure()
Objective-C
[FIRApp configure];
- Compile e execute seu aplicativo.
Enviar uma mensagem de teste
Receber o ID de instalação do app
Para economizar energia, o Firebase In-App Messaging só recupera mensagens do servidor uma vez por dia. Isso pode dificultar o teste, então O console Firebase permite especificar um dispositivo de teste que mostra 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 app de teste, execute-o com a
argumento de comando do ambiente de execução -FIRDebugEnabled
:
- Abra seu projeto do Xcode e 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 de teste para testar a configuração do Firebase In-App Messaging:
- No console Firebase, abra a página Mensagens.
- Se esta for sua primeira campanha, clique em Criar sua primeira campanha.
- Selecione Mensagens no app do Firebase e clique em Criar.
- Caso contrário, na guia Campanhas, clique em Nova campanha.
- Selecione Mensagens no app.
- Digite um Título para sua primeira mensagem.
- Clique em Testar no dispositivo.
- Digite o ID de instalação do Firebase do app no Adicione um ID de instalação.
- Clique em Testar para enviar a mensagem.
O Firebase In-App Messaging envia sua mensagem 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.