Gunakan projek Firebase anda sendiri

Firebase ialah set perkhidmatan aplikasi daripada Google: pangkalan data dokumen yang dipanggil Firestore, log masuk, storan fail, pemberitahuan push dan banyak lagi. Jika anda sudah mempunyai projek Firebase — mungkin dengan aplikasi mudah alih sedia ada — anda boleh menyambungkannya kepada aplikasi MonstarX dan menggunakan mana-mana perkhidmatan itu daripadanya.

Anda boleh menggunakan Firebase untuk satu perkara sahaja (contohnya, menghantar pemberitahuan push kepada pengguna aplikasi mudah alih anda) atau menjadikan Firestore pangkalan data aplikasi, supaya aplikasi web anda dan aplikasi anda yang lain berkongsi data yang sama.

Sebelum anda bermula

• Projek Firebase, dan akses kepada tetapannya dalam konsol Firebase.
• Untuk melog masuk orang dengan Firebase Authentication, aplikasi web yang ditambah pada projek Firebase itu.

Bagaimanakah saya menyambungkan Firebase?

1. Dalam konsol Firebase, buka Project settings → Service accounts dan klik Generate new private key. Fail JSON akan dimuat turun.

2. Dalam MonstarX, buka projek anda dan klik Backend di bar atas, kemudian Cloud.

3. Di bawah Penyambung, klik Sambungkan di sebelah Firebase.

4. Buka fail JSON itu dalam editor teks, salin keseluruhan kandungannya, dan tampalkannya ke dalam Fail kunci akaun perkhidmatan. MonstarX membaca id projek anda daripadanya.

5. Isi medan pilihan hanya jika anda memerlukannya:

   • Kunci API web — daripada Project settings → General → Your apps → Web app → apiKey. Hanya diperlukan untuk melog masuk orang dengan Firebase Authentication.
   • Bucket storan — hanya jika fail anda tiada dalam bucket lalai projek.
   • URL Realtime Database — hanya untuk Realtime Database. Firestore tidak memerlukan apa-apa di sini.

   

6. Klik Sambungkan Firebase. MonstarX menyemak kunci itu dengan Google sebelum menyimpannya, dan memaparkan apa yang ditemuinya di sebelah Disambungkan — id projek anda dan koleksi Firestorenya, atau “belum ada pangkalan data Firestore”.

Jika anda tertampal fail yang salah — contohnya konfigurasi aplikasi web yang kecil dan bukannya kunci akaun perkhidmatan — MonstarX menolaknya dan menyatakan medan yang tiada.

Awas

Kunci akaun perkhidmatan boleh melakukan apa sahaja dalam projek Firebase anda. Tampalkannya hanya ke dalam borang ini, jangan sekali-kali dalam perbualan atau kod aplikasi anda. MonstarX menyimpannya secara tersulit dan hanya menggunakannya pada pelayan aplikasi.

Apakah yang boleh dilakukan oleh aplikasi saya dengan Firebase?

Selepas disambungkan, minta ciri itu dengan bahasa biasa, seperti “hantar pemberitahuan push kepada ahli apabila kelas dibatalkan”. MonstarX membinanya dengan Firebase:

Perkhidmatan Firebase	Apa yang boleh dilakukan oleh aplikasi anda
Firestore	Menambah, membaca, mencari, mengemas kini dan memadam dokumen; mengiranya
Authentication	Mendaftar dan melog masuk orang, menetapkan semula kata laluan, dan mengurus pengguna (memerlukan kunci API web)
Cloud Storage	Memuat naik fail, mendapatkan pautan muat turunnya, menyenaraikan dan memadamnya
Cloud Messaging	Menghantar pemberitahuan push kepada peranti atau topik
Realtime Database	Membaca dan menulis data (memerlukan URL Realtime Database)

Semuanya berjalan pada pelayan aplikasi anda, jadi pelawat tidak sekali-kali melihat kunci anda.

Bolehkah Firestore menjadi pangkalan data aplikasi saya?

Boleh. Setiap aplikasi bermula dengan pangkalan data MonstarX sendiri, tetapi anda boleh menjadikan Firestore tempat aplikasi menyimpan datanya.

1. Sambungkan Firebase dahulu (lihat di atas).

2. Dalam Backend›Cloud, cari Tempat aplikasi ini menyimpan datanya.

3. Pilih Firestore (projek Firebase anda). Sebelum Firebase disambungkan, pilihan ini memaparkan “sambung Firebase dahulu” dan tidak boleh dipilih.

   

