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 lebih mendetail tentang fitur, layanan, perkakas, dan praktik terbaik.

Hubungan antara proyek, aplikasi, dan produk Firebase

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

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

Memahami hierarki project Firebase

Diagram yang menunjukkan hierarki dasar project Firebase, termasuk project, aplikasi terdaftarnya, serta resource 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, versi aplikasi iOS dan Android, atau versi aplikasi gratis dan berbayar).

  • Semua Aplikasi Firebase yang terdaftar ke 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 didaftarkan 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 didaftarkan ke proyek Firebase yang sama dikaitkan dengan properti Google Analytics yang sama, dengan setiap Aplikasi Firebase merupakan aliran data terpisah di properti tersebut.

Hubungan antara proyek Firebase dan Google Cloud

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

Perhatikan bahwa untuk semua project Firebase, Firebase otomatis menambahkan label firebase:enabled dalam halaman Label untuk project Anda di Google Cloud Console. Pelajari lebih lanjut tentang label ini di FAQ kami.

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 project.

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

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

  • Menghapus project akan menghapusnya di Firebase dan Google Cloud.

Menyiapkan proyek Firebase dan mendaftarkan aplikasi

Anda dapat menyiapkan proyek Firebase dan mendaftarkan aplikasi di Firebase console (atau, untuk kasus penggunaan lanjutan, melalui REST API Firebase Management 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 panduan 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 berbeda.

Konsol Firebase

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

Firebase console - layar ikhtisar proyek

Panel sisi kiri konsol mencantumkan produk Firebase, disusun berdasarkan kategori tingkat teratas. 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 konsol Firebase.

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 oleh Firebase atau perbarui fungsi.

API REST Manajemen Firebase

Dengan menggunakan REST API Firebase Management , Anda dapat mengelola proyek Firebase secara terprogram. Misalnya, Anda dapat mendaftarkan aplikasi dengan proyek secara terprogram atau mendaftar 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 . Pengidentifikasi ini adalah nama khusus internal untuk proyek di Firebase console , Google Cloud Console , dan Firebase CLI . Nama project tidak ditampilkan di produk, layanan, atau resource Firebase atau Google Cloud yang terlihat secara publik; itu hanya berfungsi untuk membantu Anda lebih mudah membedakan antara beberapa proyek.

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

Nomor proyek

Proyek Firebase (dan proyek Google Cloud terkait ) memiliki nomor proyek . Ini adalah pengidentifikasi kanonis 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 proyek, nomor proyek juga akan dihapus dan tidak dapat digunakan lagi oleh proyek lain.

ID proyek

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

File dan objek konfigurasi Firebase

Saat Anda mendaftarkan aplikasi ke proyek Firebase, konsol Firebase 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 bisa mendapatkan 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 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 (contoh nilai: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

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

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

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

Untuk proyek sumber terbuka, kami umumnya tidak menyarankan untuk menyertakan file atau objek konfigurasi Firebase aplikasi dalam kontrol sumber karena, pada umumnya, 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).

Batasan umum untuk proyek, aplikasi, dan situs Firebase

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

  • Jumlah proyek per akun

    • Paket harga Spark — 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 penambahan kuota proyek .

    Ketahuilah bahwa penghapusan proyek secara menyeluruh memerlukan waktu 30 hari dan dihitung dalam kuota proyek hingga proyek dihapus sepenuhnya.

  • Jumlah aplikasi per project

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

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

    Pelajari lebih lanjut tentang batas aplikasi per project di FAQ.

  • Jumlah situs Hosting per proyek

    Fitur multisite Firebase Hosting mendukung maksimal 36 situs per project.

Meluncurkan aplikasi Anda