1. Sebelum memulai
Dalam codelab ini, Anda akan mempelajari cara menambahkan kemampuan untuk berinteraksi dengan pengguna, baik mereka menggunakan aplikasi Anda di latar depan maupun di latar belakang.
Prasyarat
Tidak ada
Yang akan Anda pelajari
- Menambahkan Firebase ke Aplikasi Android Anda
- Menambahkan dependensi FCM dan FIAM
- Mengirim pesan FCM pengujian ke aplikasi Anda
- Kirim pesan FIAM pengujian ke aplikasi Anda
Yang Anda butuhkan
- Android Studio 4.1
- Perangkat Android atau emulator
2. Mulai
Mendapatkan kode contoh
Clone repositori GitHub dari command line:
Mengimpor aplikasi awal
Dari Android Studio, pilih direktori codelab-fcm-and-fiam
( ). Direktori ini akan menjadi direktori yang di-clone pada langkah sebelumnya (File > Open > .../codelab-fcm-and-fiam).
Sekarang, project FcmAndFiam sudah terbuka di Android Studio. Jika Anda melihat peringatan tentang file google-services.json yang hilang, jangan khawatir. Kolom tersebut akan ditambahkan di langkah berikutnya.
3. Buat project Firebase console
Menambahkan Firebase ke project
- Buka Firebase console.
- Pilih Tambahkan project.
- Pilih atau masukkan Nama project.
- Ikuti langkah-langkah penyiapan yang tersisa di Firebase console, lalu klik Buat project (atau Tambahkan Firebase, jika Anda menggunakan project Google yang sudah ada).
- Dari layar ringkasan project baru Anda, klik ikon Android untuk meluncurkan alur kerja penyiapan.
- Masukkan nama paket codelab:
com.google.firebase.codelab.fcmandfiam
Menambahkan file google-services.json ke aplikasi Anda
Setelah menambahkan nama paket, klik Register App lalu Download google-services.json untuk mendapatkan file konfigurasi Android Firebase Anda, lalu salin file google-services.json ke direktori app
di project Anda. Setelah file didownload, Anda dapat mengklik Skip untuk langkah selanjutnya yang ditampilkan di konsol (langkah tersebut telah dilakukan untuk Anda di project build-android-start).
Menambahkan plugin google-services ke aplikasi
Plugin google-services menggunakan file google-services.json untuk mengonfigurasi aplikasi Anda agar menggunakan Firebase. Dependensi plugin google-services dan plugin itu sendiri seharusnya sudah ditambahkan ke file build level aplikasi dan project. Konfirmasi entri berikut:
build.gradle
buildscript {
...
dependencies {
...
classpath 'com.google.gms:google-services:4.3.8'
}
}
app/build.gradle
plugins {
...
id: 'com.google.gms.google-services'
}
Menambahkan dependensi
FCM dan FIAM memerlukan dependensi berikut. Dependensi ini seharusnya sudah ditambahkan ke file build level aplikasi. Pastikan dependensi berikut telah ditambahkan:
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'
}
Menyinkronkan project dengan file gradle
Untuk memastikan bahwa semua dependensi tersedia untuk aplikasi, Anda harus menyinkronkan project dengan file gradle pada tahap ini. Pilih File > Sync Project with Gradle Files dari toolbar Android Studio.
4. ID Log
Firebase Cloud Messaging dan Firebase In App Messaging menggunakan ID untuk mengirim pesan ke aplikasi. FCM menggunakan token pendaftaran dan FIAM menggunakan ID penginstalan.
- Di
MainActivity.kt
, ganti TODO dengan kode di bawah ini untuk mencatat ID yang diperlukan untuk mengirim pesan:
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)
}
}
- Hubungkan perangkat Android, lalu klik Run ( ) di toolbar Android Studio. Mengetuk tombol Log Identifiers akan mencatat token pendaftaran FCM dan ID Penginstalan Firebase ke logcat. Output-nya akan terlihat seperti ini:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
FCM registration token: emMc5LART6GV7...r0Q
5. Mengirim pesan FCM pengujian
Pesan FCM dapat dikirim dari Firebase console dan dari REST API FCM. Dalam codelab ini, kita akan menulis pesan notifikasi FCM dan mengirimkannya ke perangkat. Pesan notifikasi adalah pesan yang ditampilkan di area notifikasi sistem. Kirim pesan FCM pengujian dengan:
- Pastikan aplikasi berada di latar belakang (buka layar utama)
- Buka Firebase console, lalu pilih Cloud Messaging di navigasi sebelah kiri
- Pilih Kirim pesan pertama Anda
- Tambahkan judul dan isi pesan, lalu klik Send test message
- Tambahkan token pendaftaran FCM, lalu klik test
- Amati notifikasi tampilan di perangkat
- Mengetuk notifikasi akan membuka aplikasi
6. Kirim pesan FIAM pengujian
Firebase In App Messaging dapat dipicu sebagai akibat dari berbagai peristiwa pengguna. Pesan pengujian menggunakan peristiwa layar pembuka aplikasi untuk memicu Pesan Dalam Aplikasi. Kirim pesan FIAM pengujian dengan:
- Pastikan aplikasi berada di latar belakang (buka layar utama)
- Buka Firebase console dan pilih In-App Messaging di navigasi sebelah kiri
- Pilih Buat kampanye pertama Anda
- Pilih kampanye banner atas, lalu masukkan judul dan isi pesan
- Klik Test on device
- Tambahkan ID Penginstalan, lalu klik Uji
- Buka kembali aplikasi
- Amati pesan dalam aplikasi
7. Selamat
Selamat, Anda berhasil mengirim pesan FCM dan FIAM. Kini Anda mengetahui cara berinteraksi dengan pengguna, baik mereka menggunakan aplikasi di latar depan maupun di latar belakang.
Bacaan lebih lanjut
Langkah Selanjutnya
- Mengirim pesan ke pengguna di aplikasi Android Anda sendiri.