Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Kirim pesan percobaan ke aplikasi latar belakang

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.

  1. Buka konsol Firebase .

  2. Di tengah halaman ikhtisar proyek, klik ikon Android ( ) atau Tambahkan aplikasi untuk meluncurkan alur kerja penyiapan.

  3. Masukkan nama paket aplikasi Anda di kolom nama paket Android .

  4. (Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan sertifikat penandatanganan Debug SHA-1 .

  5. Klik Daftarkan aplikasi .

Tambahkan file konfigurasi Firebase

  1. Unduh lalu tambahkan file konfigurasi Android Firebase ( google-services.json ) ke aplikasi Anda:

    1. Klik Unduh google-services.json untuk mendapatkan file konfigurasi Android Firebase Anda.

    2. Pindahkan file konfigurasi Anda ke direktori root modul (level aplikasi) aplikasi Anda.

  2. Agar nilai dalam file konfigurasi google-services.json Anda dapat diakses oleh Firebase SDK, Anda memerlukan plugin Gradle layanan Google ( google-services ).

    1. 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.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. 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

  1. 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.1.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.0'
        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.1.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.0'
        implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
    }
    

  2. Sinkronkan proyek Android Anda dengan file Gradle.

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() :

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();
        }
    });

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()
})

Pantau pembuatan token

Callback onNewToken setiap kali token baru dibuat.

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);
}

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)
}

Setelah mendapatkan token, Anda dapat mengirimkannya ke server aplikasi dan menyimpannya menggunakan metode pilihan Anda.

Kirim pesan pemberitahuan pengujian

  1. Instal dan jalankan aplikasi di perangkat target. Di perangkat Apple, Anda harus menyetujui permintaan izin untuk menerima notifikasi jarak jauh.

  2. Pastikan aplikasi berada di latar belakang perangkat.

  3. Di konsol Firebase, buka halaman Messaging .

  4. Jika ini adalah pesan pertama Anda, pilih Buat kampanye pertama Anda .

    1. Pilih pesan Firebase Notification dan pilih Create .
  5. Jika tidak, pada tab Kampanye , pilih Kampanye baru lalu Notifikasi .

  6. Masukkan teks pesan. Semua bidang lainnya bersifat opsional.

  7. Pilih Kirim pesan percobaan dari panel kanan.

  8. Di bidang berlabel Tambahkan token pendaftaran FCM , masukkan token pendaftaran yang Anda peroleh di bagian sebelumnya dari panduan ini.

  9. 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: