Cara menyiapkan dan menghubungkan Firebase

Menghubungkan Firebase memungkinkan aplikasi SiteTo.App Anda menerima pemberitahuan push di Android dan iOS. Ini juga memberi SiteTo.App kredensial server yang aman untuk mengirimkan satu siaran ke semua perangkat berlangganan.

Sebelum Anda mulai

Anda akan membutuhkan:

• Akun Google dengan izin untuk membuat atau mengelola a proyek Firebase
• Nama paket Android dan ID paket iOS yang digunakan oleh aplikasi SiteTo.App Anda
• Keanggotaan Program Pengembang Apple jika Anda mengatur notifikasi iOS
• Aplikasi Anda sudah disiapkan SiteTo.App

Gunakan nama paket atau ID paket yang sama persis di Firebase dan SiteTo.App. Kedua pengenal tersebut peka huruf besar-kecil, dan Firebase tidak mengizinkan Anda mengubahnya setelah aplikasi platform tersebut didaftarkan.

Pahami tiga kredensial SiteTo.App

SiteTo.App's Hubungkan → Firebase layar memiliki tiga bidang unggah:

• Konfigurasi Android — itu google-services.json file untuk aplikasi Android Firebase Anda yang terdaftar
• konfigurasi iOS — kredensial layanan Pemberitahuan Push Apple Anda masuk .p8 atau .p12 format
• Kunci Firebase Admin SDK — JSON akun layanan pribadi yang digunakan oleh server SiteTo.App untuk mengirim siaran

Kedua file JSON tidak dapat dipertukarkan. google-services.json mengonfigurasi aplikasi Android; Admin SDK JSON mengotorisasi operasi server tepercaya dan harus tetap bersifat pribadi.

Untuk iOS, Firebase juga menghasilkan GoogleService-Info.plist saat Anda mendaftarkan aplikasi. Unduh dan simpan file tersebut dengan aset proyek iOS Anda. Layar koneksi SiteTo.App Firebase saat ini meminta Anda untuk mengunggah kredensial APN, bukan plist.

1. Buat atau pilih proyek Firebase

1. 1Buka Konsol Firebase dan masuk.
2. 2Pilih proyek yang ada untuk aplikasi ini, atau pilih Buat proyek.
3. 3Ikuti petunjuknya. Google Analytics bersifat opsional untuk penyiapan pemberitahuan push.
4. 4Dari Ikhtisar proyek, memilih Tambahkan aplikasi ketika Anda siap untuk mendaftar Android dan iOS.

Gunakan satu proyek Firebase untuk kedua versi platform aplikasi yang sama. Hal ini menjaga konfigurasi Cloud Messaging dan kredensial server mereka tetap bersama.

2. Daftarkan aplikasi Android

1. 1Di dalam Ikhtisar proyek, pilih ikon Android atau pilih Tambahkan aplikasi → Android.
2. 2Masukkan nama paket Android persis yang digunakan oleh aplikasi SiteTo.App Anda, seperti com.yourcompany.yourapp.
3. 3Tambahkan nama panggilan opsional untuk membuat aplikasi lebih mudah dikenali.
4. 4Memilih Daftarkan aplikasi.
5. 5Memilih Unduh google-services.json dan pertahankan nama file aslinya.

Anda dapat mengunduh file ini lagi nanti dari Pengaturan proyek → Umum → Aplikasi Anda. Jika browser Anda menambahkan teks seperti (1) ke nama file, ganti namanya kembali menjadi google-services.json sebelum mengunggahnya ke SiteTo.App.

3. Daftarkan aplikasi iOS

1. 1Kembali ke Ikhtisar proyek dan pilih Tambahkan aplikasi → iOS+.
2. 2Masukkan ID paket persis yang digunakan oleh aplikasi iOS SiteTo.App Anda.
3. 3Tambahkan nama panggilan opsional. ID App Store dapat ditambahkan nanti jika aplikasi belum dipublikasikan.
4. 4Memilih Daftarkan aplikasi.
5. 5Unduh GoogleService-Info.plist dan menyimpannya dengan aset proyek iOS aplikasi Anda.

ID paket peka huruf besar-kecil dan tidak dapat diubah untuk aplikasi Firebase ini setelah pendaftaran. Jika tidak cocok dengan SiteTo.App, hapus registrasi aplikasi Firebase yang salah dan tambahkan yang baru dengan ID yang benar.

4. Buat kredensial APN untuk iOS

Penyiapan Android dapat melewati bagian ini. Untuk iOS, Firebase Cloud Messaging memerlukan izin untuk mengirimkan notifikasi melalui layanan Notifikasi Push Apple.

1. 1Masuk ke Pengembang Apple dan terbuka Sertifikat, Pengidentifikasi & Profil.
2. 2Memilih Kunci, lalu gunakan tombol tambah (+) untuk mendaftarkan kunci baru.
3. 3Berikan kunci nama yang dapat dikenali seperti Pemberitahuan push SiteTo.App.
4. 4Memungkinkan Layanan Pemberitahuan Push Apple (APN) dan pilih Konfigurasikan jika Apple menanyakan lingkungan atau cakupannya.
5. 5Memilih Melanjutkan, tinjau pengaturannya, dan pilih Daftar.

6. 6Unduh .p8 kunci dan simpan dengan aman.
7. 7Salin itu ID Kunci dan Pengembang Apple Anda ID tim.

Apple biasanya mengizinkan .p8 kunci pribadi untuk diunduh hanya sekali. Jika Anda kehilangannya, buatlah penggantinya daripada mencoba merekonstruksi file tersebut.

