Gunakan proyek Firebase Anda sendiri

Firebase adalah kumpulan layanan aplikasi dari Google: database dokumen bernama Firestore, fitur masuk, penyimpanan file, notifikasi push, dan lainnya. Jika Anda sudah punya proyek Firebase — mungkin dengan aplikasi seluler yang sudah berjalan — Anda bisa menghubungkannya ke aplikasi MonstarX dan memakai layanan-layanan itu darinya.

Anda bisa memakai Firebase untuk satu hal saja (misalnya mengirim notifikasi push ke pengguna aplikasi seluler Anda) atau menjadikan Firestore sebagai database aplikasi, sehingga aplikasi web Anda dan aplikasi Anda yang lain memakai data yang sama.

Sebelum memulai

• Proyek Firebase, dan akses ke pengaturannya di konsol Firebase.
• Untuk memungkinkan orang masuk dengan Firebase Authentication, sebuah web app yang sudah ditambahkan ke proyek Firebase tersebut.

Bagaimana cara menghubungkan Firebase?

1. Di konsol Firebase, buka Project settings → Service accounts, lalu klik Generate new private key. Sebuah file JSON akan terunduh.

2. Di MonstarX, buka proyek Anda, klik Backend di bilah atas, lalu Cloud.

3. Di Konektor, klik Hubungkan di samping Firebase.

4. Buka file JSON tadi di editor teks, salin seluruh isinya, lalu tempel ke File kunci akun layanan. MonstarX membaca ID proyek Anda dari file itu.

5. Isi kolom opsional hanya jika Anda membutuhkannya:

   • Kunci API web — dari Project settings → General → Your apps → Web app → apiKey. Hanya diperlukan agar orang bisa masuk dengan Firebase Authentication.
   • Bucket penyimpanan — hanya jika file Anda tidak berada di bucket bawaan proyek.
   • URL Realtime Database — hanya untuk Realtime Database. Firestore tidak memerlukan apa pun di sini.

   

6. Klik Hubungkan Firebase. MonstarX memeriksa kunci tersebut ke Google sebelum menyimpannya, lalu menampilkan apa yang ditemukannya di samping Terhubung — ID proyek Anda dan koleksi Firestore-nya, atau “belum ada database Firestore”.

Jika Anda menempelkan file yang salah — misalnya konfigurasi web app yang kecil, bukan kunci akun layanan — MonstarX menolaknya dan menyebutkan kolom mana yang tidak ada.

Perhatian

Kunci akun layanan bisa melakukan apa saja di proyek Firebase Anda. Tempel kunci ini hanya di formulir ini, jangan pernah di percakapan atau di kode aplikasi Anda. MonstarX menyimpannya secara terenkripsi dan hanya memakainya di server aplikasi.

Apa yang bisa dilakukan aplikasi saya dengan Firebase?

Setelah terhubung, minta fiturnya dengan bahasa sehari-hari, misalnya “kirim notifikasi push ke anggota saat sebuah kelas dibatalkan”. MonstarX membangunnya dengan Firebase:

Layanan Firebase	Yang bisa dilakukan aplikasi Anda
Firestore	Menambah, membaca, mencari, memperbarui, dan menghapus dokumen; menghitung jumlahnya
Authentication	Mendaftarkan dan memasukkan orang, mengatur ulang kata sandi, dan mengelola pengguna (memerlukan kunci API web)
Cloud Storage	Mengunggah file, mendapatkan tautan unduhnya, menampilkan daftar, dan menghapusnya
Cloud Messaging	Mengirim notifikasi push ke perangkat atau topik
Realtime Database	Membaca dan menulis data (memerlukan URL Realtime Database)

Semuanya berjalan di server aplikasi Anda, sehingga pengunjung tidak pernah melihat kunci Anda.

Bisakah Firestore menjadi database aplikasi saya?

Bisa. Setiap aplikasi dimulai dengan database milik MonstarX, tetapi Anda bisa menjadikan Firestore sebagai tempat aplikasi menyimpan datanya.

1. Hubungkan Firebase lebih dulu (lihat di atas).

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

3. Pilih Firestore (proyek Firebase Anda). Sebelum Firebase terhubung, pilihan ini bertuliskan “hubungkan Firebase terlebih dahulu” dan tidak bisa dipilih.

   

