1. Sebelum memulai
Dalam codelab ini, Anda akan mempelajari cara menambahkan kemampuan untuk berinteraksi dengan pengguna saat mereka menggunakan aplikasi Anda di latar depan atau aplikasi Anda di latar belakang.
Prasyarat
Tidak ada
Hal yang akan Anda pelajari
- Menambahkan Firebase ke Aplikasi Android Anda
- Menambahkan dependensi FCM dan FIAM
- Mengirim pesan FCM uji ke aplikasi
- Mengirim pesan FIAM uji ke aplikasi Anda
Hal yang akan Anda perlukan
- Android Studio 4.1
- Perangkat Android atau emulator
2. Mulai
Mendapatkan kode contoh
Buat clone repositori GitHub dari command line:
Mengimpor aplikasi awal
Dari Android Studio, pilih direktori codelab-fcm-and-fiam (
). Direktori ini adalah direktori yang di-clone pada langkah sebelumnya (File > Open > .../codelab-fcm-and-fiam).
Project FcmAndFiam sekarang akan terbuka di Android Studio. Jika Anda melihat peringatan tentang file google-services.json yang hilang, jangan khawatir. Ini akan ditambahkan di langkah berikutnya.
3. Membuat 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 then Download google-services.json untuk mendapatkan file konfigurasi Android Firebase, lalu salin file google-services.json ke direktori app di project Anda. Setelah file didownload, Anda dapat mengklik Lewati untuk langkah berikutnya yang ditampilkan di konsol (langkah-langkah tersebut telah dilakukan untuk Anda di project build-android-start).
Menambahkan plugin google-services ke aplikasi Anda
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 project dan aplikasi. 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 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 semua dependensi tersedia untuk aplikasi, Anda harus menyinkronkan project dengan file gradle pada tahap ini. Pilih File > Sinkronkan Project dengan File Gradle dari toolbar Android Studio.
4. ID Log
Firebase Cloud Messaging dan Firebase In App Messaging sama-sama 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 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 Anda, 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 FCM REST API. 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 berjalan di latar belakang (buka layar utama)
- Buka Firebase console dan pilih Cloud Messaging di navigasi sebelah kiri
- Pilih Kirim pesan pertama Anda
- Tambahkan judul dan isi untuk pesan, lalu klik Kirim pesan pengujian.
- Tambahkan token pendaftaran FCM, lalu klik test
- Amati notifikasi tampilan di perangkat
- Mengetuk notifikasi akan membuka aplikasi
6. Mengirim 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 berjalan di latar belakang (buka layar utama)
- Buka Firebase console dan pilih In-App Messaging di navigasi sebelah kiri
- Pilih Buat kampanye pertama
- Pilih kampanye banner atas, lalu masukkan judul dan isi pesan
- Klik Test on device
- Tambahkan ID Penginstalan, lalu klik Uji
- Membuka kembali aplikasi
- Amati pesan dalam aplikasi
7. Selamat
Selamat, Anda telah berhasil mengirim pesan FCM dan FIAM. Sekarang Anda tahu cara berinteraksi dengan pengguna, baik saat mereka menggunakan aplikasi di latar depan maupun saat aplikasi berada di latar belakang.
Bacaan lebih lanjut
Langkah Selanjutnya
- Mengirim pesan ke pengguna di aplikasi Android Anda sendiri.