Catch up on highlights from Firebase at Google I/O 2023. Learn more

Hiểu 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ề dự án Firebase. Khi có sẵn, hãy theo các liên kết để tìm 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 cho Firebase. Trong một dự án, bạn có thể đăng ký ứng dụng Apple, Android hoặc web của mình. Sau khi bạn đăng ký ứng dụng của mình với Firebase, bạn có thể thêm SDK Firebase cho bất kỳ số lượng sản phẩm Firebase nào, như Analytics, Cloud Firestore, Giám sát hiệu suất hoặc Cấu hình từ xa.

Tìm hiểu thêm thông tin chi tiết về quy trình này trong hướng dẫn Bắt đầu cho nền tảng của bạn:
iOS+ | Android | web | Đoàn kết | C++ | Rung .

Hiểu hệ thống phân cấp của các dự án Firebase

Sơ đồ hiển thị cấu trúc phân cấp cơ bản của dự án Firebase, bao gồm dự án, các ứng dụng đã đăng ký cũng như các tài nguyên và dịch vụ được cung cấp của dự án Sơ đồ này hiển thị hệ thống phân cấp cơ bản của dự án Firebase. Dưới đây là các mối quan hệ chính:

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

  • Dự án Firebase có thể có một hoặc nhiều Ứng dụng Firebase được đăng ký (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à trả phí của ứng dụng).

  • Tất 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 tất cả các tài nguyên và dịch vụ giống nhau được cung cấp cho dự án . Dưới đây là một số ví dụ:

    • Tất cả Ứng dụng Firebase đã đăng ký cho cùng một dự án Firebase đều có chung phần phụ trợ, như Lưu trữ Firebase, Xác thực, Cơ sở dữ liệu thời gian thực, Cloud Firestore, Lưu trữ đám mây và Chức năng đám mây.

    • Tất cả Ứng dụng Firebase đã đăng ký cho 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 luồng dữ liệu riêng biệt trong thuộc tính đó.

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

Khi bạn tạo một dự án Firebase mới, thực tế là bạn đang tạo một dự án Google Cloud đằng sau hậu trường. Bạn thậm chí có thể tạo dự án Google Cloud trước, sau đó thêm Firebase vào dự án sau. Bạn có thể coi dự án Google Cloud là một 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 firebase:enabled trong trang Nhãn cho dự án của bạn trong Google Cloud Console. 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à 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 dự án Firebase và đăng ký ứng dụng trong bảng điều khiển 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 CLI Firebase ). Khi thiết lập dự án và đăng ký ứng dụng, bạn cần đưa ra một số quyết định về tổ chức và thêm thông tin cấu hình dành riêng cho Firebase vào dự án cục bộ của mình.

Đối với các ứng dụng sản xuất, bạn cần thiết lập quy trình phát triển rõ ràng, quy trình này thường liên quan đến việc sử dụng nhiều môi trường. Xem lại 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 hay nhất nói chung và nguyên tắc bảo mật chung để thiết lập dự án Firebase và đăng ký ứng dụng để tạo quy trình phát triển của bạn.

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

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

Bảng điều khiển căn cứ hỏa lực

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

Bảng điều khiển Firebase - màn hình tổng quan 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 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, truy cập cài đặt của dự án bằng cách nhấp vào . Cài đặt của dự án bao gồm tích hợp , quyền truy cập và thanh toán .

Phần giữa củ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ý các loại ứng dụng khác nhau. Sau khi bạn bắt đầu sử dụng Firebase, khu vực chính của bảng điều khiển sẽ thay đổi thành trang tổng quan hiển thị số liệu thống kê về các sản phẩ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ể thấy rằng các tác vụ hoặc sản phẩm khác nhau yêu cầu bạn sử dụng Google Cloud Console thay vì bảng điều khiển Firebase.

