Tìm hiểu về các dự án Firebase

Trang này cung cấp thông tin tổng quan ngắn gọn về một số khái niệm quan trọng về Firebase dự án. Hãy truy cập vào các đường liên kết (nếu có) để xem thêm thông tin chi tiết về các tính năng, dịch vụ, công cụ và các phương pháp hay nhất.

Mối quan hệ giữa các dự án, ứng dụng và sản phẩm Firebase

Dự án Firebase là thực thể cấp cao nhất của Firebase. Trong một dự án, bạn có thể đăng ký ứng dụng Apple, Android hoặc ứng dụng web của bạn. Sau khi bạn đăng ký ứng dụng của mình với Firebase, bạn có thể thêm Firebase SDK cho bất kỳ số lượng Các sản phẩm của Firebase, chẳng hạn như Analytics, Cloud Firestore, Giám sát hiệu suất hoặc Cấu hình từ xa.

Hãy tìm hiểu thêm thông tin chi tiết về quy trình này trong tài liệu Bắt đầu hướng dẫn cho nền tảng của bạn:
iOS trở lên | Android | web | Unity | C++ | Flutter.

Tìm hiểu hệ phân cấp của các dự án Firebase

Sơ đồ cho thấy hệ phân cấp cơ bản của một dự án Firebase, bao gồm dự án, các ứng dụng đã đăng ký của dự án, tài nguyên và tài nguyên được cấp phép của dự án các dịch vụ Sơ đồ này cho thấy hệ phân cấp cơ bản của một dự án Firebase. Sau đây là yếu tố quan trọng mối quan hệ:

  • Dự án Firebase giống như một vùng chứa dành cho tất cả ứng dụng và tài nguyên của bạn và dịch vụ được cung cấp cho dự án.

  • Mỗi dự án Firebase có thể có một hoặc nhiều Ứng dụng Firebase được đăng ký trong dự án đó (ví dụ: cả phiên bản iOS và Android của ứng dụng hoặc cả phiên bản miễn phí và phiên bản có tính phí của một ứng dụng).

  • Tất cả các Ứng dụng Firebase đã đăng ký với cùng một dự án Firebase đều chia sẻ và có quyền truy cập vào cùng một tài nguyên và dịch vụ được cung cấp cho dự án. Sau đây là một số ví dụ:

    • Tất cả các Ứng dụng Firebase được đăng ký với cùng một dự án Firebase đều có chung các phần phụ trợ, chẳng hạn như Lưu trữ Firebase, Xác thực, Cơ sở dữ liệu theo thời gian thực, Cloud Firestore, Cloud Storage và Cloud Functions.

    • Tất cả các ứng dụng Firebase đã đăng ký với cùng một dự án Firebase đều được liên kết với cùng một thuộc tính Google Analytics, trong đó mỗi Ứng dụng Firebase là một riêng biệt trong luồng dữ liệu riêng biệt trong tài sản đó.

Mối quan hệ giữa các dự án Firebase và Google Cloud

Khi tạo một dự án Firebase mới, bạn sẽ thực sự tạo một Dự án trên Google Cloud cảnh hậu trường. Trước tiên, bạn có thể tạo một dự án trên Google Cloud rồi thêm Firebase vào dự án sau. Bạn có thể nghĩ đến một dự án trên Google Cloud dưới dạng vùng chứa ảo cho dữ liệu, mã, cấu hình và dịch vụ.

Lưu ý rằng đối với tất cả các dự án Firebase, Firebase sẽ tự động thêm nhãn là firebase:enabled ở Trang Nhãn cho dự án của mình trong bảng điều khiển Google Cloud. Tìm hiểu thêm về nhãn này trong Câu hỏi thường gặp của chúng tôi.

Vì dự án Firebase là một dự án Google Cloud:

Thiết lập dự án Firebase và đăng ký ứng dụng

Bạn có thể thiết lập một dự án Firebase và đăng ký ứng dụng trong bảng điều khiển của Firebase (hoặc, đối với các trường hợp sử dụng nâng cao, thông qua API REST quản lý Firebase hoặc Giao diện dòng lệnh (CLI) của Firebase). Khi bạn thiết lập một dự án và đăng ký ứng dụng, bạn cần đưa ra một số quyết định về mặt tổ chức và thêm Thông tin cấu hình dành riêng cho Firebase cho các dự án cục bộ của bạn.

Đối với ứng dụng chính thức, bạn cần thiết lập quy trình phát triển rõ ràng, thường liên quan đến việc sử dụng nhiều môi trường. Tham khảo tài liệu của chúng tôi về quy trình làm việc của nhà phát triển, bao gồm các phương pháp chung hay nhất và nguyên tắc chung về bảo mật để thiết lập dự án Firebase và đăng ký ứng dụng nhằm tạo quy trình làm việc.

Tương tác với dự án Firebase

Ngoài SDK sản phẩm, bạn có thể tương tác trực tiếp với dự án Firebase bằng cách dùng một số công cụ và giao diện.

bảng điều khiển của Firebase

