Menggunakan FCM dan FIAM untuk mengirim pesan kepada pengguna

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.

206c7ecece550bde.pngS

Prasyarat

Tidak ada

Yang akan Anda pelajari

  • Menambahkan Firebase ke Aplikasi Android Anda
  • Menambahkan dependensi FCM dan FIAM
  • Mengirim pesan FCM pengujian ke aplikasi
  • Mengirim pesan FIAM uji ke aplikasi Anda

Yang Anda butuhkan

  • 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 ( folder_android_studio.png). Direktori tersebut akan menjadi direktori yang di-clone di 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

  1. Buka Firebase console.
  2. Pilih Tambahkan project.
  3. Pilih atau masukkan nama Project.
  4. Ikuti langkah-langkah penyiapan yang tersisa di Firebase console, lalu klik Create project (atau Tambahkan Firebase, jika Anda menggunakan project Google yang sudah ada).
  5. Dari layar ringkasan project baru Anda, klik ikon Android untuk meluncurkan alur kerja penyiapan.
  6. 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 Skip untuk langkah berikutnya yang ditampilkan di konsol (langkah-langkah tersebut telah dilakukan untuk Anda dalam 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 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

Guna 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.

  1. Dalam 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)
   }
}
  1. Hubungkan perangkat Android, lalu klik Run ( jalankan.png) 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:

  1. Pastikan aplikasi berada di latar belakang (buka layar utama)
  2. Buka Firebase console dan pilih Cloud Messaging di navigasi sebelah kiri
  3. Pilih Kirim pesan pertama Anda
  4. Tambahkan judul dan isi untuk pesan, lalu klik Kirim pesan pengujian.

207ced65f5245ada.pngS

  1. Tambahkan token pendaftaran FCM, lalu klik test

f3556c6a8a6453fe.pngS

  1. Amati notifikasi tampilan di perangkat
  2. 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 uji dengan:

  1. Pastikan aplikasi berada di latar belakang (buka layar utama)
  2. Buka Firebase console dan pilih In-App Messaging di navigasi sebelah kiri
  3. Pilih Buat kampanye pertama Anda
  4. Pilih kampanye banner atas, lalu masukkan judul dan isi pesan
  5. Klik Test on device

69f6ea5efff240d1.pngS

  1. Tambahkan ID Penginstalan, lalu klik Uji

24b101edfab47144.png

  1. Buka kembali aplikasi
  2. Amati pesan dalam aplikasi

7. Selamat

Selamat, Anda berhasil mengirim pesan FCM dan FIAM. Sekarang Anda tahu cara berinteraksi dengan pengguna, baik saat mereka menggunakan aplikasi di latar depan maupun saat aplikasi Anda berjalan di latar belakang.

Bacaan lebih lanjut

Langkah Selanjutnya

  • Mengirim pesan ke pengguna di aplikasi Android Anda sendiri.

Dokumen referensi