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 berinteraksi 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 pengujian FCM ke aplikasi Anda
Kirim pesan uji FIAM ke aplikasi Anda

Apa yang Anda perlukan

Android Studio 4.1
Perangkat atau emulator Android

2. Memulai

Dapatkan kode sampel

Kloning repositori GitHub dari baris perintah:

Impor aplikasi awal

Dari Android Studio, pilih direktori codelab-fcm-and-fiam ( ). Ini akan menjadi yang dikloning pada langkah sebelumnya ( File > Open > .../codelab-fcm-and-fiam).

Anda sekarang seharusnya sudah membuka proyek FcmAndFiam 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 (langkah tersebut telah 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 layanan Google dan plugin itu sendiri seharusnya sudah ditambahkan ke file build tingkat proyek dan aplikasi. Konfirmasikan entri berikut:

build.gradle

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

aplikasi/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 tingkat aplikasi. Konfirmasikan dependensi berikut ditambahkan:

aplikasi/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 > Sinkronkan Proyek dengan File Gradle 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 registrasi 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 dari Firebase console dan dari FCM REST API. Dalam codelab ini kita akan membuat pesan notifikasi FCM dan mengirimkannya ke perangkat kita. Pesan notifikasi adalah pesan yang ditampilkan di area notifikasi sistem. Kirim pesan uji FCM melalui:

Pastikan aplikasi ada di latar belakang (buka layar beranda)
Buka Firebase console dan pilih Cloud Messaging di navigasi sebelah kiri
Pilih Kirim pesan pertama Anda
Tambahkan judul dan isi pesan, lalu klik Kirim pesan percobaan

Tambahkan token pendaftaran FCM, lalu klik uji

Amati tampilan notifikasi pada perangkat
Mengetuk notifikasi akan membuka aplikasi

6. Kirim pesan uji FIAM

Firebase In App Messaging dapat dipicu oleh berbagai peristiwa pengguna. Pesan pengujian menggunakan acara pembukaan aplikasi untuk memicu Pesan Dalam Aplikasi. Kirim pesan uji FIAM melalui:

Pastikan aplikasi ada di latar belakang (buka layar beranda)
Buka Firebase console 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 berhasil mengirimkan pesan FCM dan FIAM. Sekarang Anda tahu cara berinteraksi dengan pengguna, baik 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.