Untuk memulai FCM, bangun kasus penggunaan yang paling sederhana: mengirimkan pesan notifikasi pengujian dari Notifications Composer ke perangkat pengembangan saat aplikasi berada di latar belakang perangkat. Halaman ini mencantumkan semua langkah untuk mencapainya, mulai dari penyiapan hingga verifikasi — ini mungkin mencakup langkah-langkah yang telah Anda selesaikan jika Anda telah menyiapkan aplikasi klien Android untuk FCM.
Siapkan SDK
Bagian ini mencakup tugas yang mungkin telah Anda selesaikan jika Anda telah mengaktifkan fitur Firebase lainnya untuk aplikasi Anda.
Sebelum kamu memulai
Pasang atau perbarui Android Studio ke versi terbarunya.
Pastikan proyek Anda memenuhi persyaratan berikut:
- Menargetkan API level 19 (KitKat) atau lebih tinggi
- Menggunakan Android 4.4 atau lebih tinggi
- Menggunakan Jetpack (AndroidX) , yang termasuk memenuhi persyaratan versi berikut:
-
com.android.tools.build:gradle
v3.2.1 atau lebih baru -
compileSdkVersion
28 atau lebih baru
-
Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
Perhatikan bahwa SDK Firebase dengan ketergantungan pada layanan Google Play mengharuskan perangkat atau emulator untuk memasang layanan Google Play.Masuk ke Firebase menggunakan akun Google Anda.
Jika Anda belum memiliki proyek Android dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh quickstart kami.
Buat proyek Firebase
Sebelum dapat menambahkan Firebase ke aplikasi Android, Anda perlu membuat proyek Firebase untuk terhubung ke aplikasi Android. Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase.
Daftarkan aplikasi Anda dengan Firebase
Untuk menggunakan Firebase di aplikasi Android Anda, Anda perlu mendaftarkan aplikasi Anda ke proyek Firebase Anda. Mendaftarkan aplikasi Anda sering disebut "menambahkan" aplikasi Anda ke proyek Anda.
Buka konsol Firebase .
Di tengah halaman ikhtisar proyek, klik ikon Android (
) atau Tambahkan aplikasi untuk meluncurkan alur kerja penyiapan.Masukkan nama paket aplikasi Anda di kolom nama paket Android .
Nama paket secara unik mengidentifikasi aplikasi Anda di perangkat dan di Google Play Store.
Nama paket sering disebut sebagai ID aplikasi .
Temukan nama paket aplikasi Anda di file Gradle modul (level aplikasi), biasanya
app/build.gradle
(contoh nama paket:com.yourcompany.yourproject
).Ketahuilah bahwa nilai nama paket peka huruf besar/kecil, dan tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan ke proyek Firebase Anda.
(Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan sertifikat penandatanganan Debug SHA-1 .
Nama panggilan aplikasi : Pengidentifikasi kenyamanan internal yang hanya dapat dilihat oleh Anda di konsol Firebase
Sertifikat penandatanganan debug SHA-1 : Hash SHA-1 diperlukan oleh Firebase Authentication (saat menggunakan Google Sign In atau login dengan nomor telepon ) dan Firebase Dynamic Links .
Klik Daftarkan aplikasi .
Tambahkan file konfigurasi Firebase
Unduh lalu tambahkan file konfigurasi Android Firebase (
) ke aplikasi Anda:google-services.json Klik Unduh google-services.json untuk mendapatkan file konfigurasi Android Firebase Anda.
Pindahkan file konfigurasi Anda ke direktori root modul (level aplikasi) aplikasi Anda.
File konfigurasi Firebase berisi pengidentifikasi unik namun tidak rahasia untuk proyek Anda. Untuk mempelajari lebih lanjut tentang file konfigurasi ini, kunjungi Memahami Proyek Firebase .
Anda dapat mengunduh kembali file konfigurasi Firebase Anda kapan saja.
Pastikan nama file konfigurasi tidak ditambahkan dengan karakter tambahan, seperti
(2)
.
Agar nilai dalam file konfigurasi
Anda dapat diakses oleh Firebase SDK, Anda memerlukan plugin Gradle layanan Google (google-services.json google-services
).Di file Gradle level root (level proyek) Anda (
<project>/build.gradle
), tambahkan plugin layanan Google sebagai dependensi buildscript:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // Add the dependency for the Google services Gradle plugin classpath 'com.google.gms:google-services:4.3.15' } } allprojects { ... repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } }
Dalam file Gradle modul (tingkat aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan plugin layanan Google:plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' ... }
Tambahkan Firebase SDK ke aplikasi Anda
Dalam file Gradle modul (level aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan dependensi untuk library Android Firebase Cloud Messaging. Kami merekomendasikan penggunaan Firebase Android BoM untuk mengontrol pembuatan versi library.Untuk pengalaman optimal dengan Firebase Cloud Messaging, sebaiknya aktifkan Google Analytics di proyek Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda.
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging' implementation 'com.google.firebase:firebase-analytics' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging:23.1.1' implementation 'com.google.firebase:firebase-analytics:21.2.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging-ktx' implementation 'com.google.firebase:firebase-analytics-ktx' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging-ktx:23.1.1' implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0' }
Sinkronkan proyek Android Anda dengan file Gradle.
Build Gradle yang menggunakan plugin Android Gradle (AGP) v4.2 atau yang lebih lama harus mengaktifkan dukungan Java 8. Jika tidak, project Android ini akan mengalami kegagalan build saat menambahkan Firebase SDK.
Untuk memperbaiki kegagalan build ini, Anda dapat mengikuti salah satu dari dua opsi berikut:
- Tambahkan
compileOptions
yang tercantum dari pesan kesalahan ke filebuild.gradle
tingkat aplikasi Anda. - Tingkatkan
minSdkVersion
untuk proyek Android Anda menjadi 26 atau lebih tinggi.
Pelajari lebih lanjut tentang kegagalan build ini di FAQ ini .
- Tambahkan
Akses token pendaftaran
Untuk mengirim pesan ke perangkat tertentu, Anda perlu mengetahui token pendaftaran perangkat tersebut. Karena Anda harus memasukkan token di bidang di konsol Notifications untuk menyelesaikan tutorial ini, pastikan untuk menyalin token atau menyimpannya dengan aman setelah mengambilnya.
Pada permulaan awal aplikasi Anda, FCM SDK membuat token pendaftaran untuk instance aplikasi klien. Jika Anda ingin menargetkan satu perangkat atau membuat grup perangkat, Anda harus mengakses token ini dengan memperluas FirebaseMessagingService
dan onNewToken
.
Bagian ini menjelaskan cara mengambil token dan cara memantau perubahan pada token. Karena token dapat dirotasi setelah startup awal, Anda sangat disarankan untuk mengambil token pendaftaran terbaru yang diperbarui.
Token pendaftaran dapat berubah ketika:
- Aplikasi dipulihkan di perangkat baru
- Pengguna mencopot pemasangan/memasang ulang aplikasi
- Pengguna menghapus data aplikasi.
Ambil token pendaftaran saat ini
Saat Anda perlu mengambil token saat ini, panggil FirebaseMessaging.getInstance().getToken()
:
Kotlin+KTX
FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task -> if (!task.isSuccessful) { Log.w(TAG, "Fetching FCM registration token failed", task.exception) return@OnCompleteListener } // Get new FCM registration token val token = task.result // Log and toast val msg = getString(R.string.msg_token_fmt, token) Log.d(TAG, msg) Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show() })
Java
FirebaseMessaging.getInstance().getToken() .addOnCompleteListener(new OnCompleteListener<String>() { @Override public void onComplete(@NonNull Task<String> task) { if (!task.isSuccessful()) { Log.w(TAG, "Fetching FCM registration token failed", task.getException()); return; } // Get new FCM registration token String token = task.getResult(); // Log and toast String msg = getString(R.string.msg_token_fmt, token); Log.d(TAG, msg); Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show(); } });
Pantau pembuatan token
Callback onNewToken
setiap kali token baru dibuat.
Kotlin+KTX
/** * Called if the FCM registration token is updated. This may occur if the security of * the previous token had been compromised. Note that this is called when the * FCM registration token is initially generated so this is where you would retrieve the token. */ override fun onNewToken(token: String) { Log.d(TAG, "Refreshed token: $token") // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token) }
Java
/** * There are two scenarios when onNewToken is called: * 1) When a new token is generated on initial app startup * 2) Whenever an existing token is changed * Under #2, there are three scenarios when the existing token is changed: * A) App is restored to a new device * B) User uninstalls/reinstalls the app * C) User clears app data */ @Override public void onNewToken(@NonNull String token) { Log.d(TAG, "Refreshed token: " + token); // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token); }
Setelah mendapatkan token, Anda dapat mengirimkannya ke server aplikasi dan menyimpannya menggunakan metode pilihan Anda.
Kirim pesan pemberitahuan pengujian
Instal dan jalankan aplikasi di perangkat target. Di perangkat Apple, Anda harus menyetujui permintaan izin untuk menerima notifikasi jarak jauh.
Pastikan aplikasi berada di latar belakang perangkat.
Di konsol Firebase, buka halaman Messaging .
Jika ini adalah pesan pertama Anda, pilih Buat kampanye pertama Anda .
- Pilih pesan Firebase Notification dan pilih Create .
Jika tidak, pada tab Kampanye , pilih Kampanye baru lalu Notifikasi .
Masukkan teks pesan. Semua bidang lainnya bersifat opsional.
Pilih Kirim pesan percobaan dari panel kanan.
Di bidang berlabel Tambahkan token pendaftaran FCM , masukkan token pendaftaran yang Anda peroleh di bagian sebelumnya dari panduan ini.
Pilih Tes .
Setelah Anda memilih Test , perangkat klien yang ditargetkan (dengan aplikasi di latar belakang) akan menerima notifikasi.
Untuk wawasan tentang pengiriman pesan ke aplikasi Anda, lihat dasbor pelaporan FCM , yang mencatat jumlah pesan yang dikirim dan dibuka di perangkat Apple dan Android, beserta data untuk "tayangan" (pemberitahuan yang dilihat oleh pengguna) untuk aplikasi Android.
Langkah selanjutnya
Kirim pesan ke aplikasi latar depan
Setelah Anda berhasil mengirim pesan notifikasi saat aplikasi berada di latar belakang, lihat Menerima Pesan di Aplikasi Android untuk mulai mengirim ke aplikasi latar depan.
Melampaui pesan notifikasi
Untuk melampaui pesan notifikasi dan menambahkan perilaku lain yang lebih canggih ke aplikasi Anda, lihat:
,Untuk memulai FCM, bangun kasus penggunaan yang paling sederhana: mengirimkan pesan notifikasi pengujian dari Notifications Composer ke perangkat pengembangan saat aplikasi berada di latar belakang perangkat. Halaman ini mencantumkan semua langkah untuk mencapainya, mulai dari penyiapan hingga verifikasi — ini mungkin mencakup langkah-langkah yang telah Anda selesaikan jika Anda telah menyiapkan aplikasi klien Android untuk FCM.
Siapkan SDK
Bagian ini mencakup tugas yang mungkin telah Anda selesaikan jika Anda telah mengaktifkan fitur Firebase lainnya untuk aplikasi Anda.
Sebelum kamu memulai
Pasang atau perbarui Android Studio ke versi terbarunya.
Pastikan proyek Anda memenuhi persyaratan berikut:
- Menargetkan API level 19 (KitKat) atau lebih tinggi
- Menggunakan Android 4.4 atau lebih tinggi
- Menggunakan Jetpack (AndroidX) , yang termasuk memenuhi persyaratan versi berikut:
-
com.android.tools.build:gradle
v3.2.1 atau lebih baru -
compileSdkVersion
28 atau lebih baru
-
Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
Perhatikan bahwa SDK Firebase dengan ketergantungan pada layanan Google Play mengharuskan perangkat atau emulator untuk memasang layanan Google Play.Masuk ke Firebase menggunakan akun Google Anda.
Jika Anda belum memiliki proyek Android dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh quickstart kami.
Buat proyek Firebase
Sebelum dapat menambahkan Firebase ke aplikasi Android, Anda perlu membuat proyek Firebase untuk terhubung ke aplikasi Android. Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase.
Daftarkan aplikasi Anda dengan Firebase
Untuk menggunakan Firebase di aplikasi Android Anda, Anda perlu mendaftarkan aplikasi Anda ke proyek Firebase Anda. Mendaftarkan aplikasi Anda sering disebut "menambahkan" aplikasi Anda ke proyek Anda.
Buka konsol Firebase .
Di tengah halaman ikhtisar proyek, klik ikon Android (
) atau Tambahkan aplikasi untuk meluncurkan alur kerja penyiapan.Masukkan nama paket aplikasi Anda di kolom nama paket Android .
Nama paket secara unik mengidentifikasi aplikasi Anda di perangkat dan di Google Play Store.
Nama paket sering disebut sebagai ID aplikasi .
Temukan nama paket aplikasi Anda di file Gradle modul (level aplikasi), biasanya
app/build.gradle
(contoh nama paket:com.yourcompany.yourproject
).Ketahuilah bahwa nilai nama paket peka huruf besar/kecil, dan tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan ke proyek Firebase Anda.
(Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan sertifikat penandatanganan Debug SHA-1 .
Nama panggilan aplikasi : Pengidentifikasi kenyamanan internal yang hanya dapat dilihat oleh Anda di konsol Firebase
Sertifikat penandatanganan debug SHA-1 : Hash SHA-1 diperlukan oleh Firebase Authentication (saat menggunakan Google Sign In atau login dengan nomor telepon ) dan Firebase Dynamic Links .
Klik Daftarkan aplikasi .
Tambahkan file konfigurasi Firebase
Unduh lalu tambahkan file konfigurasi Android Firebase (
) ke aplikasi Anda:google-services.json Klik Unduh google-services.json untuk mendapatkan file konfigurasi Android Firebase Anda.
Pindahkan file konfigurasi Anda ke direktori root modul (level aplikasi) aplikasi Anda.
File konfigurasi Firebase berisi pengidentifikasi unik namun tidak rahasia untuk proyek Anda. Untuk mempelajari lebih lanjut tentang file konfigurasi ini, kunjungi Memahami Proyek Firebase .
Anda dapat mengunduh kembali file konfigurasi Firebase Anda kapan saja.
Pastikan nama file konfigurasi tidak ditambahkan dengan karakter tambahan, seperti
(2)
.
Agar nilai dalam file konfigurasi
Anda dapat diakses oleh Firebase SDK, Anda memerlukan plugin Gradle layanan Google (google-services.json google-services
).Di file Gradle level root (level proyek) Anda (
<project>/build.gradle
), tambahkan plugin layanan Google sebagai dependensi buildscript:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // Add the dependency for the Google services Gradle plugin classpath 'com.google.gms:google-services:4.3.15' } } allprojects { ... repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } }
Dalam file Gradle modul (tingkat aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan plugin layanan Google:plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' ... }
Tambahkan Firebase SDK ke aplikasi Anda
Dalam file Gradle modul (level aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan dependensi untuk library Android Firebase Cloud Messaging. Kami merekomendasikan penggunaan Firebase Android BoM untuk mengontrol pembuatan versi library.Untuk pengalaman optimal dengan Firebase Cloud Messaging, sebaiknya aktifkan Google Analytics di proyek Firebase Anda dan tambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda.
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging' implementation 'com.google.firebase:firebase-analytics' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging:23.1.1' implementation 'com.google.firebase:firebase-analytics:21.2.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging-ktx' implementation 'com.google.firebase:firebase-analytics-ktx' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-messaging-ktx:23.1.1' implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0' }
Sinkronkan proyek Android Anda dengan file Gradle.
Build Gradle yang menggunakan plugin Android Gradle (AGP) v4.2 atau yang lebih lama harus mengaktifkan dukungan Java 8. Jika tidak, project Android ini akan mengalami kegagalan build saat menambahkan Firebase SDK.
Untuk memperbaiki kegagalan build ini, Anda dapat mengikuti salah satu dari dua opsi berikut:
- Tambahkan
compileOptions
yang tercantum dari pesan kesalahan ke filebuild.gradle
tingkat aplikasi Anda. - Tingkatkan
minSdkVersion
untuk proyek Android Anda menjadi 26 atau lebih tinggi.
Pelajari lebih lanjut tentang kegagalan build ini di FAQ ini .
- Tambahkan
Akses token pendaftaran
Untuk mengirim pesan ke perangkat tertentu, Anda perlu mengetahui token pendaftaran perangkat tersebut. Karena Anda harus memasukkan token di bidang di konsol Notifications untuk menyelesaikan tutorial ini, pastikan untuk menyalin token atau menyimpannya dengan aman setelah mengambilnya.
Pada permulaan awal aplikasi Anda, FCM SDK membuat token pendaftaran untuk instance aplikasi klien. Jika Anda ingin menargetkan satu perangkat atau membuat grup perangkat, Anda harus mengakses token ini dengan memperluas FirebaseMessagingService
dan onNewToken
.
Bagian ini menjelaskan cara mengambil token dan cara memantau perubahan pada token. Karena token dapat dirotasi setelah startup awal, Anda sangat disarankan untuk mengambil token pendaftaran terbaru yang diperbarui.
Token pendaftaran dapat berubah ketika:
- Aplikasi dipulihkan di perangkat baru
- Pengguna mencopot pemasangan/memasang ulang aplikasi
- Pengguna menghapus data aplikasi.
Ambil token pendaftaran saat ini
Saat Anda perlu mengambil token saat ini, panggil FirebaseMessaging.getInstance().getToken()
:
Kotlin+KTX
FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task -> if (!task.isSuccessful) { Log.w(TAG, "Fetching FCM registration token failed", task.exception) return@OnCompleteListener } // Get new FCM registration token val token = task.result // Log and toast val msg = getString(R.string.msg_token_fmt, token) Log.d(TAG, msg) Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show() })
Java
FirebaseMessaging.getInstance().getToken() .addOnCompleteListener(new OnCompleteListener<String>() { @Override public void onComplete(@NonNull Task<String> task) { if (!task.isSuccessful()) { Log.w(TAG, "Fetching FCM registration token failed", task.getException()); return; } // Get new FCM registration token String token = task.getResult(); // Log and toast String msg = getString(R.string.msg_token_fmt, token); Log.d(TAG, msg); Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show(); } });
Pantau pembuatan token
Callback onNewToken
setiap kali token baru dibuat.
Kotlin+KTX
/** * Called if the FCM registration token is updated. This may occur if the security of * the previous token had been compromised. Note that this is called when the * FCM registration token is initially generated so this is where you would retrieve the token. */ override fun onNewToken(token: String) { Log.d(TAG, "Refreshed token: $token") // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token) }
Java
/** * There are two scenarios when onNewToken is called: * 1) When a new token is generated on initial app startup * 2) Whenever an existing token is changed * Under #2, there are three scenarios when the existing token is changed: * A) App is restored to a new device * B) User uninstalls/reinstalls the app * C) User clears app data */ @Override public void onNewToken(@NonNull String token) { Log.d(TAG, "Refreshed token: " + token); // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token); }
Setelah mendapatkan token, Anda dapat mengirimkannya ke server aplikasi dan menyimpannya menggunakan metode pilihan Anda.
Kirim pesan pemberitahuan pengujian
Instal dan jalankan aplikasi di perangkat target. Di perangkat Apple, Anda harus menyetujui permintaan izin untuk menerima notifikasi jarak jauh.
Pastikan aplikasi berada di latar belakang perangkat.
Di konsol Firebase, buka halaman Messaging .
Jika ini adalah pesan pertama Anda, pilih Buat kampanye pertama Anda .
- Pilih pesan Firebase Notification dan pilih Create .
Jika tidak, pada tab Kampanye , pilih Kampanye baru lalu Notifikasi .
Masukkan teks pesan. Semua bidang lainnya bersifat opsional.
Pilih Kirim pesan percobaan dari panel kanan.
Di bidang berlabel Tambahkan token pendaftaran FCM , masukkan token pendaftaran yang Anda peroleh di bagian sebelumnya dari panduan ini.
Pilih Tes .
Setelah Anda memilih Test , perangkat klien yang ditargetkan (dengan aplikasi di latar belakang) akan menerima notifikasi.
Untuk wawasan tentang pengiriman pesan ke aplikasi Anda, lihat dasbor pelaporan FCM , yang mencatat jumlah pesan yang dikirim dan dibuka di perangkat Apple dan Android, beserta data untuk "tayangan" (pemberitahuan yang dilihat oleh pengguna) untuk aplikasi Android.
Langkah selanjutnya
Kirim pesan ke aplikasi latar depan
Setelah Anda berhasil mengirim pesan notifikasi saat aplikasi berada di latar belakang, lihat Menerima Pesan di Aplikasi Android untuk mulai mengirim ke aplikasi latar depan.
Melampaui pesan notifikasi
Untuk melampaui pesan notifikasi dan menambahkan perilaku lain yang lebih canggih ke aplikasi Anda, lihat: