Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

了解 Firebase 項目

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

Firebase 項目是 Firebase 的頂級實體。在項目中,您可以註冊您的 Apple、Android 或 Web 應用程序。向 Firebase 註冊應用後,您可以為任意數量的Firebase 產品添加 Firebase SDK,例如 Analytics、Cloud Firestore、性能監控或遠程配置。

在您的平台的入門指南中了解有關此過程的更多詳細信息:
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 項目Google Cloud 項目:

設置 Firebase 項目並註冊應用

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

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

與 Firebase 項目交互

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

Firebase 控制台

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

Firebase 控制台 - 項目概覽屏幕

控制台的左側面板列出了按頂級類別組織的 Firebase 產品。在左側面板的頂部,通過單擊訪問項目的設置。項目的設置包括集成訪問權限計費

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

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

Firebase CLI(命令行工具)

Firebase 還提供用於配置和管理特定 Firebase 產品的Firebase CLI ,例如 Firebase 託管、Firebase 的 Cloud Functions 和 Firebase 擴展。

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

Firebase 管理 REST API

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

Firebase 項目標識符

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

項目名稱

創建項目時,您提供項目名稱。此標識符是Firebase 控制台Google Cloud ConsoleFirebase 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 應用程序)或配置對象(網絡應用程序)。

  • 對於 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 FirestoreCloud Storage中的數據和文件。

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

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

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

  • 每個帳戶的項目數

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

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

    請注意,完全刪除項目需要 30 天,併計入項目配額,直到項目被完全刪除。

  • 每個項目的應用程序數量

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

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

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

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

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

啟動您的應用程序