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

了解 Firebase 項目

本頁簡要概述了有關 Firebase 項目的幾個重要概念。如果可用，請點擊鏈接查找有關功能、服務、工具和最佳實踐的更多詳細信息。

Firebase 項目、應用程序和產品之間的關係

Firebase 項目是 Firebase 的頂級實體。在項目中，您可以註冊您的 Apple、Android 或 Web 應用程序。在向 Firebase 註冊您的應用程序後，您可以為任意數量的Firebase 產品添加 Firebase SDK，例如 Analytics、Cloud Firestore、Performance Monitoring 或 Remote Config。

在適用於您的平台的入門指南中了解有關此過程的更多詳細信息：
iOS+ |安卓|網頁|團結| C++ |顫振。

了解 Firebase 項目的層次結構

顯示 Firebase 項目的基本層次結構的圖表，包括項目、其註冊的應用程序及其配置的資源和服務此圖顯示了 Firebase 項目的基本層次結構。以下是關鍵關係：

  • Firebase 項目就像是您所有應用程序以及為該項目配置的任何資源和服務的容器。

  • 一個 Firebase 項目可以註冊一個或多個Firebase 應用程序（例如，一個應用程序的 iOS 和 Android 版本，或者一個應用程序的免費和付費版本​​）。

  • 註冊到同一個 Firebase 項目的所有 Firebase 應用程序共享並可以訪問為該項目配置的所有相同資源和服務。這裡有些例子：

    • 註冊到同一 Firebase 項目的所有 Firebase 應用共享相同的後端，例如 Firebase 託管、身份驗證、實時數據庫、Cloud Firestore、Cloud Storage 和 Cloud Functions。

    • 註冊到同一個 Firebase 項目的所有 Firebase 應用程序都與同一個 Google Analytics 屬性相關聯，其中每個 Firebase 應用程序都是該屬性中的一個單獨的數據流。

Firebase 項目與 Google Cloud 之間的關係

當您創建一個新的 Firebase 項目時，您實際上是在幕後創建一個Google Cloud 項目。您甚至可以先創建一個 Google Cloud 項目，然後再將 Firebase 添加到該項目中。您可以將 Google Cloud 項目視為數據、代碼、配置和服務的虛擬容器。

請注意，對於所有 Firebase 項目，Firebase 會自動在 Google Cloud Console 的項目標籤頁面中添加firebase:enabled標籤。在我們的常見問題解答中了解有關此標籤的更多信息。

由於 Firebase 項目是Google Cloud 項目：

設置 Firebase 項目並註冊應用

您可以在Firebase 控制台中設置 Firebase 項目並註冊應用程序（或者，對於高級用例，通過Firebase Management REST API或Firebase CLI ）。當您設置項目並註冊應用程序時，您需要做出一些組織決策並將特定於 Firebase 的配置信息添加到您的本地項目。

對於生產應用程序，您需要設置清晰的開發工作流程，這通常涉及使用多個環境。查看我們關於開發人員工作流程的文檔，包括用於設置 Firebase 項目和註冊應用程序以創建開發工作流程的一般最佳實踐和一般安全準則。

與 Firebase 項目交互

除了產品 SDK 之外，您還可以使用多種不同的工具和界面直接與 Firebase 項目交互。

Firebase 控制台

Firebase 控制台為管理 Firebase 產品、應用程序和項目級設置提供了最豐富的環境。

Firebase 控制台 - 項目概覽屏幕

控制台的左側面板列出了按頂級類別組織的 Firebase 產品。在左側面板的頂部，通過單擊 。項目的設置包括integrations 、 access permissions和billing 。

控制台的中間顯示啟動設置工作流程以註冊各種類型的應用程序的按鈕。開始使用 Firebase 後，控制台的主要區域會變成一個儀表板，顯示您使用的產品的統計信息。

請注意，由於 Firebase 項目也是 Google Cloud 項目，您可能會發現各種任務或產品需要您使用 Google Cloud Console 而不是 Firebase 控制台。

Firebase CLI（命令行工具）

Firebase 還提供Firebase CLI ，用於配置和管理特定的 Firebase 產品，例如 Firebase 託管、Firebase 雲功能和 Firebase 擴展。

安裝 CLI 後，您可以訪問全局firebase命令。使用 CLI將您的本地應用程序目錄鏈接到 Firebase 項目，然後部署新版本的 Firebase 託管內容或功能更新。

Firebase 管理 REST API

使用Firebase Management REST API ，您可以以編程方式管理 Firebase 項目。例如，您可以通過編程方式向項目註冊應用程序或列出已註冊的應用程序 ( iOS+ | Android | web )。

Firebase 項目標識符

Firebase 項目可以在 Firebase 後端和各種開發人員界面中使用不同的標識符來標識，包括項目名稱、項目編號和項目 ID 。

項目名稱

