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 liên quan đến dự án Firebase. Nếu có, hãy truy cập vào các đường liên kết để tìm thông tin chi tiết hơn về các tính năng, dịch vụ, công cụ và phương pháp hay nhất.
Mối quan hệ giữa dự án, ứng dụng và sản phẩm của 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ý các ứng dụng Apple, Android hoặc ứng dụng web. Sau khi đăng ký ứng dụng 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, chẳng hạn như Analytics, Cloud Firestore, Performance Monitoring hoặc Remote Config.
Tìm hiểu thông tin chi tiết hơn 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 | Unity | C++ |
Flutter.
Tìm hiểu hệ thống phân cấp của các dự án Firebase
Sơ đồ này cho thấy hệ phân cấp cơ bản của một dự án Firebase. Sau đâ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ả ứng dụng của bạn và mọi tài nguyên cũng như dịch vụ được cung cấp cho dự án.
Một dự án Firebase có thể có một hoặc nhiều Ứng dụng Firebase được đăng ký với dự án đó (ví dụ: cả phiên bản iOS và Android của một ứng dụng, hoặc cả phiên bản miễn phí và có tính phí của một ứng dụng).
Tất cả Ứng dụng Firebase đã đăng ký 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ý cùng một dự án Firebase đều dùng chung các dịch vụ phụ trợ, chẳng hạn như Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage và Cloud Functions.
Tất cả Ứng dụng Firebase đã đăng ký cùng một dự án Firebase đều được liên kết với cùng một tài sản Google Analytics, trong đó mỗi Ứng dụng Firebase là một luồng dữ liệu riêng biệt trong tài sản đó.
Mối quan hệ giữa dự án Firebase và Google Cloud
Khi 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ầm. 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ụ.
Xin 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 vào dự án của bạn trong trang IAM và quản trị > Nhãn của bảng điều khiển Google Cloud. Tìm hiểu thêm về nhãn này trong phần 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:
Bạn có thể truy cập và tương tác với dự án trong bảng điều khiển Firebase cũng như trong bảng điều khiển Google Cloud và Bảng điều khiển API của Google.
Bạn có thể tương tác với dự án bằng FirebaseCLI, gcloud CLI và mọi tài nguyên Terraform của Google.
Bạn có thể sử dụng các sản phẩm và API của cả Firebase và Google Cloud trong dự án.
Các quyền và vai trò IAM cho dự án được chia sẻ trên Firebase và Google Cloud. Mọi quyền truy cập mà một thành viên dự án (tức là một pháp nhân) có đối với dự án Google Cloud của bạn cũng sẽ áp dụng cho dự án Firebase của bạn (và ngược lại).
Thanh toán cho dự án được chia sẻ giữa Firebase và Google Cloud. Nếu bạn đã bật tính năng thanh toán cho dự án Google Cloud, thì dự án Firebase của bạn sẽ sử dụng gói giá Blaze (trả tiền theo mức dùng) của Firebase.
Giá trị nhận dạng duy nhất cho dự án (chẳng hạn như số dự án và mã dự án) được chia sẻ trên Firebase và Google Cloud.
Mọi hệ thống phân cấp tài nguyên được áp dụng cho dự án Google Cloud của bạn (ví dụ: tổ chức, thư mục, v.v.) cũng sẽ áp dụng cho dự án Firebase của bạn.
Khi bạn xoá dự án, dự án đó sẽ bị xoá trên cả Firebase và Google Cloud.
Việc xoá hoặc sửa đổi một tài nguyên hoặc dữ liệu trong dự án sẽ áp dụng trên Firebase và 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 Firebase (hoặc, đối với các trường hợp sử dụng nâng cao, hãy dùng API REST của Firebase Management hoặc Firebase CLI). Khi 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ề tổ chức và thêm thông tin cấu hình dành riêng cho Firebase vào các dự án cục bộ của mình.
Đối với các ứng dụng phát hành công khai, bạn cần thiết lập một 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. Xem 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à các nguyên tắc bảo mật chung để thiết lập dự án Firebase và đăng ký ứng dụng nhằm tạo quy trình phát triển của bạn.
Tương tác với một dự án Firebase
Ngoài các SDK sản phẩm, bạn có thể tương tác trực tiếp với một dự án Firebase bằng nhiều công cụ và giao diện.
Firebase bảng điều khiển
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à chế độ cài đặt ở cấp dự án của Firebase.
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 các danh mục cấp cao nhất. Ở đầu bảng điều khiển bên trái, hãy nhấp vào biểu tượng
Ở giữa bảng điều khiển là 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, khu vực chính của bảng điều khiển sẽ thay đổi thành một trang tổng quan hiển thị số liệu thống kê về các sản phẩm mà bạn sử dụng.
Xin lưu ý rằng vì dự án Firebase cũng là một dự án Google Cloud, nên bạn có thể thấy rằng nhiều tác vụ hoặc sản phẩm 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 Firebase.
Firebase CLI (một công cụ dòng lệnh)
Firebase cũng cung cấp FirebaseCLI để định cấu hình và quản lý các sản phẩm cụ thể của Firebase, chẳng hạn như Firebase Hosting, Cloud Functions for Firebase và Firebase Extensions.
Sau khi cài đặt CLI Firebase, bạn có quyền truy cập vào lệnh firebase chung. Sử dụng CLI Firebase để liên kết thư mục ứng dụng cục bộ 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 cho hàm.
Firebase Management REST API
Khi sử dụng Firebase Management API REST, bạn có thể quản lý một dự án Firebase theo cách lập trình. Ví dụ: bạn có thể đăng ký ứng dụng với một dự án theo phương thức lập trình hoặc liệt kê các ứng dụng đã đăng ký (iOS+ | Android | web).
Giá trị 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 bằng nhiều giá trị nhận dạng, bao gồm tên dự án, số dự án và mã dự án.
Tên dự án
Khi tạo dự án, bạn sẽ cung cấp tên dự án. Mã nhận dạng này là tên chỉ dùng nội bộ cho một dự án trong bảng điều khiển Firebase, bảng điều khiển Google Cloud và Firebase CLI. Tên dự án không xuất hiện 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 mà mọi người có thể nhìn thấy; tên dự án chỉ 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 ngăn trên cùng của
Số dự án
Một dự án Firebase (và dự án Google Cloud được liên kết) có một số dự án. Đây là giá trị nhận dạng chuẩn duy nhất trên toàn cầu do Google chỉ định cho dự án. Sử dụng giá trị nhận dạng này khi định cấu hình các hoạt động tích hợp và/hoặc thực hiện các lệnh gọi API đến Firebase, Google hoặc các dịch vụ 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 cũng sẽ bị xoá và không bao giờ được dùng lại cho 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ột mã dự án. Đây là giá trị nhận dạng riêng biệ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 một dự án Firebase, Firebase sẽ 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ã nhận dạng 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 bí danh thuận tiện để tham chiếu đến dự án.
Các tệp và đối tượng cấu hình Firebase
Khi bạn đăng ký một ứng dụng với một dự án Firebase, bảng điều khiển Firebase sẽ cung cấp một tệp cấu hình Firebase (ứng dụng Apple/Android) hoặc một đố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ộ.
- Đối với các ứng dụng Apple, bạn thêm một tệp cấu hình
GoogleService-Info.plist. - Đối với các ứng dụng Android, bạn sẽ thêm một tệp cấu hình
google-services.json. - Đối với ứng dụng web, bạn thêm một đối tượng cấu hình Firebase.
Bất cứ lúc nào, bạn cũng có thể lấy tệp cấu hình hoặc đối tượng Firebase của một ứng dụng.
Tệp hoặc đối tượng 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 dự án đó (cơ sở dữ liệu, vùng lưu trữ, v.v.). Cấu hình này bao gồm "Các lựa chọn về Firebase", là những thông số mà Firebase và các dịch vụ của Google yêu cầu để giao tiếp với các API máy chủ của Firebase và để liên kết dữ liệu của ứng dụng với dự án Firebase và ứng dụng Firebase. Sau đây là "Các lựa chọn về Firebase" tối thiểu bắt buộc:
Khoá API: một chuỗi mã hoá đơn giản được dùng khi gọi một số API nhất định không cần truy cập vào dữ liệu người dùng riêng tư (giá trị ví dụ:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)Mã dự án: giá trị nhận dạng duy nhất do người dùng xác định cho dự án trên tất cả các dự án của Firebase và Google Cloud. Mã 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 thường được coi là một bí danh thuận tiện để tham chiếu đến dự án. (giá trị ví dụ:
myapp-project-123)Mã ứng dụng ("AppID"): mã nhận dạng duy nhất cho ứng dụng Firebase trên tất cả các nền tảng của Firebase theo một định dạng dành riêng cho nền tảng:
- Ứng dụng Firebase Apple:
GOOGLE_APP_ID(giá trị ví dụ: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ị ví dụ:1:1234567890:android:321abc456def7890)
Đây không phải là tên gói Android hoặc mã ứng dụng Android. - Ứng dụng web Firebase:
appId(giá trị ví dụ:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Ứng dụng Firebase Apple:
Nội dung của tệp hoặc đối tượng cấu hình Firebase được coi là công khai, bao gồm cả mã nhận dạng dành riêng cho nền tảng của ứng dụng (mã nhận dạng gói Apple hoặc tên gói Android) và các giá trị dành riêng cho dự án Firebase, chẳng hạn như Khoá API, mã dự án, URL Realtime Database và tên vùng chứa Cloud Storage. Do đó, hãy dùng Firebase Security Rules để bảo vệ dữ liệu và tệp của bạn trong Realtime Database, 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 tệp hoặc đối tượng cấu hình Firebase của ứng dụng vào tính năng 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ọ đến tài nguyên Firebase của riêng họ (thông qua tệp hoặc đối tượng cấu hình Firebase của riêng họ).
Các giới hạn chung đối với dự án, ứng dụng và trang web Firebase
Sau đây là một số giới hạn chung đối với các dự án, ứng dụng và trang web trên Firebase:
Số lượng dự án trên mỗi Tài khoản Google (địa chỉ email)
- Gói giá Spark: Hạn mức tạo dự án bị giới hạn ở một số lượng nhỏ dự án (thường là khoảng 5 đến 10).
- Gói giá Blaze: Hạn mức tạo dự án vẫn bị giới hạn, nhưng có thể tăng lên khi bạn liên kết một tài khoản Cloud Billing đang ở trạng thái tốt.
Xin lưu ý những điều sau đây về hạn mức tạo dự án:
- Giới hạn này không dành riêng cho Firebase. Hạn mức dự án của Firebase giống với hạn mức của Google Cloud.
- Trong trường hợp hiếm gặp cần thiết, bạn có thể yêu cầu tăng hạn mức dự án.
- Việc xoá hoàn toàn một dự án cần 30 ngày và được tính vào hạn mức dự án cho đến khi dự án bị xoá hoàn toàn.
Tìm hiểu về các phương pháp hay nhất chung được Firebase đề xuất để thiết lập dự án Firebase.
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 một 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 đều là các biến thể nền tảng của cùng một ứng dụng theo góc độ người dùng cuối. Đọc thêm về mô hình nhiều đối tượ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ề giới hạn về số lượng ứng dụng trên mỗi dự án trong phần Câu hỏi thường gặp.
Số lượng trang web Hosting trên mỗi dự án
Firebase HostingTính năng nhiều trang web hỗ trợ tối đa 36 trang web cho mỗi dự án.
Ra mắt ứng dụng
- Thiết lập cảnh báo ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
- Theo dõi trang tổng quan Mức sử dụng và thanh toán trong bảng điều khiển Firebase để nắm được thông tin tổng quan về mức sử dụng của dự án trên nhiều dịch vụ của Firebase.
- Xem danh sách kiểm tra trước khi phát hành của Firebase.