1. Sebelum Anda mulai
Dalam codelab ini, Anda mempelajari cara menambahkan kemampuan untuk terlibat dengan pengguna baik mereka menggunakan aplikasi Anda di latar depan atau aplikasi Anda di latar belakang.
Prasyarat
Tidak ada
Apa yang akan Anda pelajari?
- Tambahkan Firebase ke Aplikasi Android Anda
- Tambahkan dependensi FCM dan FIAM
- Kirim pesan uji FCM ke aplikasi Anda
- Kirim pesan FIAM uji ke aplikasi Anda
Apa yang Anda butuhkan?
- Android Studio 4.1
- Perangkat Android atau emulator
2. Memulai
Dapatkan kode sampel
Kloning repositori GitHub dari baris perintah:
Impor aplikasi pemula
Dari Android Studio, pilih codelab-fcm-and-fiam
( ). Itu akan menjadi yang dikloning pada langkah sebelumnya ( File > Open > .../codelab-fcm-and-fiam).
Anda sekarang harus memiliki proyek FcmAndFiam yang terbuka di Android Studio. Jika Anda melihat peringatan tentang file google-services.json yang hilang, jangan khawatir. Ini akan ditambahkan pada langkah berikutnya.
3. Buat proyek konsol Firebase
Tambahkan Firebase ke proyek
- Buka konsol Firebase .
- Pilih Tambahkan proyek .
- Pilih atau masukkan nama Proyek.
- Ikuti langkah penyiapan selanjutnya di Firebase console, lalu klik Buat proyek (atau Tambahkan Firebase, jika Anda menggunakan proyek Google yang sudah ada).
- Dari layar ikhtisar proyek baru Anda, klik ikon Android untuk meluncurkan alur kerja penyiapan.
- Masukkan nama paket codelab:
com.google.firebase.codelab.fcmandfiam
Tambahkan file google-services.json ke aplikasi Anda
Setelah menambahkan nama paket klik Daftar Aplikasi lalu Unduh google-services.json untuk mendapatkan file konfigurasi Firebase Android Anda lalu salin file google-services.json ke direktori app
di proyek Anda. Setelah file diunduh, Anda dapat mengklik Lewati untuk langkah selanjutnya yang ditampilkan di konsol (sudah dilakukan untuk Anda di proyek build-android-start).
Tambahkan plugin layanan-google ke aplikasi Anda
Plugin google-services menggunakan file google-services.json untuk mengonfigurasi aplikasi Anda agar menggunakan Firebase. Ketergantungan plugin google-services dan plugin itu sendiri seharusnya sudah ditambahkan masing-masing ke file pembangunan tingkat proyek 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'
}
Tambahkan dependensi
FCM dan FIAM memerlukan dependensi berikut. Dependensi ini seharusnya sudah ditambahkan ke file build level aplikasi. Konfirmasikan 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'
}
Sinkronkan proyek Anda dengan file gradle
Untuk memastikan bahwa semua dependensi tersedia untuk aplikasi Anda, Anda harus menyinkronkan proyek Anda dengan file gradle pada saat ini. Pilih File > Sync Project with Gradle Files dari toolbar Android Studio.
4. Pengidentifikasi Log
Firebase Cloud Messaging dan Firebase In App Messaging keduanya menggunakan pengidentifikasi untuk mengirim pesan ke aplikasi. FCM menggunakan token pendaftaran dan FIAM menggunakan ID instalasi.
- Di
MainActivity.kt
ganti TODO dengan kode di bawah ini untuk mencatat pengidentifikasi 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, dan klik Jalankan (
) di bilah alat Android Studio. Mengetuk tombol Pengidentifikasi Log akan mencatat token pendaftaran FCM dan ID Instalasi Firebase ke logcat. Outputnya akan terlihat seperti ini:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
FCM registration token: emMc5LART6GV7...r0Q
5. Kirim pesan uji FCM
Pesan FCM dapat dikirim baik dari Firebase console maupun dari FCM REST API. Dalam codelab ini kami akan membuat pesan notifikasi FCM dan mengirimkannya ke perangkat kami. Pesan notifikasi adalah pesan yang ditampilkan di area notifikasi sistem. Kirim pesan FCM uji coba dengan:
- Pastikan aplikasi ada di latar belakang (buka layar beranda)
- Buka konsol Firebase dan pilih Cloud Messaging di navigasi kiri
- Pilih Kirim pesan pertama Anda
- Tambahkan judul dan isi pesan, lalu klik Kirim pesan percobaan
- Tambahkan token pendaftaran FCM, lalu klik tes
- Amati pemberitahuan tampilan pada perangkat
- Mengetuk notifikasi akan membuka aplikasi
6. Kirim pesan uji FIAM
Firebase In App Messaging dapat dipicu sebagai akibat dari berbagai peristiwa pengguna. Pesan pengujian menggunakan peristiwa pembukaan aplikasi untuk memicu Pesan Dalam Aplikasi. Kirim pesan FIAM uji coba dengan:
- Pastikan aplikasi ada di latar belakang (buka layar beranda)
- Buka konsol Firebase dan pilih In-App Messaging di navigasi kiri
- Pilih Buat kampanye pertama Anda
- Pilih kampanye spanduk teratas dan masukkan judul dan isi pesan
- Klik Uji pada perangkat
- Tambahkan ID Instalasi dan klik Uji
- Buka kembali aplikasi
- Amati dalam pesan aplikasi
7. Selamat
Selamat, Anda telah berhasil mengirim pesan FCM dan FIAM. Sekarang Anda tahu cara berinteraksi dengan pengguna apakah mereka menggunakan aplikasi Anda di latar depan atau aplikasi Anda di latar belakang.
Bacaan lebih lanjut
Apa berikutnya
- Kirim pesan ke pengguna di aplikasi Android Anda sendiri.