1. Pengantar
Dibandingkan dengan API lama FCM, FCM HTTP v1 API menyediakan model otorisasi yang lebih aman menggunakan token akses berumur pendek. Langkah-langkah untuk membuat token akses untuk FCM v1 API sangat berbeda dengan langkah-langkah untuk API lama.
Codelab ini memandu Anda melalui proses penyiapan sisi server dan klien untuk mengaktifkan pengiriman notifikasi push ke aplikasi Android menggunakan FCM HTTP v1 API. Perintah ini menyoroti langkah kunci pembuatan kredensial untuk API v1.
Informasi selengkapnya dapat ditemukan di:
Prasyarat
- Pemahaman dasar tentang pengembangan Java dan Android
Yang akan Anda pelajari
- Langkah-langkah mendetail penyiapan sisi klien dan server untuk mengaktifkan pengiriman notifikasi push ke aplikasi Android Anda menggunakan FCM HTTP v1 API
- Pembuatan kredensial untuk HTTP v1 API menggunakan akun layanan
- Mengirim pesan pengujian melalui HTTP v1 API
Yang Anda butuhkan
Versi stabil terbaru Android Studio
Salah satu perangkat berikut:
- Perangkat Android fisik yang terhubung ke komputer Anda
- Emulator Android (lihat Menjalankan aplikasi di Android Emulator)
Lingkungan pengembangan Java atau editor kode pilihan Anda
2. Penyiapan project Firebase dan aplikasi Android
Di akhir codelab, Anda akan dapat mengirim pesan ke aplikasi menggunakan Firebase Cloud Messaging. Sebelum melakukannya, Anda harus membuat project Firebase. Codelab ini juga menyediakan aplikasi Android yang berisi kode contoh untuk diintegrasikan dengan FCM.
Penyiapan project Firebase
- Ikuti "Langkah 1: Create a Firebase Project" untuk membuat project Firebase Anda sendiri untuk codelab ini.
Penyiapan aplikasi Android
Contoh aplikasi Android yang disediakan di codelab ini sudah terintegrasi dengan FCM. Setelah dimulai, modul akan mendaftar ke server FCM dan berlangganan topik. Pada langkah-langkah selanjutnya di codelab ini, Anda akan mengirim pesan topik ke topik dan aplikasi Anda akan menerimanya.
- Download contoh panduan memulai Android Firebase.
- Impor project di bagian https://github.com/firebase/quickstart-android/tree/master/messaging ke Android Studio.
- Daftarkan aplikasi di Firebase Console. Nama aplikasinya adalah
com.google.firebase.quickstart.fcm. Daftarkan aplikasi ini ke project Firebase Anda dengan mengikuti langkah-langkah di "Langkah 2: Daftarkan aplikasi ke Firebase" bagian. - Ikuti bagian 1 dari "Langkah 3: Menambahkan file konfigurasi Firebase" untuk mendownload
google-services.jsondan menambahkannya ke project Anda. Bangun dan jalankan project.
3. Menyiapkan server aplikasi
Setelah aplikasi siap, Anda harus mendownload contoh kode sisi server untuk mengirim pesan ke aplikasi menggunakan FCM v1 API. Kode ini memuat kredensial API (dijelaskan di bagian berikutnya) untuk membuat token akses. Kemudian, SDK ini akan mengirim pesan ke aplikasi Anda menggunakan pesan topik FCM.
- Impor kode server awal dengan mendownload project GitHub. "Pesan" adalah project Java berbasis Gradle dengan dependensi pada SDK firebase-admin, yang menyediakan fungsi untuk mengirim pesan.
Detail selengkapnya tentang cara kerja server aplikasi dengan FCM dapat ditemukan di dokumen Lingkungan server Anda dan FCM.
4. Mendapatkan kredensial v1
FCM HTTP v1 API menggunakan token akses berumur pendek sesuai dengan model keamanan OAuth2. Dibandingkan dengan kunci API statis yang digunakan di API lama FCM, token akses berumur pendek tidak terlalu rentan terhadap risiko kebocoran kredensial. Bagian ini menjelaskan langkah-langkah pembuatan kredensial untuk menghasilkan token akses yang digunakan dalam memanggil API.
- Siapkan akun layanan Firebase agar Firebase Admin SDK mengizinkan panggilan ke FCM API. Buka Project Settings di Firebase console dan pilih tab Service accounts. Klik Buat kunci pribadi baru untuk mendownload cuplikan konfigurasi.
- Pada project GitHub yang didownload, ganti nama file yang didownload menjadi
service-account.jsondan salin ke jalurmessaging/project. - Metode
getAccessToken()(ditampilkan di bawah) di classMessaging.javamenghasilkan token OAuth2 yang valid selama 1 jam.
private static String getAccessToken() throws IOException {
GoogleCredentials googleCredentials = GoogleCredentials.fromStream(new FileInputStream("service-account.json")).createScoped(Arrays.asList(SCOPES));
googleCredentials.refresh();
return googleCredentials.getAccessToken().getTokenValue();
}
- Ubah metode utama untuk menambahkan baris berikut:
public static void main(String[] args) throws IOException {
System.out.println(getAccessToken());
...
}
- Buka direktori pesan/ project di terminal Anda, lalu ketik:
./gradlew run -Pmessage=common-message
untuk mencetak token OAuth2.
Informasi selengkapnya dapat ditemukan di Mengizinkan permintaan kirim.
5. Mengirim pesan dengan REST API
Sekarang Anda siap untuk mengirim pesan melalui HTTP v1 API. Ikuti langkah berikut:
- Untuk menambahkan token akses ke header permintaan HTTP:
- Tambahkan token sebagai nilai header Otorisasi dalam format
Authorization: Bearer <access_token> - Buat permintaan HTTP ke FCM v1 API menggunakan curl:
curl -s -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $OAuth2_token" -H "X-GFE-SSL: yes" -d "{\"message\": {\"topic\": \"$topic_name\", \"notification\": {\"title\": \"breaking news\", \"body\": \"This is breaking news\"}}}" https://fcm.googleapis.com/v1/projects/[PROJECT_NAME]/messages:send
$topic_name di atas dapat ditemukan dalam kode aplikasi Android yang disebutkan dalam project Firebase dan penyiapan aplikasi Android. Secara default, nilainya adalah "weather".
- Setelah pesan berhasil dikirim, Anda akan melihat pop-up notifikasi di layar Anda, mirip dengan gambar di bawah ini:
6. Kesimpulan
Selamat! Anda telah berhasil menyelesaikan codelab untuk:
- Menyiapkan project Firebase
- Mengintegrasikan Firebase dengan aplikasi Android
- Membuat kredensial untuk FCM HTTP v1 API
- Mengirim pesan ke aplikasi Anda melalui FCM HTTP v1 API
Untuk menjelajahi fitur lanjutan yang ditawarkan FCM, referensi berikut berguna: