Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Hiểu các dự án Firebase

Trang này cung cấp tổng quan ngắn gọn về một số khái niệm quan trọng về các dự án Firebase. Khi có sẵn, hãy nhấp vào 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ụ và thậm chí cả các nền tảng khác. Ở cuối trang này, hãy tìm danh sách các phương pháp hay nhất chung cho các dự án Firebase.

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 tạo ứng dụng Firebase bằng cách đăng ký ứng dụng iOS, Android hoặc web của mình. Sau khi đă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 ( iOS | Android | web | Unity | C ++ ).

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

Khi bạn tạo một dự án Firebase mới trong bảng điều khiển Firebase, bạn thực sự đang tạo một dự án Google Cloud Platform (GCP) đằng sau hậu trường. Bạn có thể coi dự án GCP như một vùng chứa ảo cho dữ liệu, mã, cấu hình và dịch vụ. Dự án Firebase là một dự án GCP có các cấu hình và dịch vụ bổ sung dành riêng cho Firebase. Bạn thậm chí có thể tạo dự án GCP trước, sau đó thêm Firebase vào dự án sau.

Vì dự án Firebase là dự án GCP:

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 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 địa phương của mình.

Đảm bảo xem xét một số phương pháp hay nhất cấp dự án chung (ở cuối trang này) trước khi thiết lập dự án và đăng ký ứng dụng.

Tên dự án

Khi bạn tạo một dự án, bạn cung cấp tên dự án . Giá trị nhận dạng này là tên chỉ nội bộ cho một dự án trong bảng điều khiển Firebase , bảng điều khiển GCP 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 Firebase hoặc GCP nào hiển thị công khai; 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 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 GCP liên quan ) có số dự án . Đây là số 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 mã 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.

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

Đối với nhiều lệnh gọi API, bạn cần bao gồm một số nhận dạng duy nhất cho một dự án. Mặc dù nhiều API chấp nhận ID dự án , nhưng bạn nên sử dụng số dự án để 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.

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

Tìm số dự án

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

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

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

ID dự án

Dự án Firebase (và dự án GCP liên quan ) có một ID dự án . Đây là số nhận dạng duy nhất do người dùng xác định cho dự án trên tất cả Firebase và GCP. Khi bạn tạo một 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 nó trong quá trình thiết lập dự án. Thông thường, mã định danh này nên được coi như một bí danh tiện lợi để tham chiếu đến dự án.

Nếu bạn xóa một dự án, ID 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.

Tài nguyên Firebase và ID dự án

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

  • PROJECT_ID .web.app phụ Lưu trữ mặc định - PROJECT_ID .web.app và PROJECT_ID .firebaseapp.com
  • URL cơ sở dữ liệu thời gian thực mặc định - PROJECT_ID .firebaseio.com
  • Tên nhóm Bộ nhớ đám mây mặc định - PROJECT_ID .appspot.com

Đối với tất cả các tài nguyên nói trên, bạn có thể tạo các phiên bản không phải mặc định. Các tên hiển thị công khai của không mặc định có thể tùy chỉnh hoàn toàn. Bạn có thể kết nối các miền tùy chỉnh với trang web được lưu trữ trên Firebase, chia nhỏ Cơ sở dữ liệu thời gian thực và tạo nhiều nhóm Bộ nhớ đám mây (truy cập trang Bắt đầu dành riêng cho nền tảng).

Firebase CLI và ID 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 tình huống này, khi bạn sử dụng Firebase CLI , bạn cần chuyển cờ --project cùng với các lệnh firebase để thông báo bạn muốn tương tác với dự án Firebase nào.

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ớ ID dự án.

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

Đối với nhiều lệnh gọi API, bạn cần bao gồm một số nhận dạng duy nhất cho một dự án. Mặc dù nhiều API chấp nhận ID dự án, nhưng bạn nên sử dụng số dự án để 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.

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

