Halaman ini diterjemahkan oleh Cloud Translation API.

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.

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.