Bảng điều khiển của Firebase mang đến môi trường phong phú nhất để quản lý Firebase sản phẩm, ứng dụng và chế độ cài đặt cấp dự án.

Bảng điều khiển của Firebase – màn hình tổng quan về dự án

Bảng điều khiển ở bên trái của bảng điều khiển liệt kê các sản phẩm của Firebase, được sắp xếp theo danh mục cấp cao nhất. Ở đầu bảng điều khiển bên trái, hãy truy cập vào bằng cách nhấp vào . của một dự án các chế độ cài đặt bao gồm tích hợp, quyền truy cập, và thanh toán.

Ở giữa bảng điều khiển hiển thị các nút khởi chạy quy trình thiết lập đăng ký nhiều loại ứng dụng. Sau khi bạn bắt đầu sử dụng Firebase, phần chính của bảng điều khiển thay đổi thành trang tổng quan hiển thị số liệu thống kê về sản phẩm mà bạn sử dụng.

Lưu ý rằng vì dự án Firebase cũng là dự án Google Cloud, nên bạn có thể nhận thấy rằng các nhiệm vụ hoặc sản phẩm khác nhau yêu cầu bạn sử dụng bảng điều khiển Google Cloud thay vì bảng điều khiển của Firebase.

Firebase CLI (một công cụ dòng lệnh)

Firebase cũng cung cấp Firebase CLI để định cấu hình và quản lý các sản phẩm cụ thể của Firebase (như tính năng Lưu trữ Firebase), Cloud Functions cho Firebase và Tiện ích của Firebase.

Sau khi cài đặt CLI, bạn có quyền truy cập vào lệnh firebase chung. Sử dụng CLI để liên kết thư mục ứng dụng trên máy với một dự án Firebase, sau đó triển khai các phiên bản mới của nội dung được lưu trữ trên Firebase hoặc các bản cập nhật hàm.

API REST quản lý Firebase

Sử dụng API REST quản lý Firebase, bạn có thể quản lý dự án Firebase theo phương thức lập trình. Ví dụ: bạn có thể đăng ký một ứng dụng với một dự án bằng phương thức lập trình hoặc liệt kê các ứng dụng đã đăng ký (iOS trở lên | Android | web).

Mã nhận dạng dự án Firebase

Bạn có thể xác định một dự án Firebase trong phần phụ trợ của Firebase và trong nhiều giao diện nhà phát triển sử dụng các mã nhận dạng khác nhau, bao gồm cả tên dự án, số dự án và mã dự án.

Tên dự án

Khi tạo một dự án, bạn cần cung cấp tên dự án. Giá trị nhận dạng này là tên chỉ sử dụng nội bộ cho một dự án trong bảng điều khiển của Firebase, bảng điều khiển Google Cloud, và Firebase CLI. Tên dự án không hiển thị trong bất kỳ sản phẩm, dịch vụ hoặc tài nguyên của Firebase hoặc Google Cloud; nó chỉ đơn giản là giúp bạn dễ dàng phân biệt giữa nhiều dự án.

Bạn có thể chỉnh sửa tên dự án bất cứ lúc nào trong Dự án phần cài đặt của bảng điều khiển của Firebase. Tên dự án xuất hiện ở ngăn trên cùng.

Số dự án

Một dự án Firebase (và dự án Google Cloud được liên kết) có số dự án. Đây là trang chính tắc duy nhất trên toàn cầu do Google chỉ định giá trị nhận dạng cho dự án. Sử dụng giá trị nhận dạng này khi định cấu hình hoạt động tích hợp và/hoặc thực hiện lệnh gọi API đến Firebase, Google hoặc các dịch vụ của bên thứ ba.

Bạn không thể chỉnh sửa số dự án. Nếu bạn xoá một dự án, số dự án sẽ là cũng bị xoá và không bao giờ có thể được sử dụng lại bởi bất kỳ dự án nào khác.

Mã dự án

Một dự án Firebase (và dự án Google Cloud được liên kết) có mã dự án. Đây là giá trị nhận dạng duy nhất do người dùng xác định cho dự án trên toàn bộ Firebase và Google Cloud. Khi bạn tạo một dự án Firebase, Firebase tự động chỉ định một mã nhận dạng duy nhất cho dự án, nhưng bạn có thể chỉnh sửa mã này trong quá trình thiết lập dự án. Giá trị nhận dạng này thường được coi là một giá trị tiện lợi để tham chiếu dự án.

Tệp và đối tượng cấu hình Firebase

Khi bạn đăng ký một ứng dụng bằng dự án Firebase, bảng điều khiển của Firebase cung cấp tệp cấu hình Firebase (ứng dụng Apple/Android) hoặc một cấu hình đối tượng (ứng dụng web) mà bạn thêm trực tiếp vào thư mục ứng dụng cục bộ.

  • Đối với các ứng dụng của Apple, bạn hãy thêm tệp cấu hình GoogleService-Info.plist.
  • Đối với ứng dụng Android, bạn sẽ thêm tệp cấu hình google-services.json.
  • Đối với ứng dụng web, bạn sẽ thêm một đối tượng cấu hình Firebase.

