了解 Firebase 項目

本頁面簡要概述了有關 Firebase 專案的幾個重要概念。如果可用，請點擊連結以找到有關功能、服務、工具和最佳實踐的更多詳細資訊。

Firebase 專案、應用與產品之間的關係

Firebase 專案是 Firebase 的頂級實體。在專案中，您可以註冊 Apple、Android 或 Web 應用程式。向 Firebase 註冊應用程式後，您可以為任意數量的Firebase 產品（例如 Analytics、Cloud Firestore、效能監控或遠端設定）新增 Firebase SDK。

在適用於您的平台的入門指南中了解有關此過程的更多詳細資訊：
iOS+ |安卓|網路|團結| C++ |撲騰。

了解 Firebase 專案的層次結構

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

  • Firebase 專案就像一個容器，包含所有應用程式以及為該專案配置的任何資源和服務。

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

  • 註冊到相同 Firebase 專案的所有 Firebase 應用程式共用並有權存取為該專案配置的所有相同資源和服務。這裡有些例子：

    • 註冊到相同 Firebase 專案的所有 Firebase 應用程式共用相同的後端，例如 Firebase 託管、身份驗證、即時資料庫、Cloud Firestore、雲端儲存和雲端功能。

    • 註冊到相同 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 產品，按頂級類別組織。在左側面板的頂部，透過點擊來存取項目的設定。項目的設定包括整合、存取權限和計費。

控制台中間顯示按鈕，用於啟動設定工作流程以註冊各種類型的應用程式。開始使用 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 後端和各種開發人員介面中使用不同的識別碼（包括專案名稱、專案編號和專案 ID）來識別 Firebase 專案。

項目名稱

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

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

項目編號

Firebase 專案（及其關聯的 Google Cloud 專案）有一個專案編號。這是 Google 為該專案分配的全球唯一規範識別碼。配置整合和/或對 Firebase、Google 或第三方服務進行 API 呼叫時，請使用此識別碼。

您無法編輯項目編號。如果刪除項目，項目編號也會被刪除，並且永遠不能再被任何其他項目使用。

專案ID

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設定檔。
  • 對於 Web 應用，您可以新增 Firebase 設定物件。

您可以隨時取得應用程式的 Firebase 設定檔 或 object 。

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 安全性規則來保護Realtime Database 、 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 個網站。

啟動您的應用程式