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 liên quan đến dự án Firebase. Khi có, hãy làm theo 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 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. 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 sử dụng cho nền tảng của bạn:
iOS+ | Android | web | Unity | C++ | Flutter.

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

Sơ đồ này cho thấy hệ thống phân cấp cơ bản của một 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ả ứ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à phiên bản trả phí của một ứng dụng).

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

  • Tất cả Ứng dụng Firebase được đăng ký với cùng một dự án Firebase đều chia sẻ cùng một phần 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 được đăng ký với 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, bạn thực sự đang tạo một Google Cloud dự án ở chế độ nền. Bạn thậm chí có thể tạo một dự án Google Cloud trước, sau đó thêm Firebase vào dự án đó. 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ụ.

Điểm chính:Dự án Firebase thực ra chỉ là một dự án có thêm các cấu hình và dịch vụ dành riêng cho Firebase được bật.

Google Cloud

Xin lưu ý rằng đối với tất 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 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.

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

• Bạn có thể truy cập và tương tác với dự án trong Firebase bảng điều khiển cũng như trong Google Cloud bảng điều khiển 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 Firebase CLI, the 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.

• 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à thành viên dự án (tức là, một thực thể chính) 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).

• Hoá đơn cho dự án được chia sẻ trên Firebase và Google Cloud. Nếu tính năng thanh toán được bật trên 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 riêng biệt cho dự á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 (ví dụ: tổ chức, thư mục, v.v.) cũng sẽ áp dụng cho dự án Firebase.

• Khi bạn xoá dự án, dự án đó sẽ bị xoá trên Firebase và Google Cloud.

• Việc xoá hoặc sửa đổi 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 dự án Firebase và đăng ký ứng dụng trong Firebase bảng điều khiển (hoặc đối với các trường hợp sử dụng nâng cao, hãy sử dụng API REST Quản lý Firebase hoặc Firebase CLI). 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 các dự án cục bộ.

Đối với các ứng dụng sản xuất, 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 phát triển, bao gồm các phương pháp hay nhất chung và 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.

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 một số công cụ và giao diện khác nhau.

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

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 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, hãy truy cập vào chế độ cài đặt của dự án bằng cách nhấp vào . Chế độ cài đặt của dự án bao gồm các tính năng 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ý 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 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 (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ể, chẳng hạn như Firebase Hosting, Cloud Functions for Firebase, và Firebase Extensions.

Sau khi cài đặt CLI, bạn có quyền truy cập vào lệnh chung firebase. Sử dụng CLI để 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ập nhật các hàm.

API REST Quản lý Firebase

Khi 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ý ứng dụng với một dự án hoặc liệt kê các ứng dụng đã đăng ký (iOS+ | Android | web) theo phương thức lập trình.

Giá trị nhận dạng dự án Firebase

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

Điểm chính:Số dự án và mã dự án là giá trị nhận dạng riêng biệt thực sự cho một dự án trên tất cả Firebase và Google Cloud

.

Tên dự án

Khi tạo một dự án, bạn sẽ cung cấp tên dự án. Giá trị nhận dạng này là tên chỉ dành cho nội bộ của một dự án trong Firebase bảng điều khiển, Google Cloud bảng điều khiển, 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; tên này 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 phần Cài đặt 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 được liên kết) có số dự án.Google Cloud Đây là giá trị nhận dạng chính tắc 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 tính nă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 cũng sẽ 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.

Tìm số dự án

Tìm số dự án của dự án Firebase bằng một trong các cách sau:

• Sử dụng Firebase bảng điều khiển: Nhấp vào Cài đặt dự án. Số dự án được hiển thị trong ngăn trên cùng.

• Sử dụng Firebase CLI: Chạy firebase projects:list. Số dự án được hiển thị cùng với tất cả dự án Firebase được liên kết với tài khoản của bạn.

• Sử dụng API REST Quản lý Firebase: Gọi projects.list. Phần nội dung phản hồi chứa số dự án trong đối tượng FirebaseProject.

Lệnh gọi API và số dự án

Đối với nhiều lệnh gọi API, bạn cần đưa vào giá trị nhận dạng riêng biệt cho một dự án. Mặc dù nhiều API chấp nhận mã dự án, nhưng bạn nên sử dụng số dự án để 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.

Tìm hiểu thêm về cách sử dụng giá trị nhận dạng dự án, đặc biệt là số dự án, trong tiêu chuẩn AIP 2510 của Google.

Mã dự án

Dự án Firebase (và dự án được liên kếtGoogle Cloud) có 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ã riêng biệ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 bí danh tiện lợi để tham chiếu đến dự án.

Sau khi Firebase cung cấp tài nguyên cho một dự án Firebase, bạn không thể thay đổi mã dự án của dự án đó. Nếu bạn xoá một dự án, mã dự án cũng sẽ 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.

Tìm mã dự án

Tìm mã dự án của dự án Firebase bằng một trong các cách sau:

• Sử dụng Firebase bảng điều khiển: Nhấp vào Cài đặt dự án. Mã dự án được hiển thị trong ngăn trên cùng.

• Sử dụng Firebase CLI: Chạy firebase projects:list. Mã dự án được hiển thị cùng với tất cả dự án Firebase được liên kết với tài khoản của bạn.

• Sử dụng API REST Quản lý Firebase: Gọi projects.list. Phần nội dung phản hồi chứa mã dự án trong đối tượng FirebaseProject.

Tài nguyên Firebase và mã dự án

Mã dự án hiển thị trong các tài nguyên Firebase hiển thị công khai, ví dụ:

