Lihat yang baru dari Firebase di Google I/O 2022. Pelajari lebih lanjut

Memahami proyek Firebase

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Halaman ini menawarkan ikhtisar singkat tentang beberapa konsep penting tentang proyek Firebase. Jika tersedia, ikuti tautan untuk menemukan informasi yang lebih mendetail tentang fitur, layanan, perkakas, dan praktik terbaik.

Hubungan antara proyek, aplikasi, dan produk Firebase

Proyek Firebase adalah entitas tingkat atas untuk Firebase. Dalam sebuah proyek, Anda dapat mendaftarkan aplikasi Apple, Android, atau web Anda. Setelah mendaftarkan aplikasi dengan Firebase, Anda dapat menambahkan SDK Firebase untuk sejumlah produk Firebase , seperti Analytics, Cloud Firestore, Performance Monitoring, atau Remote Config.

Pelajari informasi lebih detail tentang proses ini di panduan Memulai untuk platform Anda:
iOS+ | Android | web | Persatuan | C++ | Berkibar .

Memahami hierarki proyek Firebase

Diagram yang menunjukkan hierarki dasar proyek Firebase, termasuk proyek, aplikasi terdaftarnya, serta sumber daya dan layanan yang disediakan Diagram ini menunjukkan hierarki dasar proyek Firebase. Berikut adalah hubungan kuncinya:

  • Proyek Firebase seperti wadah untuk semua aplikasi Anda dan semua sumber daya serta layanan yang disediakan untuk proyek tersebut.

  • Proyek Firebase dapat memiliki satu atau beberapa Aplikasi Firebase yang terdaftar (misalnya, aplikasi versi iOS dan Android, atau versi aplikasi gratis dan berbayar).

  • Semua Aplikasi Firebase yang terdaftar pada proyek Firebase yang sama berbagi dan memiliki akses ke semua sumber daya dan layanan yang sama yang disediakan untuk proyek tersebut . Berikut beberapa contohnya:

    • Semua Aplikasi Firebase yang terdaftar ke proyek Firebase yang sama memiliki backend yang sama, seperti Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage, dan Cloud Functions.

    • Semua Aplikasi Firebase yang terdaftar ke proyek Firebase yang sama dikaitkan dengan properti Google Analytics yang sama, di mana setiap Aplikasi Firebase adalah aliran data terpisah di properti tersebut.

Hubungan antara proyek Firebase dan Google Cloud

Saat Anda membuat proyek Firebase baru, Anda sebenarnya membuat proyek Google Cloud di balik layar. Anda bahkan dapat membuat proyek Google Cloud terlebih dahulu, lalu menambahkan Firebase ke proyek tersebut nanti. Anda dapat menganggap proyek Google Cloud sebagai wadah virtual untuk data, kode, konfigurasi, dan layanan.

Karena proyek Firebase adalah proyek Google Cloud:

  • Anda dapat berinteraksi dengan proyek di konsol Firebase serta di Google Cloud Console dan di konsol Google API .

  • Anda dapat menggunakan produk dan API dari Firebase dan Google Cloud dalam sebuah proyek.

  • Penagihan dan izin untuk suatu proyek dibagikan di seluruh Firebase dan Google Cloud.

  • ID unik untuk suatu proyek (seperti nomor proyek dan ID proyek ) dibagikan di seluruh Firebase dan Google Cloud.

  • Menghapus proyek akan menghapusnya di seluruh Firebase dan Google Cloud.

Menyiapkan proyek Firebase dan mendaftarkan aplikasi

Anda dapat menyiapkan project Firebase dan mendaftarkan aplikasi di Firebase console (atau, untuk kasus penggunaan lanjutan, melalui Firebase Management REST API atau Firebase CLI ). Saat menyiapkan proyek dan mendaftarkan aplikasi, Anda perlu membuat beberapa keputusan organisasi dan menambahkan informasi konfigurasi khusus Firebase ke proyek lokal Anda.

Untuk aplikasi produksi, Anda perlu menyiapkan alur kerja pengembangan yang jelas, yang biasanya melibatkan penggunaan beberapa lingkungan. Tinjau dokumentasi kami tentang alur kerja pengembang , termasuk praktik terbaik umum dan pedoman keamanan umum untuk menyiapkan proyek Firebase dan mendaftarkan aplikasi untuk membuat alur kerja pengembangan Anda.

Berinteraksi dengan proyek Firebase

