Menggunakan FCM dan FIAM untuk mengirim pesan ke pengguna

1. Sebelum memulai

Dalam codelab ini, Anda akan mempelajari cara menambahkan kemampuan untuk berinteraksi dengan pengguna, baik mereka menggunakan aplikasi Anda di latar depan maupun 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 Anda
  • Kirim pesan FIAM pengujian ke aplikasi Anda

Yang Anda butuhkan

  • Android Studio 4.1
  • Perangkat Android atau emulator

2. Mulai

Mendapatkan kode contoh

Clone repositori GitHub dari command line:

Mengimpor aplikasi awal

Dari Android Studio, pilih direktori codelab-fcm-and-fiam ( folder_android_studio_.png). Direktori ini akan menjadi direktori yang di-clone pada langkah sebelumnya (File > Open > .../codelab-fcm-and-fiam).

Sekarang, project FcmAndFiam sudah terbuka di Android Studio. Jika Anda melihat peringatan tentang file google-services.json yang hilang, jangan khawatir. Kolom tersebut akan ditambahkan di langkah berikutnya.

3. Buat 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 Buat 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 lalu 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 Skip untuk langkah selanjutnya yang ditampilkan di konsol (langkah tersebut telah dilakukan untuk Anda di project build-android-start).

Menambahkan plugin google-services ke aplikasi

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 aplikasi dan project. 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

Untuk 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. Di 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 ( eksekusi.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 REST API FCM. 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, lalu pilih Cloud Messaging di navigasi sebelah kiri
  3. Pilih Kirim pesan pertama Anda
  4. Tambahkan judul dan isi pesan, lalu klik Send test message

207ced65f5245ada.png

  1. Tambahkan token pendaftaran FCM, lalu klik test

f3556c6a8a6453fe.png

  1. Amati notifikasi tampilan di perangkat
  2. Mengetuk notifikasi akan membuka aplikasi

6. Kirim 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:

  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. Kini Anda mengetahui cara berinteraksi dengan pengguna, baik mereka menggunakan aplikasi di latar depan maupun di latar belakang.

Bacaan lebih lanjut

Langkah Selanjutnya

  • Mengirim pesan ke pengguna di aplikasi Android Anda sendiri.

Dokumen referensi