Sobre este codelab
1. Antes de começar
Neste codelab, você vai aprender a adicionar a capacidade de interagir com os usuários, seja quando eles estão usando o app em primeiro plano ou em segundo plano.
Pré-requisitos
Nenhum
O que você aprenderá
- Adicionar o Firebase ao seu app Android
- Adicionar dependências do FCM e do FIAM
- Enviar uma mensagem de teste do FCM para o app
- Enviar uma mensagem de teste da FIAM para seu app
O que é necessário
- Android Studio 4.1
- Dispositivo ou emulador Android
2. Primeiros passos
Acessar o exemplo de código
Clone o repositório do GitHub na linha de comando:
Importar o app inicial
No Android Studio, selecione o diretório codelab-fcm-and-fiam ( 
). Ele é o clonado na etapa anterior (File > Open > .../codelab-fcm-and-fiam).
Agora o projeto FcmAndFiam deve estar aberto no Android Studio. Se você receber um aviso sobre a ausência de um arquivo google-services.json, não se preocupe. Ele será adicionado na próxima etapa.
3. Criar um projeto do Console do Firebase
Adicionar o Firebase ao projeto
- Acesse o Console do Firebase.
- Selecione Adicionar projeto.
- Selecione ou digite um nome de projeto.
- Siga as demais etapas de configuração no Console do Firebase e clique em Criar projeto ou Adicionar Firebase, se estiver usando um projeto atual do Google.
- Na tela de visão geral do 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
Adicionar o arquivo google-services.json ao app
Depois de adicionar o nome do pacote, clique em Registrar app e fazer o download do google-services.json para receber o arquivo de configuração do Firebase para Android e copie o arquivo google-services.json para o diretório app no projeto. Depois que o arquivo for transferido, clique em Skip para as próximas etapas mostradas no console (elas já foram feitas para você no projeto build-android-start).
Adicionar o plug-in google-services ao app
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 plug-in em si já precisam ser adicionados aos arquivos de build do projeto e do app, respectivamente. Confirme as seguintes entradas:
build.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
O FCM e o FIAM exigem as dependências abaixo. Essas dependências já precisam ser adicionadas ao arquivo de build do app. 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'
}
Sincronizar seu projeto com arquivos do Gradle
Para garantir que todas as dependências estejam disponíveis para o app, sincronize o projeto com os arquivos do Gradle. Selecione File > Sync Project with Gradle Files na barra de ferramentas do Android Studio.
4. Identificadores de registros
O Firebase Cloud Messaging e o recurso Mensagens no app do Firebase usam identificadores para enviar mensagens aos apps. O FCM usa um token de registro, e o FIAM usa um ID de instalação.
- Em
MainActivity.kt, substitua o 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 Run (
) na barra de ferramentas do Android Studio. Tocar no botão Identificadores de registro registra o token de registro do FCM e o ID de instalações do Firebase no logcat. O resultado será semelhante a este:
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 pelo Console do Firebase e pela API REST do FCM. Neste codelab, vamos criar uma mensagem de notificação do FCM e enviá-la para nosso dispositivo. As mensagens de notificação são aquelas que aparecem na área de notificações do sistema. Envie uma mensagem FCM de teste:
- Confira se o app está em segundo plano (vá para a tela inicial)
- Acesse o console do Firebase e selecione Cloud Messaging na navegação à esquerda.
- Selecione Enviar sua primeira mensagem.
- Adicione um título e um corpo para a mensagem e clique em Enviar mensagem de teste.
- Adicione o token de registro do FCM e clique em testar.
- Observar a notificação na tela do dispositivo
- Tocar na notificação abre o app
6. Enviar mensagem de teste do FIAM
A Firebase In App Messaging pode ser acionada como resultado de vários eventos do usuário. A mensagem de teste usa o evento de abertura do app para acionar a mensagem no app. Envie uma mensagem de teste do FIAM:
- Confira se o app está em segundo plano (vá para a tela inicial)
- Acesse o Console do Firebase e selecione "Mensagens no app" 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ções e clique em Testar.
- Abrir o app novamente
- Observação na mensagem do app
7. Parabéns
Parabéns, você enviou mensagens do FCM e do FIAM. Agora você sabe como interagir com os usuários, seja quando eles estão usando o app em primeiro plano ou em segundo plano.
Leia mais
O que vem a seguir
- Envie mensagens para usuários no seu próprio app Android.