Tìm ID dự án

  • Bảng điều khiển Firebase: Nhấp vào dự án . ID dự án được hiển thị trong ngăn trên cùng.

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

  • API REST quản lý Firebase: Gọi projects.list . Nội dung phản hồi chứa ID dự án trong đối tượng FirebaseProject .

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

  • 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 người dùng riêng tư (giá trị ví dụ: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • ID dự án : số nhận dạng duy nhất do người dùng xác định cho dự án trên tất cả Firebase và GCP. 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ị ví dụ: myapp-project-123 )

  • ID ứng dụng ("AppID") : số nhận dạng 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 iOS: GOOGLE_APP_ID (giá trị mẫu: 1:1234567890:ios:321abc456def7890 )
      Đây không phải là một ID gói Apple.
    • Ứng dụng Firebase Android: mobilesdk_app_id (ví dụ giá trị: 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 tệp hoặc đối tượng 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 iOS 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 nhóm lưu trữ. Do đó, hãy 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 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 bao gồm tệp hoặc đối tượng cấu hình Firebase của ứng dụng trong 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 cấu hình Firebase của riêng họ tệp hoặc đối tượng).

Quản lý dự án Firebase

Đảm bảo xem lại các phương pháp hay nhất chung ở cấp dự án (ở cuối trang này) để biết những cân nhắc có thể ảnh hưởng đến cách bạn quản lý dự án Firebase.

Các công cụ để quản lý một dự án

Bảng điều khiển 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à 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 .

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

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 Firebase cụ thể, như Lưu trữ Firebase và Chức năng đám mây cho Firebase.

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

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

Các phương pháp hay nhất chung

Thêm ứng dụng vào dự án

Đảm bảo rằng tất cả các ứng dụng trong một dự án 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. Bạn nên đăng ký phiên bản iOS, Android và web của cùng một ứng dụng hoặc trò chơi với cùng một dự án Firebase. Tất cả các ứng dụng trong một dự án thường chia sẻ cùng một tài nguyên Firebase (cơ sở dữ liệu, nhóm lưu trữ, v.v.).

Nếu bạn có nhiều biến thể bản dựng với các ID gói iOS hoặc tên gói Android khác nhau được xác định, bạn có thể đăng ký từng biến thể với một dự án Firebase riêng biệt. Tuy nhiên, nếu bạn có các biến thể mà phần các nguồn lực căn cứ hỏa lực cùng, đăng ký với dự án căn cứ hỏa lực tương tự.

Mặc dù không có giới hạn về số lượng ứng dụng trong một dự án, nhưng việc đăng ký một ứng dụng có thể tạo một hoặc nhiều ID ứng dụng khách OAuth 2.0 cơ bản. Có giới hạn khoảng 30 ID khách hàng có thể được tạo trong một dự án.

Thuê nhiều kiểu

Không nên kết nối nhiều ứng dụng và / hoặc trang web độc lập về mặt logic khác nhau với một dự án duy nhất (thường được gọi là "cho thuê nhiều lần"). Việc cho thuê nhiều lần có thể dẫn đến các vấn đề nghiêm trọng về cấu hình và quyền riêng tư dữ liệu, bao gồm các vấn đề ngoài ý muốn với tổng hợp phân tích, xác thực được chia sẻ, cấu trúc cơ sở dữ liệu quá phức tạp và khó khăn với các quy tắc bảo mật.

Nói chung, nếu một tập hợp các ứng dụng không chia sẻ cùng một dữ liệu và cấu hình, hãy cân nhắc kỹ lưỡng việc đăng ký từng ứng dụng với một dự án Firebase khác nhau.

Ví dụ: nếu bạn phát triển ứng dụng nhãn trắng, mỗi ứng dụng được gắn nhãn độc lập phải có dự án Firebase riêng. Mỗi ứng dụng không và không nên (vì lý do bảo mật) chia sẻ dữ liệu với những ứng dụng khác.

Lưu ý 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 Spark cấp miễn phí - Hạn ngạch tạo dự án được giới hạn ở số lượng dự án thấp hơn (thường là khoảng 5-10).
    • Gói trả phí - Hạn ngạch tạo dự án trên mỗi tài khoản thanh toán tăng lên đáng kể 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 ngạch tạo dự án hiếm khi là mối quan tâm 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 ngạch dự án .

    Lưu ý rằng việc xóa hoàn toàn một 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 cho mỗi dự án

    Mặc dù không có giới hạn về số lượng ứng dụng trong một dự án, nhưng việc đăng ký một ứng dụng có thể tạo một hoặc nhiều ID ứng dụng khách OAuth 2.0 cơ bản. Có giới hạn khoảng 30 ID khách hàng có thể được tạo trong một dự án.

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

    Tính năng đa trang của 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