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

Instale e inicialize os SDKs do Firebase para Flutter, caso ainda não tenha feito isso.

Adicionar o SDK de Mensagens no app ao seu projeto

  1. No diretório raiz do projeto do Flutter, execute o seguinte comando para instalar o plug-in do recurso Mensagens no app do Firebase:

    flutter pub add firebase_in_app_messaging
    
  2. Recriar o projeto:

    flutter run
    
  3. Importar o plug-in do Mensagens no app do Firebase:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
    

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.

Este dispositivo de teste é determinado por um FID. Para encontrar o FID do app de teste, verifique a saída do console ao executá-lo.

No Android, a mensagem é semelhante a esta:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

No iOS, 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 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 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 seu 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 uma das mensagens de registro a seguir.

Android

I/FIAM.Headless: Setting this device as a test device

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.