Esta página foi traduzida pela API Cloud Translation.

Use FCM e FIAM para enviar mensagens aos usuários

1. Antes de começar

Neste codelab, você aprenderá como adicionar a capacidade de interagir com os usuários, estejam eles usando seu app em primeiro plano ou em segundo plano.

Pré-requisitos

Nenhum

O que você aprenderá

Adicione o Firebase ao seu aplicativo Android
Adicione dependências FCM e FIAM
Envie uma mensagem de teste do FCM para seu aplicativo
Envie mensagem de teste FIAM para seu aplicativo

O que você precisará

Estúdio Android 4.1
Dispositivo ou emulador Android

2. Comece

Obtenha o código de exemplo

Clone o repositório GitHub na linha de comando:

Importe o aplicativo inicial

No Android Studio, selecione o diretório codelab-fcm-and-fiam ( ). Seria aquele clonado na etapa anterior ( Arquivo > Abrir > .../codelab-fcm-and-fiam).

Agora você deve ter o projeto FcmAndFiam aberto no Android Studio. Se você receber um aviso sobre a falta de um arquivo google-services.json, não se preocupe. Ele será adicionado na próxima etapa.

3. Crie um projeto de console do Firebase

Adicione o Firebase ao projeto

Vá para o console do Firebase .
Selecione Adicionar projeto .
Selecione ou insira um nome de projeto.
Siga as etapas de configuração restantes no console do Firebase e clique em Criar projeto (ou Adicionar Firebase, se estiver usando um projeto existente do Google).
Na tela de visão geral do seu novo projeto, clique no ícone do Android para iniciar o fluxo de trabalho de configuração.
Insira o nome do pacote do codelab: com.google.firebase.codelab.fcmandfiam

Adicione o arquivo google-services.json ao seu aplicativo

Depois de adicionar o nome do pacote, clique em Registrar aplicativo e em Baixar google-services.json para obter o arquivo de configuração do Firebase Android e copie o arquivo google-services.json para o diretório app em seu projeto. Após o download do arquivo, você pode clicar em Ignorar para as próximas etapas mostradas no console (elas já foram feitas para você no projeto build-android-start).

Adicione o plugin google-services ao seu aplicativo

O plug-in google-services usa o arquivo google-services.json para configurar seu aplicativo para usar o Firebase. A dependência do plug-in google-services e o próprio plug-in já devem ser adicionados aos arquivos de construção no nível do projeto e do aplicativo, respectivamente. Confirme as seguintes entradas:

construir.gradle

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

app/build.gradle

plugins {
  ...
  id: 'com.google.gms.google-services'
}

Adicionar dependências

FCM e FIAM exigem as seguintes dependências. Essas dependências já devem estar adicionadas ao arquivo de compilação no nível do aplicativo. Confirme se as seguintes dependências foram adicionadas:

app/build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

Sincronize seu projeto com arquivos Gradle

Para ter certeza de que todas as dependências estão disponíveis para seu aplicativo, você deve sincronizar seu projeto com arquivos gradle neste momento. Selecione Arquivo > Sincronizar projeto com arquivos Gradle na barra de ferramentas do Android Studio.

4. Identificadores de registro

Firebase Cloud Messaging e Firebase In App Messaging usam identificadores para enviar mensagens para aplicativos. O FCM usa um token de registro e o FIAM usa um ID de instalação.

Em MainActivity.kt substitua TODO pelo código abaixo para registrar os identificadores necessários para enviar mensagens:

FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}

Conecte seu dispositivo Android e clique em Executar ( )na barra de ferramentas do Android Studio. Tocar no botão Log Identifiers registrará o token de registro do FCM e o ID do Firebase Installations no logcat. A saída deve ficar assim:

D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. Enviar mensagem FCM de teste

As mensagens do FCM podem ser enviadas do console do Firebase e da API REST do FCM. Neste codelab, redigiremos uma mensagem de notificação do FCM e a enviaremos ao nosso dispositivo. Mensagens de notificação são aquelas exibidas na área de notificação do sistema. Envie uma mensagem de teste do FCM:

Certifique-se de que o aplicativo esteja em segundo plano (vá para a tela inicial)
Vá para o console do Firebase e selecione Cloud Messaging na navegação esquerda
Selecione Enviar sua primeira mensagem
Adicione um título e corpo para a mensagem e clique em Enviar mensagem de teste

Adicione o token de registro do FCM e clique em testar

Observe a notificação de exibição no dispositivo
Tocar na notificação abre o aplicativo

6. Enviar mensagem de teste FIAM

O Firebase In App Messaging pode ser acionado como resultado de vários eventos do usuário. A mensagem de teste usa o evento de abertura do aplicativo para acionar a mensagem no aplicativo. Envie uma mensagem FIAM de teste por:

Certifique-se de que o aplicativo esteja em segundo plano (vá para a tela inicial)
Vá para o console do Firebase e selecione Mensagens no aplicativo na navegação esquerda
Selecione Crie sua primeira campanha
Selecione a campanha do banner superior e insira o título e o corpo da mensagem
Clique em Testar no dispositivo

Adicione o ID de instalação e clique em Testar

Reabrir aplicativo
Observe na mensagem do aplicativo

7. Parabéns

Parabéns, você enviou mensagens FCM e FIAM com sucesso. Agora você sabe como interagir com seus usuários, estejam eles usando seu aplicativo em primeiro plano ou em segundo plano.

Leitura adicional

Qual é o próximo

Envie mensagens aos usuários em seu próprio aplicativo Android.