Gunakan FCM dan FIAM untuk mengirim pesan ke pengguna

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.

206c7ecece550bde.png

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 ( android_studio_folder.png ). 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

  1. Buka konsol Firebase .
  2. Pilih Tambahkan proyek .
  3. Pilih atau masukkan nama Proyek.
  4. Ikuti langkah penyiapan selanjutnya di Firebase console, lalu klik Buat proyek (atau Tambahkan Firebase, jika Anda menggunakan proyek Google yang sudah ada).
  5. Dari layar ikhtisar proyek baru Anda, klik ikon Android untuk meluncurkan alur kerja penyiapan.
  6. 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.

  1. 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)
   }
}
  1. Hubungkan perangkat Android Anda, dan klik Jalankan ( eksekusi.png ) 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:

  1. Pastikan aplikasi ada di latar belakang (buka layar beranda)
  2. Buka konsol Firebase dan pilih Cloud Messaging di navigasi kiri
  3. Pilih Kirim pesan pertama Anda
  4. Tambahkan judul dan isi pesan, lalu klik Kirim pesan percobaan

207ced65f5245ada.png

  1. Tambahkan token pendaftaran FCM, lalu klik tes

f3556c6a8a6453fe.png

  1. Amati pemberitahuan tampilan pada perangkat
  2. 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:

  1. Pastikan aplikasi ada di latar belakang (buka layar beranda)
  2. Buka konsol Firebase dan pilih In-App Messaging di navigasi kiri
  3. Pilih Buat kampanye pertama Anda
  4. Pilih kampanye spanduk teratas dan masukkan judul dan isi pesan
  5. Klik Uji pada perangkat

69f6ea5efff240d1.png

  1. Tambahkan ID Instalasi dan klik Uji

24b101edfab47144.png

  1. Buka kembali aplikasi
  2. 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.

Dokumen referensi