Selain SDK produk, Anda dapat langsung berinteraksi dengan proyek Firebase menggunakan beberapa alat dan antarmuka yang berbeda.

Konsol Firebase

Konsol Firebase menawarkan lingkungan paling kaya untuk mengelola produk, aplikasi, dan setelan tingkat proyek Firebase.

Konsol Firebase - layar ringkasan proyek

Panel sisi kiri konsol mencantumkan produk Firebase, yang diatur menurut kategori tingkat atas. Di bagian atas panel sisi kiri, akses setelan proyek dengan mengeklik . Setelan proyek mencakup integrasi , izin akses , dan penagihan .

Bagian tengah konsol menampilkan tombol yang meluncurkan alur kerja penyiapan untuk mendaftarkan berbagai jenis aplikasi. Setelah Anda mulai menggunakan Firebase, area utama konsol berubah menjadi dasbor yang menampilkan statistik produk yang Anda gunakan.

Perhatikan bahwa karena proyek Firebase juga merupakan proyek Google Cloud, Anda mungkin menemukan bahwa berbagai tugas atau produk mengharuskan Anda menggunakan Google Cloud Console, bukan Firebase console.

Firebase CLI (alat baris perintah)

Firebase juga menawarkan Firebase CLI untuk mengonfigurasi dan mengelola produk Firebase tertentu, seperti Firebase Hosting, Cloud Functions for Firebase, dan Firebase Extensions.

Setelah menginstal CLI, Anda memiliki akses ke perintah firebase global . Gunakan CLI untuk menautkan direktori aplikasi lokal Anda ke proyek Firebase , lalu terapkan versi baru konten yang dihosting Firebase atau pembaruan ke fungsi.

API REST Manajemen Firebase

Dengan menggunakan Firebase Management REST API , Anda dapat mengelola proyek Firebase secara terprogram. Misalnya, Anda dapat mendaftarkan aplikasi dengan proyek secara terprogram atau membuat daftar aplikasi yang sudah terdaftar ( iOS+ | Android | web ).

Pengidentifikasi proyek Firebase

Proyek Firebase dapat diidentifikasi di backend Firebase dan di berbagai antarmuka pengembang menggunakan pengenal yang berbeda, termasuk nama proyek , nomor proyek , dan ID proyek .

Nama proyek

Saat Anda membuat proyek, Anda memberikan nama proyek . Pengenal ini adalah nama khusus internal untuk proyek di Firebase console , Google Cloud Console , dan Firebase CLI . Nama proyek tidak ditampilkan di produk, layanan, atau sumber daya Firebase atau Google Cloud yang terlihat secara publik; itu hanya berfungsi untuk membantu Anda lebih mudah membedakan di antara beberapa proyek.

Anda dapat mengedit nama proyek kapan saja di proyek di konsol Firebase. Nama proyek ditampilkan di panel atas.

nomor proyek

Proyek Firebase (dan proyek Google Cloud yang terkait ) memiliki nomor proyek . Ini adalah pengenal kanonik unik global yang ditetapkan Google untuk proyek tersebut. Gunakan pengenal ini saat mengonfigurasi integrasi dan/atau melakukan panggilan API ke Firebase, Google, atau layanan pihak ketiga.

Anda tidak dapat mengedit nomor proyek. Jika Anda menghapus sebuah proyek, nomor proyek juga akan dihapus dan tidak akan pernah dapat digunakan lagi oleh proyek lain.

ID proyek

Proyek Firebase (dan proyek Google Cloud yang terkait ) memiliki ID proyek . Ini adalah pengenal unik yang ditentukan pengguna untuk proyek di seluruh Firebase dan Google Cloud. Saat Anda membuat proyek Firebase, Firebase secara otomatis menetapkan ID unik untuk proyek tersebut, tetapi Anda dapat mengeditnya selama penyiapan proyek. Pengidentifikasi ini umumnya harus diperlakukan sebagai alias kenyamanan untuk merujuk proyek.

File dan objek konfigurasi Firebase

Saat Anda mendaftarkan aplikasi dengan proyek Firebase, Firebase console menyediakan file konfigurasi Firebase (aplikasi Apple/Android) atau objek konfigurasi (aplikasi web) yang Anda tambahkan langsung ke direktori aplikasi lokal Anda.

  • Untuk aplikasi Apple, Anda menambahkan file konfigurasi GoogleService-Info.plist .
  • Untuk aplikasi Android, Anda menambahkan file konfigurasi google-services.json .
  • Untuk aplikasi web, Anda menambahkan objek konfigurasi Firebase.