4. Jika aplikasi sudah mempunyai data, klik Salin data sedia ada untuk membawanya ke sana, dan sahkan.

Mulai saat itu:

• MonstarX membina dengan koleksi dan dokumen dan bukannya jadual, dan meneliti koleksi sebenar anda sebelum menulis kod — ia tidak sekali-kali mereka medan yang tiada dalam data anda.
• Backend›Pangkalan data memaparkan Koleksi Firestore anda dan dokumennya. Semuanya baca sahaja di situ; aplikasi yang menulisnya.
• Akaun kekal bersama MonstarX. Orang masih log masuk seperti biasa, dan Backend›Pengguna berfungsi seperti sebelumnya. Itulah sebabnya MonstarX mengekalkan pangkalan datanya sendiri dan tidak memadamnya.

Untuk bertukar kembali, pilih Pangkalan data MonstarX di tempat yang sama. Aplikasi kembali kepada pangkalan datanya sendiri tepat seperti sebelumnya.

Apakah fungsi Salin data sedia ada?

• Setiap jadual menjadi koleksi dengan nama yang sama, dan setiap baris menjadi dokumen. Id baris menjadi id dokumen.
• Menjalankannya sekali lagi akan mengemas kini dokumen itu dan bukannya menggandakannya.
• Empat jadual log masuk kekal dalam pangkalan data MonstarX, tempat akaun disimpan.
• Ia tidak memadam apa-apa, di kedua-dua tempat.
• Aplikasi yang besar mungkin disalin secara berperingkat. Jika ia menyatakan bahawa ia berhenti untuk memastikan permintaan kekal pendek, jalankannya sekali lagi dan ia akan menyambung dari tempat ia berhenti.

Perkara yang perlu diketahui

• Firestore atau Supabase, bukan kedua-duanya. Aplikasi menyimpan datanya di satu tempat. Untuk beralih daripada Supabase ke Firestore, alihkan data kembali ke pangkalan data MonstarX dahulu. Penyambung Firebase itu sendiri masih berfungsi bersama Supabase untuk storan, pemberitahuan push atau log masuk.
• Tiada SDK Firebase dalam aplikasi anda. MonstarX mencapai Firebase melalui pembantu terbina dalam yang berfungsi sama dalam pratonton dan aplikasi yang diterbitkan.
• Pemberitahuan push ke peranti mudah alih memerlukan token peranti daripada aplikasi mudah alih anda; MonstarX menghantar kepada token yang diberikan kepada aplikasi.
• Penerbitan ke Google Cloud Run menggunakan penyambung yang berbeza: lihat Terbitkan ke hos lain.

Soalan lazim

Di manakah saya boleh mendapatkan fail kunci akaun perkhidmatan?

Dalam konsol Firebase: Project settings → Service accounts → Generate new private key. Tampal keseluruhan fail JSON itu ke dalam Fail kunci akaun perkhidmatan.

Bolehkah saya menggunakan Firebase untuk pemberitahuan push sahaja?

Boleh. Menyambungkan Firebase tidak memindahkan data anda. Aplikasi terus menggunakan pangkalan data MonstarX melainkan anda memilih Firestore dalam Tempat aplikasi ini menyimpan datanya.

Adakah pengguna saya memerlukan akaun baharu jika saya beralih ke Firestore?

Tidak. Akaun kekal dalam pangkalan data MonstarX dan log masuk berfungsi seperti sebelumnya. Hanya data aplikasi itu sendiri yang dipindahkan ke Firestore.

Ia memaparkan “belum ada pangkalan data Firestore”. Adakah itu masalah?

Hanya jika anda mahu menggunakan Firestore. Sambungan tetap berjaya, kerana aplikasi mungkin hanya memerlukan storan, log masuk atau pemberitahuan push. Cipta pangkalan data Firestore dalam konsol Firebase untuk menggunakannya.

Adakah menyalin data saya memadam apa-apa?

Tidak. Salin data sedia ada hanya menambah atau mengemas kini dokumen dalam Firestore. Pangkalan data MonstarX sendiri dibiarkan seperti sedia ada.

Berkaitan

SupabaseSimpan data dalam Postgres anda sendiri sebagai ganti.

Pangkalan data aplikasi andaPangkalan data yang disertakan dengan setiap aplikasi.

PenyambungSetiap perkhidmatan yang boleh disambungkan kepada aplikasi anda.

Akaun penggunaCara daftar dan log masuk berfungsi dalam aplikasi anda.