• Miền phụ Hosting mặc định — PROJECT_ID.web.app và PROJECT_ID.firebaseapp.com
• URL Realtime Database mặc định — PROJECT_ID-default-rtdb.firebaseio.com hoặc PROJECT_ID-default-rtdb.REGION_CODE.firebasedatabase.app
• Tên vùng chứa mặc định — Cloud StoragePROJECT_ID.appspot.com

Đối với tất cả tài nguyên nêu trên, bạn có thể tạo các thực thể không mặc định. Tên hiển thị công khai của các thực thể không mặc định có thể tuỳ chỉnh hoàn toàn. Bạn có thể kết nối miền tùy chỉnh với một trang web được lưu trữ trên Firebase, phân đoạn Realtime Database, và tạo nhiều bộ chứa Cloud Storage (truy cập vào trang Bắt đầu sử dụng dành riêng cho nền tảng).

Sau khi Firebase cung cấp tài nguyên cho một dự án Firebase, bạn không thể thay đổi mã dự án của dự án đó. Để sử dụng một giá trị nhận dạng cụ thể cho tài nguyên Firebase, bạn phải chỉnh sửa mã dự án trong quá trình tạo dự án ban đầu.

Firebase CLI và mã dự án

Đối với một số trường hợp sử dụng, bạn có thể có nhiều dự án Firebase được liên kết với cùng một thư mục ứng dụng cục bộ. Trong những trường hợp này, khi sử dụng Firebase CLI, bạn cần truyền cờ --project bằng các lệnh firebase để cho biết dự án Firebase mà bạn muốn tương tác với.

Bạn cũng có thể thiết lập bí danh dự án cho từng dự án Firebase để không phải nhớ mã dự án.

Lệnh gọi API và mã dự án

Đối với nhiều lệnh gọi API, bạn cần đưa vào giá trị nhận dạng riêng biệt cho một dự án. Mặc dù nhiều API chấp nhận mã dự án, nhưng bạn nên sử dụng số dự án để 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.

Tìm hiểu thêm về cách sử dụng giá trị nhận dạng dự án, đặc biệt là số dự án, trong tiêu chuẩn AIP 2510 của Google.

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

Khi bạn đăng ký một ứng dụng với dự án Firebase, bảng điều khiển Firebasecủa 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ộ.

• Đối với ứng dụng 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ũng có thể lấy tệp cấu hình hoặc đối tượng Firebase của một ứng dụng.

Lưu ý: Đối với ứng dụng Flutter, bạn có thể sử dụng tệp cấu hình Firebase đa nền tảng có tên là firebase_options.dart.
Nếu ứng dụng Flutter của bạn sử dụng tệp này, bạn có thể cập nhật tệp bằng cách chạy flutterfire configure từ thư mục dự án Flutter.

Bạn có thể lấy các giá trị cấu hình hiện tại mà Firebase có cho các ứng dụng Flutter đã đăng ký với Firebase bằng cách chạy flutterfire configure --out=my_options.dart.

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 chứa lưu trữ, v.v.). Cấu hình này bao gồm "các tuỳ chọn Firebase", là các tham số mà Firebase và dịch vụ của Google yêu cầu để giao tiếp với API máy chủ Firebase và liên kết dữ liệu ứng dụng với dự án Firebase và ứng dụng Firebase. Dưới đây là các "tuỳ chọn 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 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 riêng biệt do người dùng xác định cho dự án trên tất cả 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 thường được coi là một bí danh tiện lợi để tham chiếu đến dự án. (giá trị ví dụ: myapp-project-123)

• Mã ứng dụng ("AppID"): giá trị nhận dạng riêng biệt cho ứng dụng Firebase trên tất cả Firebase có định dạng dành riêng cho nền tảng:

  • Ứng dụng Firebase dành cho 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 Firebase dành cho Web: appId (giá trị ví dụ: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

Thận trọng: Chúng tôi không khuyến nghị sửa đổi tệp cấu hình hoặc đối tượng Firebase của ứng dụng theo cách thủ công. Nếu bạn khởi chạy một ứng dụng có giá trị không hợp lệ hoặc thiếu cho bất kỳ "tuỳ chọn Firebase" bắt buộc nào trong số này, thì người dùng cuối có thể gặp phải các vấn đề nghiêm trọng.

Nội dung của tệp cấu hình hoặc đối tượng Firebase được coi là công khai, bao gồm cả mã nhận dạng gói 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, như Khoá API, mã dự án, Realtime Database URL và Cloud Storage tên bộ chứa. Do đó, hãy sử 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 bạn nên đưa tệp cấu hình hoặc đối tượng cấu hình Firebase của ứng dụng vào hệ thống 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 họ (thông qua tệp cấu hình hoặc đối tượng cấu hình Firebase của riêng họ).

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

Quan trọng: Hãy nhớ đọc các phương pháp hay nhất chung của chúng tôi để thiết lập dự án Firebase. Hướng dẫn này trả lời các câu hỏi về hệ thống phân cấp dự án Firebase, cách đăng ký các biến thể ứng dụng và tính năng nhiều đối tượng thuê.

Dưới đây là một số giới hạn chung cho dự án, ứng dụng và trang web 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 khi liên kết tài khoản Cloud Billing đang ở trạng thái tốt.

  Xin lưu ý những điều sau về giới hạn hạn mức tạo dự án:

  • Giới hạn này không dành riêng cho Firebase. Giới hạn của Firebase về hạn mức dự án giống như giới hạn 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 đề xuất của Firebase để 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 từ góc độ người dùng cuối. Đọc thêm về tính năng nhiều đối tượng thuê trong tài liệu về các phương pháp hay nhất.

  Tìm hiểu thêm về giới hạn 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

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

Khởi chạy ứ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 bức tranh tổng thể về mức sử dụng của dự án trên nhiều dịch vụ Firebase.
• Xem lại danh sách kiểm tra khởi chạy Firebase.