Anda dapat memperoleh file atau objek konfigurasi Firebase aplikasi kapan saja.

File atau objek konfigurasi Firebase mengaitkan aplikasi dengan proyek Firebase tertentu dan sumber dayanya (database, keranjang penyimpanan, dll.). Konfigurasi tersebut mencakup "Opsi Firebase", yang merupakan parameter yang diperlukan oleh Firebase dan layanan Google untuk berkomunikasi dengan API server Firebase dan untuk mengaitkan data klien dengan proyek Firebase dan aplikasi Firebase. Berikut adalah "opsi Firebase" minimum yang diperlukan:

  • Kunci API : string terenkripsi sederhana yang digunakan saat memanggil API tertentu yang tidak perlu mengakses data pengguna pribadi (nilai contoh: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • ID Proyek : ID unik yang ditentukan pengguna untuk proyek di seluruh Firebase dan Google Cloud. Pengenal ini mungkin muncul di URL atau nama untuk beberapa sumber daya Firebase, tetapi umumnya harus diperlakukan sebagai alias praktis untuk merujuk proyek. (nilai contoh: myapp-project-123 )

  • ID Aplikasi ("AppID") : pengidentifikasi unik untuk aplikasi Firebase di seluruh Firebase dengan format khusus platform:

    • Aplikasi Firebase Apple: GOOGLE_APP_ID (nilai contoh: 1:1234567890:ios:321abc456def7890 )
      Ini bukan ID bundel Apple.
    • Aplikasi Firebase Android: mobilesdk_app_id (nilai contoh: 1:1234567890:android:321abc456def7890 )
      Ini bukan nama paket Android atau ID aplikasi Android.
    • Aplikasi Web Firebase: appId (nilai contoh: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Konten file atau objek konfigurasi Firebase dianggap publik, termasuk ID khusus platform aplikasi (ID paket Apple atau nama paket Android) dan nilai khusus proyek Firebase, seperti Kunci API, ID proyek, URL Realtime Database, dan Nama keranjang Penyimpanan Cloud. Karena itu, gunakan Aturan Keamanan Firebase untuk melindungi data dan file Anda di Realtime Database , Cloud Firestore , dan Cloud Storage .

Untuk proyek sumber terbuka, kami biasanya tidak menyarankan untuk menyertakan file atau objek konfigurasi Firebase aplikasi dalam kontrol sumber karena, dalam kebanyakan kasus, pengguna Anda harus membuat proyek Firebase mereka sendiri dan mengarahkan aplikasi mereka ke sumber daya Firebase mereka sendiri (melalui konfigurasi Firebase mereka sendiri file atau objek).

Batas umum untuk proyek, aplikasi, dan situs Firebase

Berikut adalah beberapa batasan umum untuk proyek, aplikasi, dan situs Firebase:

  • Jumlah proyek per akun

    • Paket harga percikan — Kuota pembuatan proyek terbatas pada jumlah proyek yang lebih rendah (biasanya sekitar 5-10).
    • Paket harga Blaze — Kuota pembuatan proyek per akun meningkat secara substansial selama akun Penagihan Cloud terkait bereputasi baik.

    Batas kuota pembuatan proyek jarang menjadi perhatian sebagian besar pengembang, tetapi jika diperlukan, Anda dapat meminta peningkatan kuota proyek .

    Perlu diketahui bahwa penghapusan proyek secara menyeluruh memerlukan waktu 30 hari dan diperhitungkan dalam kuota proyek hingga proyek tersebut dihapus sepenuhnya.

  • Jumlah aplikasi per proyek

    Firebase membatasi jumlah total Aplikasi Firebase dalam proyek Firebase menjadi 30.

    Anda harus memastikan bahwa semua Aplikasi Firebase dalam satu proyek Firebase adalah varian platform dari aplikasi yang sama dari perspektif pengguna akhir. Baca selengkapnya tentang multi-penyewaan di dokumen praktik terbaik kami.

    Pelajari lebih lanjut tentang batas aplikasi per proyek di FAQ.

  • Jumlah situs Hosting per proyek

    Fitur multisitus Firebase Hosting mendukung maksimum 36 situs per proyek.

Meluncurkan aplikasi Anda