1. Sebelum memulai
Dalam codelab ini, Anda akan mempelajari cara menambahkan kemampuan untuk berinteraksi dengan pengguna, baik saat mereka menggunakan aplikasi Anda di latar depan maupun saat aplikasi Anda berada di latar belakang.
Prasyarat
Tidak ada
Hal yang akan Anda pelajari
- Menambahkan Firebase ke Aplikasi Android
- Menambahkan dependensi FCM dan FIAM
- Mengirim pesan FCM pengujian ke aplikasi Anda
- Mengirim pesan FIAM pengujian 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).
Sekarang Anda akan membuka project FcmAndFiam di Android Studio. Jika Anda melihat peringatan tentang file google-services.json yang tidak ada, jangan khawatir. Data tersebut 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 Anda, 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 dapat 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 bahwa semua dependensi tersedia untuk aplikasi Anda, 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 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
- Mengamati notifikasi tampilan di perangkat
- Mengetuk notifikasi akan membuka aplikasi
6. Mengirim pesan FIAM pengujian
Firebase In-App Messaging dapat dipicu sebagai hasil dari berbagai peristiwa pengguna. Pesan pengujian menggunakan peristiwa pembukaan 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 dan masukkan judul serta isi pesan
- Klik Uji di perangkat
- Tambahkan ID Penginstalan, lalu klik Uji
- Membuka kembali aplikasi
- Mengamati 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 Berikutnya
- Mengirim pesan ke pengguna di aplikasi Android Anda sendiri.