Firebase CLI (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 Firebase cụ thể, như Lưu trữ Firebase, Chức năng đám mây cho Firebase và Tiện ích mở rộng Firebase.

Sau khi cài đặt CLI, bạn có quyền truy cập vào lệnh firebase toàn cầu . Sử dụng CLI để liên kết thư mục ứng dụng cục bộ của bạn với 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 cho hàm.

API REST quản lý căn cứ hỏa lực

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

Số nhận dạng dự án Firebase

Một dự án Firebase có thể được xác định trong chương trình phụ trợ Firebase và trong các giao diện dành cho nhà phát triển khác nhau bằng cách sử dụng các mã định danh khác nhau, bao gồm tên dự án , số dự án và ID dự án .

Tên dự án

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

Bạn có thể chỉnh sửa tên dự án bất kỳ lúc nào trong dự án của bảng điều khiển Firebase. Tên dự án được hiển thị trong ngăn trên cùng.

số dự án

Dự án Firebase (và dự án Google Cloud được liên kết với nó) có số dự án . Đây là mã định danh chính tắc duy nhất trên toàn cầu do Google chỉ định cho dự án. Sử dụng số nhận dạng này khi định cấu hình tích hợp và/hoặc thực hiện lệnh gọi API tới 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 xóa một dự án, số dự án cũng sẽ bị xóa và không bao giờ có thể được sử dụng lại bởi bất kỳ dự án nào khác.

ID dự án

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

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

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

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

Bất cứ lúc nào, bạn có thể lấy đối tượng hoặc tệp cấu hình 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 dự án Firebase cụ thể và các tài nguyên của nó (cơ sở dữ liệu, bộ chứa lưu trữ, v.v.). Cấu hình bao gồm "Tùy chọn Firebase", là các tham số mà các dịch vụ của Firebase và Google yêu cầu để giao tiếp với API máy chủ Firebase và để liên kết dữ liệu khách hàng với dự án Firebase và ứng dụng Firebase. Dưới đây là "Tùy chọn Firebase" tối thiểu bắt buộc:

  • Khóa API : một chuỗi mã hóa đơn giản được sử 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ị ví dụ: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

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

  • ID ứng dụng ("AppID") : mã định danh duy nhất cho ứ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ị ví dụ: 1:1234567890:ios:321abc456def7890 )
      Đây không phải là ID gói Apple.
    • Ứng dụng Firebase Android: mobilesdk_app_id (giá trị ví dụ: 1:1234567890:android:321abc456def7890 )
      Đây không phải là tên gói Android hoặc ID ứng dụng Android.
    • Ứng dụng web Firebase: appId (giá trị ví dụ: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Nội dung của đối tượng hoặc tệp cấu hình Firebase đượ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ị dành riêng cho dự án Firebase, như Khóa API, ID dự án, URL cơ sở dữ liệu thời gian thực và Tên bộ chứa Lưu trữ đám mây. Vì điều này, hãy sử dụng Quy tắc bảo mật Firebase để bảo vệ dữ liệu và tệp của bạn trong Cơ sở dữ liệu 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 bạn nên đưa đối tượng hoặc tệp cấu hình Firebase của ứng dụng vào kiểm soát nguồn vì trong hầu hết các trường hợp, người dùng của bạn nên tạo dự án Firebase của riêng họ và trỏ ứng dụng của họ tới tài nguyên Firebase của riêng họ (thông qua cấu hình Firebase của riêng họ tệp hoặc đối tượng).

Giới hạn chung cho các dự án, ứng dụng và trang web Firebase

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

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

    • Gói định giá Spark — Hạn ngạch tạo dự án được giới hạn ở số lượng dự án thấp hơn (thường khoảng 5-10).
    • Gói định giá Blaze — Hạn ngạch tạo dự án trên mỗi tài khoản tăng đáng kể miễn là tài khoản Thanh toán qua đám mây được liên kết ở trạng thái tốt.

    Hầu hết các nhà phát triển hiếm khi quan tâm đến giới hạn hạn ngạch tạo dự án, nhưng nếu cần, bạn có thể yêu cầu tăng hạn ngạch dự án .

    Xin lưu ý rằng việc xóa hoàn toàn dự án cần 30 ngày và được tính vào hạn ngạch dự án cho đến khi dự án bị xóa hoàn toàn.

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

    Firebase giới hạn tổng số Ứng dụng Firebase trong dự án Firebase là 30.

    Bạn nên đảm bảo rằng tất cả Ứng dụng Firebase trong một dự án Firebase duy nhất là 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êm về hình thức cho thuê nhiều người 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ề giới hạn đối với ứng dụng cho mỗi dự án trong Câu hỏi thường gặp.

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

    Tính năng nhiều trang của Dịch vụ lưu trữ Firebase hỗ trợ tối đa 36 trang cho mỗi dự án.

Khởi chạy ứng dụng của bạn