5. Unggah kredensial APN ke Firebase

1. 1Kembali ke Firebase Console dan buka proyek Anda.
2. 2Membuka Pengaturan proyek, lalu pilih Pesan Awan.
3. 3Temukan aplikasi iOS Anda di bawah Konfigurasi aplikasi Apple.
4. 4Di bawah Kunci otentikasi APN, pilih Mengunggah.
5. 5Pilih .p8 file, masukkan ID Kunci dan ID Tim yang Anda rekam, dan selesaikan pengunggahan.

Jika Anda menggunakan sertifikat APN dan bukan kunci token, ekspor sertifikat tersebut sebagai sertifikat yang dilindungi kata sandi .p12 mengajukan. SiteTo.App menerima .p8 Dan .p12, tapi a .p8 kunci biasanya lebih mudah dipelihara karena tidak kedaluwarsa setiap tahunnya.

6. Buat kunci Firebase Admin SDK

Kunci ini memungkinkan server SiteTo.App mengirim siaran notifikasi. Hasilkan dari proyek Firebase yang sama yang berisi aplikasi Android dan iOS.

1. 1Di Firebase Console, buka Pengaturan proyek.
2. 2Memilih Akun layanan.
3. 3Di SDK Admin Firebase bagian, pilih Hasilkan kunci pribadi baru.
4. 4Konfirmasikan dengan memilih Hasilkan kunci.
5. 5Simpan file JSON yang diunduh di tempat pribadi.

JSON ini adalah kredensial server pribadi. Jangan bingung dengan google-services.json, letakkan di aplikasi seluler, masukkan ke repositori, atau bagikan melalui email atau obrolan.

7. Hubungkan Firebase di SiteTo.App

1. 1Masuk ke SiteTo.App.
2. 2Buka aplikasi yang ingin Anda konfigurasi.
3. 3Di editor aplikasi, buka Menghubungkan dan pilih basis api.
4. 4Di bawah Konfigurasi Android, mengunggah google-services.json dari langkah 2.
5. 5Di bawah konfigurasi iOS, unggah .p8 atau .p12 Kredensial APN dari langkah 4.
6. 6Di bawah Kunci Firebase Admin SDK, unggah JSON akun layanan dari langkah 6.
7. 7Memilih Simpan pengaturan.

Setiap baris akan menampilkan nama file yang diunggah atau Dikonfigurasi. Pastikan ketiga kredensial milik aplikasi, proyek Firebase, dan tim pengembang Apple yang sama sebelum memulai pembangunan produksi.

Apa yang terjadi selanjutnya

SiteTo.App menyimpan kredensial Admin SDK di server dan menggunakannya untuk mengirim pesan siaran melalui Firebase Cloud Messaging. Aplikasi Android dan iOS yang terinstal berlangganan topik bersama, sehingga satu pengiriman dapat menjangkau kedua platform.

Menghubungkan Firebase tidak langsung mengirimkan notifikasi. Selesaikan penyiapan dan build aplikasi, instal build baru di perangkat sebenarnya, berikan izin notifikasi saat diminta, lalu kirim siaran pengujian.

Pemecahan masalah

Perangkat Android tidak menerima notifikasi

Konfirmasikan itu google-services.json berasal dari pendaftaran aplikasi Android dengan nama paket yang sama dengan SiteTo.App. File dari proyek Firebase lain atau varian build lain akan mengarahkan aplikasi ke pengirim yang salah.

Perangkat iOS tidak menerima notifikasi

Periksa apakah ID bundel sama persis, kredensial APN muncul di bawah Pengaturan proyek → Pesan Cloud, dan ID Kunci serta ID Timnya sudah benar. Uji pada perangkat Apple fisik dan izinkan pemberitahuan saat diminta.

SiteTo.App mengatakan file Admin SDK tidak valid

Unggah JSON akun layanan yang dihasilkan di bawah Pengaturan proyek → Akun layanan. Android google-services.json File ini juga merupakan JSON yang valid, tetapi ini bukan kredensial Admin SDK.

File diunggah, tetapi pengiriman gagal

Verifikasi bahwa kunci Admin SDK masih aktif dan termasuk dalam proyek Firebase yang sama dengan konfigurasi seluler. Jika kunci dicabut atau diekspos, buat penggantinya dan unggah di SiteTo.App.

Anda kehilangan Apple .p8 kunci

Apple tidak menyediakan unduhan kedua. Buat kunci APN baru, upload ke Firebase, lalu ganti file konfigurasi iOS di SiteTo.App.

Jaga keamanan kredensial Anda

• Perlakukan Admin SDK JSON dan APN .p8 atau .p12 file seperti kata sandi.
• Simpan kredensial pribadi di pengelola kata sandi atau rahasia.
• Jangan pernah menempatkan Admin SDK JSON di aplikasi seluler atau repositori publik.
• Gunakan kunci akun layanan khusus untuk SiteTo.App sehingga dapat dirotasi secara independen.
• Cabut dan ganti kunci pribadi apa pun yang mungkin terekspos.

Untuk petunjuk platform terbaru, lihat panduan resmi Firebase untuk menambahkan aplikasi Android, menambahkan aplikasi Apple, mengunggah kunci otentikasi APN, Dan menghasilkan kunci pribadi Admin SDK.

Tangkapan layar konsol dalam panduan ini dipilih dari Evlop Android Firebase, Evlop iOS Firebase, Evlop Apple APN, Dan SDK Admin Evlop artikel disediakan sebagai referensi visual. Firebase dan Apple mungkin memperbarui label atau tata letak halaman seiring waktu.