Bất cứ lúc nào, bạn có thể nhận tệp cấu hình Firebase hoặc đối tượng Firebase của ứng dụng.

Đối tượng hoặc tệp cấu hình Firebase liên kết một ứng dụng với một Firebase cụ thể dự án và tài nguyên của dự án (cơ sở dữ liệu, bộ chứa lưu trữ, v.v.). Cấu hình bao gồm "tuỳ chọn Firebase", là các thông số theo yêu cầu của Firebase và Các dịch vụ của Google để giao tiếp với API máy chủ Firebase và để liên kết với ứng dụng với dự án Firebase và ứng dụng Firebase. Dưới đây là các thành phần bắt buộc, "Tuỳ chọn Firebase":

  • khoá API: một cách đơn giản chuỗi đã mã hoá được dùng khi gọi một số API nhất định không cần truy cập dữ liệu riêng tư của người dùng (giá trị mẫu: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • Mã dự án: mã do người dùng xác định mã nhận dạng duy nhất cho dự án trên toàn bộ Firebase và Google Cloud. Giá trị nhận dạng này có thể xuất hiện trong URL hoặc tên của một số tài nguyên Firebase, nhưng nó thường được coi là bí danh tiện lợi để tham chiếu dự án. (giá trị mẫu: myapp-project-123)

  • Mã ứng dụng ("AppID"): giá trị nhận dạng duy nhất của ứng dụng Firebase trên toàn bộ Firebase với định dạng dành riêng cho nền tảng:

    • Ứng dụng Firebase của Apple: GOOGLE_APP_ID (giá trị mẫu: 1:1234567890:ios:321abc456def7890)
      Đây không phải là mã nhận dạng gói Apple.
    • Ứng dụng Firebase dành cho Android: mobilesdk_app_id (giá trị mẫu: 1:1234567890:android:321abc456def7890)
      Đây không phải là tên gói hoặc mã ứng dụng Android.
    • Ứng dụng web Firebase: appId (giá trị mẫu: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

Nội dung của tệp cấu hình Firebase hoặc đối tượng sẽ được coi là công khai, bao gồm ID dành riêng cho nền tảng của ứng dụng (ID gói Apple hoặc tên gói Android) và các giá trị theo dự án Firebase, chẳng hạn như Khoá API, mã dự án URL của cơ sở dữ liệu theo thời gian thực và tên bộ chứa trong Cloud Storage. Do đó, sử dụng Quy tắc bảo mật của Firebase để bảo vệ dữ liệu và tệp của bạn trong Cơ sở dữ liệu theo thời gian thực, Cloud Firestore, và Cloud Storage.

Đối với các dự án nguồn mở, chúng tôi thường không khuyến khích việc đưa mã Tệp cấu hình Firebase hoặc đối tượng trong chế độ kiểm soát nguồn vì trong hầu hết các trường hợp, người dùng nên tạo dự án Firebase của riêng họ và trỏ ứng dụng của họ đến tài nguyên Firebase của riêng chúng (thông qua tệp hoặc đối tượng Firebase của riêng chúng).

Giới hạn chung đối với dự án, ứng dụng và trang web trên Firebase

Dưới đây là một số giới hạn chung đối với các dự án, ứng dụng và trang web trong Firebase:

  • Số dự án trên mỗi tài khoản

    • Gói giá Spark — Hạn mức tạo dự án bị giới hạn ở số lượng thấp hơn dự án (thường vào khoảng 5-10 dự án).
    • Gói giá linh hoạt – Hạn mức tạo dự án trên mỗi tài khoản tăng miễn là tài khoản thanh toán Cloud được liên kết trạng thái tốt.

    Giới hạn về hạn mức tạo dự án hiếm khi là mối lo ngại của hầu hết các nhà phát triển. nhưng nếu cần, bạn có thể yêu cầu tăng hạn mức dự án.

    Xin lưu ý rằng để xoá hoàn toàn một dự án cần 30 ngày và số lượng hạn mức dự án cho đến khi dự án bị xoá hoàn toàn.

  • Số ứng dụng trên mỗi dự án

    Firebase hạn chế tổng số Ứng dụng Firebase trong một dự án Firebase đến 30.

    Bạn cần đảm bảo rằng tất cả các Ứng dụng Firebase trong một dự án Firebase các biến thể nền tảng của cùng một ứng dụng từ góc độ người dùng cuối. Đã đọc thông tin khác về nhiều khách hàng thuê trong tài liệu về các phương pháp hay nhất của chúng tôi.

    Tìm hiểu thêm về chính sách giới hạn về số ứng dụng cho mỗi dự án trong phần Câu hỏi thường gặp.

  • Số trang web lưu trữ cho mỗi dự án

    Tính năng nhiều trang web của tính năng Lưu trữ Firebase hỗ trợ tối đa 36 trang web cho mỗi dự án.

Ra mắt ứng dụng của bạn