Primeiros passos com o recurso de mensagens no app do Firebase

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

iOS
Android

Antes de começar

iOS

Antes de começar, é preciso que seu ambiente tenha as seguintes configurações:

  • Aplicativo com o Firebase ativado: adicione o Firebase ao seu projeto do iOS, caso ainda não tenha feito isso.
  • Xcode 9.2 ou posterior: o recurso de mensagens no app precisa de uma versão recente do Xcode para ser executada. Você pode encontrar a versão mais recente no site Xcode da Apple.
  • CocoaPods 1.4.0 ou posterior: o recurso de mensagens no app usa o CocoaPods para gerenciar as dependências no iOS. Você pode instalá-lo no site do CocoaPods.
Android

Para começar, seu aplicativo precisa atender a dois requisitos:

  • Ativação do Firebase: adicione o Firebase ao seu projeto Android, caso ainda não tenha feito isso.
  • Android SDK 16 ou posterior: verifique o build.gradle no nível do aplicativo para a minSdkVersion, que precisa ser no mínimo 16.

Adicionar o SDK de mensagens no app ao seu projeto

iOS

Para começar, adicione ao seu projeto os arquivos da biblioteca do SDK de mensagens no app ao incluir o CocoaPods do recurso:

  1. Abra uma nova janela do terminal e navegue até o diretório do projeto Xcode.
  2. 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/InAppMessagingDisplay'
    end
  3. A partir do seu terminal, instale as dependências do pod:
    pod install
  4. Abra o projeto do seu aplicativo no Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Importe o módulo do Firebase no seu UIApplicationDelegate, caso ainda não tenha feito isso:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. Configure também uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do seu aplicativo, se ainda não o fez:
    Swift
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. Compile e execute seu aplicativo.
Android

Incluir o SDK nos seus arquivos de versão

Adicione a dependência de mensagens no app ao seu build.gradle no nível do aplicativo:

// ...
dependencies {
    // ...

    // Add the In-App Messaging dependency:
    implementation 'com.google.firebase:firebase-inappmessaging-display:17.0.5'

    // Check that your Firebase dependency is up-to-date:
    implementation 'com.google.firebase:firebase-core:16.0.7'
}

Enviar uma mensagem de teste

Encontre o código da instância do seu app

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

ios

Este dispositivo de teste é determinado por um FirebaseInstanceID. Para encontrar o código da instância do seu aplicativo de teste, execute o aplicativo com o argumento de comando de tempo 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 Instance ID YOUR_APP_ID
android

Este dispositivo de teste é determinado por um FirebaseInstanceId. Para encontrar o código da instância do seu aplicativo de teste, verifique o Logcat no Android Studio no seguinte registro de nível "Info":

I/FIAM.Headless: Starting InAppMessaging runtime with Instance ID YOUR_APP_ID

Enviar uma mensagem para seu dispositivo de teste

Depois de lançar o aplicativo no dispositivo de teste e acessar o código da instância, teste a configuração do recurso ao enviar uma mensagem de teste:

  1. No Console do Firebase, abra Mensagens no app.
  2. Em seguida, clique em Nova campanha.
  3. Digite um Título para sua primeira mensagem.
  4. Clique em Testar no seu dispositivo.
  5. Insira o código da instância do seu aplicativo no campo Adicionar um código da instância.
  6. Clique em Testar para enviar a mensagem.

O recurso do Firebase de mensagens no app envia sua notificação de teste assim que você clica em Testar. Para vê-la, feche e abra novamente o aplicativo no seu dispositivo de teste.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.