創建項目時，您提供項目名稱。此標識符是Firebase 控制台、 Google Cloud Console和Firebase CLI中項目的內部專用名稱。項目名稱未在任何公開可見的 Firebase 或 Google Cloud 產品、服務或資源中公開；它只是幫助您更輕鬆地區分多個項目。

您可以隨時在 Firebase 控制台的項目設置編輯項目名稱。項目名稱顯示在頂部窗格中。

項目編號

Firebase 項目（及其關聯的 Google Cloud 項目）有一個項目編號。這是 Google 為項目分配的全球唯一規範標識符。在配置集成和/或對 Firebase、Google 或第三方服務進行 API 調用時使用此標識符。

您不能編輯項目編號。如果刪除一個項目，項目編號也將被刪除，並且再也不能被任何其他項目使用。

項目編號

Firebase 項目（及其關聯的 Google Cloud 項目）有一個項目 ID 。這是用戶為整個 Firebase 和 Google Cloud 中的項目定義的唯一標識符。當您創建 Firebase 項目時，Firebase 會自動為項目分配一個唯一 ID，但您可以在項目設置期間對其進行編輯。此標識符通常應被視為引用項目的方便別名。

Firebase 配置文件和對象

當您向 Firebase 項目註冊應用程序時，Firebase 控制台會提供一個 Firebase 配置文件（Apple/Android 應用程序）或一個配置對象（Web 應用程序），您可以將其直接添加到本地應用程序目錄。

  • 對於 Apple 應用程序，您添加一個GoogleService-Info.plist配置文件。
  • 對於 Android 應用程序，您添加一個google-services.json配置文件。
  • 對於網絡應用程序，您添加一個 Firebase 配置對象。

您可以隨時獲取應用的 Firebase 配置文件或對象。

Firebase 配置文件或對象將應用程序與特定的 Firebase 項目及其資源（數據庫、存儲桶等）相關聯。配置包括“Firebase 選項”，這是 Firebase 和 Google 服務與 Firebase 服務器 API 通信以及將客戶端數據與 Firebase 項目和 Firebase 應用相關聯所需的參數。以下是必需的、最低限度的“Firebase 選項”：

  • API 密鑰：調用某些不需要訪問私人用戶數據的 API 時使用的簡單加密字符串（示例值： AIzaSyDOCAbC123dEf456GhI789jKl012-MnO ）

  • 項目 ID ：用戶定義的項目在所有 Firebase 和 Google Cloud 中的唯一標識符。此標識符可能出現在某些 Firebase 資源的 URL 或名稱中，但通常應將其視為引用項目的方便別名。 （示例值： myapp-project-123 ）

  • 應用程序 ID（“AppID”） ：Firebase 應用程序在所有 Firebase 中的唯一標識符，具有特定於平台的格式：

    • Firebase Apple 應用程序： GOOGLE_APP_ID （示例值： 1:1234567890:ios:321abc456def7890 ）
      這不是Apple 捆綁 ID。
    • Firebase Android 應用程序： mobilesdk_app_id （示例值： 1:1234567890:android:321abc456def7890 ）
      這不是Android 包名稱或 Android 應用程序 ID。
    • Firebase Web 應用程序： appId （示例值： 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c ）

Firebase 配置文件或對象的內容被認為是公開的，包括應用的平台特定 ID（Apple 包 ID 或 Android 包名稱）和 Firebase 項目特定值，如 API 密鑰、項目 ID、實時數據庫 URL 和Cloud Storage 存儲桶名稱。鑑於此，請使用 Firebase 安全規則來保護實時數據庫、 Cloud Firestore和Cloud Storage中的數據和文件。

對於開源項目，我們通常不建議在源代碼管理中包含應用的 Firebase 配置文件或對象，因為在大多數情況下，您的用戶應該創建自己的 Firebase 項目並將他們的應用指向他們自己的 Firebase 資源（通過他們自己的 Firebase 配置文件或對象）。

Firebase 項目、應用和網站的一般限制

以下是 Firebase 項目、應用和網站的一些一般限制：

  • 每個帳戶的項目數

    • Spark 定價計劃——項目創建配額僅限於較少數量的項目（通常在 5-10 個左右）。
    • Blaze 定價計劃——只要關聯的 Cloud Billing 賬戶信譽良好，每個賬戶的項目創建配額就會大幅增加。

    大多數開發者很少關心項目創建配額的限制，但如果需要，您可以請求增加項目配額。

    請注意，完全刪除項目需要 30 天，並且會計入項目配額，直到項目被完全刪除。

  • 每個項目的應用數量

    Firebase 將 Firebase 項目中的 Firebase 應用程序總數限制為 30。

    從最終用戶的角度來看，您應該確保單個 Firebase 項目中的所有 Firebase 應用程序都是同一應用程序的平台變體。在我們的最佳實踐文檔中閱讀有關多租戶的更多信息。

    在常見問題解答中詳細了解每個項目的應用程序限制。

  • 每個項目的託管站點數量

    Firebase 託管多站點功能支持每個項目最多 36 個站點。

啟動您的應用程序