4. Jika aplikasi sudah punya data, klik Salin data yang ada untuk membawanya ke sana, lalu konfirmasi.

Sejak saat itu:

• MonstarX membangun dengan koleksi dan dokumen, bukan tabel, dan melihat koleksi Anda yang sebenarnya sebelum menulis kode — MonstarX tidak pernah mengarang kolom yang tidak ada di data Anda.
• Backend›Database menampilkan Koleksi Firestore Anda beserta dokumennya. Di sana dokumen hanya bisa dibaca; aplikasilah yang menulisnya.
• Akun tetap berada di MonstarX. Orang tetap masuk dengan cara yang sama, dan Backend›Pengguna berfungsi seperti sebelumnya. Itulah sebabnya MonstarX tetap menyimpan database-nya sendiri, bukan menghapusnya.

Untuk kembali, pilih Database MonstarX di tempat yang sama. Aplikasi kembali ke database-nya sendiri persis seperti semula.

Apa yang dilakukan Salin data yang ada?

• Setiap tabel menjadi koleksi dengan nama yang sama, dan setiap baris menjadi dokumen. ID baris menjadi ID dokumen.
• Menjalankannya lagi akan memperbarui dokumen-dokumen itu, bukan menggandakannya.
• Empat tabel fitur masuk tetap berada di database MonstarX, tempat akun disimpan.
• Fitur ini tidak menghapus apa pun, di kedua tempat.
• Aplikasi yang besar mungkin disalin bertahap. Jika muncul pesan bahwa proses dihentikan agar permintaan tetap singkat, jalankan lagi dan penyalinan berlanjut dari titik terakhir.

Perlu diketahui

• Firestore atau Supabase, tidak keduanya. Sebuah aplikasi menyimpan datanya di satu tempat. Untuk beralih dari Supabase ke Firestore, pindahkan dulu datanya kembali ke database MonstarX. Konektor Firebase sendiri tetap bisa dipakai berdampingan dengan Supabase untuk penyimpanan file, pengiriman pesan, atau fitur masuk.
• Tidak ada Firebase SDK di aplikasi Anda. MonstarX menjangkau Firebase melalui helper bawaan yang bekerja sama di pratinjau maupun di aplikasi yang sudah diterbitkan.
• Notifikasi push ke perangkat seluler memerlukan token perangkat dari aplikasi seluler Anda; MonstarX mengirim ke token yang diberikan kepada aplikasi.
• Menerbitkan ke Google Cloud Run memakai konektor yang berbeda: lihat Terbitkan ke host lain.

Pertanyaan umum

Di mana saya bisa menemukan file kunci akun layanan?

Di konsol Firebase: Project settings → Service accounts → Generate new private key. Tempel seluruh file JSON ke File kunci akun layanan.

Bisakah saya memakai Firebase hanya untuk notifikasi push?

Bisa. Menghubungkan Firebase tidak memindahkan data Anda. Aplikasi tetap memakai database MonstarX kecuali Anda memilih Firestore di Tempat aplikasi ini menyimpan datanya.

Apakah pengguna saya perlu akun baru jika saya beralih ke Firestore?

Tidak. Akun tetap berada di database MonstarX dan fitur masuk berfungsi seperti sebelumnya. Hanya data milik aplikasi yang pindah ke Firestore.

Muncul tulisan “belum ada database Firestore”. Apakah itu masalah?

Hanya jika Anda ingin memakai Firestore. Koneksi tetap berhasil, karena aplikasi mungkin hanya memerlukan penyimpanan file, fitur masuk, atau notifikasi push. Buat database Firestore di konsol Firebase untuk memakainya.

Apakah menyalin data saya menghapus sesuatu?

Tidak. Salin data yang ada hanya menambah atau memperbarui dokumen di Firestore. Database milik MonstarX dibiarkan apa adanya.

Terkait

SupabaseSimpan datanya di Postgres milik Anda sendiri sebagai gantinya.

Database aplikasi AndaDatabase yang dimiliki setiap aplikasi sejak awal.

KonektorSemua layanan yang bisa dihubungkan ke aplikasi Anda.

Akun penggunaCara kerja pendaftaran dan fitur masuk di aplikasi Anda.