瞭解 Firebase 專案

本頁將概略說明 Firebase 的幾個重要概念 Google Cloud 的 Resource Manager 工具 經特別設計,能以程式輔助方式協助您管理專案在適用情況下,點選連結即可進一步瞭解詳細資訊 功能、服務、工具和最佳做法。

Firebase 專案、應用程式和產品之間的關係

Firebase 專案是 Firebase 的頂層實體。在專案中,您可以 註冊您的 Apple、Android 或網頁應用程式。向開發人員註冊應用程式後 Firebase 則可讓您新增 Firebase SDK,數量不限 Firebase 產品,例如 Analytics Cloud FirestorePerformance MonitoringRemote Config

如要進一步瞭解這項程序,請參閱《入門指南》 平台指南:
iOS 以上版本 |Android 版 | 網頁 |Unity |C++ | Flutter。

瞭解 Firebase 專案的階層結構

這張圖表顯示 Firebase 專案的基本階層,包括
          專案及其註冊應用程式及其佈建資源
          服務 這張圖顯示 Firebase 專案的基本階層。重點則是 關係:

  • Firebase 專案就像一個容器,可容納所有應用程式和任何資源 和為專案佈建的服務

  • Firebase 專案可以註冊一或多個 Firebase 應用程式 (例如應用程式的 iOS 和 Android 版,或兩者皆是 應用程式的付費版本和付費版本)。

  • 所有與同一個 Firebase 專案註冊的 Firebase 應用程式都共用並擁有 可讓您使用為專案佈建的所有相同資源和服務。 例如:

    • 所有註冊至同一個 Firebase 專案的 Firebase 應用程式都會共用 後端,例如 Firebase HostingAuthenticationRealtime DatabaseCloud Firestore Cloud Storage,以及 Cloud Functions

    • 凡是註冊至同一個 Firebase 專案的 Firebase 應用程式,都會相互連結 使用同一項 Google Analytics 資源,而每項 Firebase 應用程式都是 然後在資源中另外建立資料串流

Firebase 專案和 Google Cloud 之間的關係

建立新的 Firebase 專案時,實際上會建立 Google Cloud 專案 幕後花絮您甚至可以先建立 Google Cloud 專案。 然後再將 Firebase 新增至專案您可以想出 Google Cloud 專案 可做為資料、程式碼、設定和服務的虛擬容器

請注意,Firebase 會自動為所有 Firebase 專案加上 firebase:enabled內的 標籤頁面Google Cloud.進一步瞭解這個標籤: 常見問題

由於 Firebase 專案「是」Google Cloud 專案:

設定 Firebase 專案及註冊應用程式

您可以在 Firebase控制台中設定 Firebase 專案並註冊應用程式 (如果是進階用途,則可以使用 Firebase Management REST APIFirebase CLI)。設定專案時 並註冊應用程式,因此需要製定機構決策 傳送至本機專案的 Firebase 專屬設定資訊。

在正式版應用程式中,需設定明確的開發工作流程 這通常涉及使用多種環境請參閱 開發人員工作流程 包含 一般最佳做法一般安全性指南 ,以便設定 Firebase 專案及註冊應用程式來建立開發項目 工作流程

與 Firebase 專案互動

除了產品 SDK 外,你還能直接與 Firebase 專案互動 提供多種不同的工具和介面

Firebase 個控制台

Firebase 控制台提供最豐富的 Firebase 管理環境 產品、應用程式和專案層級設定

<span class=Firebase 控制台 - 專案總覽畫面 class="attempt-right screenshot" style="max-width: calc((100% - 40px)/1.75);">

控制台的左側面板會列出 Firebase 產品,並按照 頂層類別在左側面板頂端存取專案的 設定 。專案的 設定包括 整合 存取權限 以及帳單

控制台中間會顯示用來啟動設定工作流程的按鈕 註冊各種類型的應用程式。開始使用 Firebase 後 控制台會變成資訊主頁,其中會顯示產品的統計資料 相關單位會如何運用資料,並讓他們覺得自己 獲得充分告知,且能夠針對該使用方式表示同意

請注意,由於 Firebase 專案也是 Google Cloud 專案,因此您可以 工作或產品需要使用 Google Cloud 控制台,而非 Firebase 控制台。

Firebase CLI (指令列工具)

Firebase 也提供 Firebase CLI,可用來設定和 管理特定 Firebase 產品,例如 Firebase Hosting Cloud Functions for Firebase,以及 Firebase Extensions

安裝 CLI 後,您就能存取 全域 firebase 指令。使用 CLI 即可 將本機應用程式目錄連結至 Firebase 專案,接著 部署 Firebase 託管內容的新版本,或 函式的更新

Firebase Management REST API

使用 Firebase Management REST API: 以程式輔助的方式管理 Firebase 專案舉例來說: 透過程式輔助方式向專案註冊應用程式,或列出 已註冊 (iOS 以上版本) | Android | 網頁)。

Firebase 專案 ID

Firebase 專案可在 Firebase 後端和多種位置識別 使用不同 ID 的開發人員介面,包括專案名稱專案編號專案 ID

專案名稱

建立專案時,您必須提供專案名稱。這個識別碼是 在資料集頁面中,專案的內部專用名稱 Firebase 控制台Google Cloud 控制台, 和 Firebase CLI。專案名稱未公開於任何 公開顯示的 Firebase 或 Google Cloud 項產品、服務或資源;該資料來源 只是方便您輕鬆分辨不同專案。

您可隨時在 專案 設定 Firebase 控制台。專案名稱會顯示在頂端窗格中。

專案編號

Firebase 專案 (及其 相關聯的 Google Cloud 專案) 具有 專案編號。這是 Google 指定的全域專屬標準網址 識別專案 ID。設定整合項目時請使用這個 ID 並且/或是向 Firebase、Google 或第三方服務發出 API 呼叫

您無法編輯專案編號。如果刪除專案,專案編號就會是 刪除,也無法再供其他專案使用。

專案 ID

Firebase 專案 (及其 相關聯的 Google Cloud 專案) 具有 專案 ID。這是使用者為專案 所有 Firebase 和 Google Cloud。建立 Firebase 專案時,Firebase 自動指派專屬 ID 給專案 專案設定這個 ID 通常應視為方便使用 參照專案的別名

Firebase 設定檔和物件

使用 Firebase 專案註冊應用程式時,Firebase 控制台 會提供 Firebase 設定檔 (Apple/Android 應用程式) 或設定 物件 (網頁應用程式) 直接加入本機應用程式目錄

  • 如果是 Apple 應用程式,請新增 GoogleService-Info.plist 設定檔。
  • 如果是 Android 應用程式,則需新增 google-services.json 設定檔。
  • 如果是網頁應用程式,請加入 Firebase 設定物件。

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

Firebase 設定檔或物件會將應用程式與特定 Firebase 建立關聯 專案及其資源 (資料庫、儲存空間值區等)設定 包含「Firebase 選項」,這是 Firebase 和 用來與 Firebase 伺服器 API 通訊以及建立用戶端關聯的 Google 服務 與 Firebase 專案和 Firebase 應用程式共用資料以下列出最低和最低 「Firebase 選項」:

  • API 金鑰:簡單的 呼叫無須存取的特定 API 時使用的加密字串 使用者私人資料 (範例值:AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • 專案 ID:使用者定義的 Firebase 和 Google Cloud 中專案的專屬 ID。 部分 Firebase 資源的網址或名稱可能會顯示這個 ID,但 這應該視為方便參照的別名, 專案。(範例值:myapp-project-123)

  • Application ID (「AppID」):Firebase 應用程式的專屬 ID 和所有 Firebase 之間互動的方式:

    • Firebase Apple 應用程式:GOOGLE_APP_ID (範例值: 1:1234567890:ios:321abc456def7890)
      這組 ID「不是」 Apple 軟體包 ID。
    • Firebase Android 應用程式:mobilesdk_app_id (範例值: 1:1234567890:android:321abc456def7890)
      這「不是」Android 套件名稱或 Android 應用程式 ID。
    • Firebase 網頁應用程式:appId (範例值: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
,瞭解如何調查及移除這項存取權。

Firebase 設定檔或物件的內容視為公開 ,包括應用程式的平台專屬 ID (Apple 軟體包 ID 或 Android 套件名稱) 和 Firebase 專案專屬值,例如 API 金鑰、專案 ID Realtime Database 網址和 Cloud Storage 值區名稱。有鑑於此 使用Firebase Security Rules保護您在 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 應用程式都必須是 從使用者的角度來看, 同一個應用程式的平台變化版本。已讀 進一步瞭解 多用戶群架構

    如想進一步瞭解來電目錄、轉接和錄音服務政策, 常見問題中的每個專案的應用程式數量上限

  • 每項專案 Hosting 個網站數

    Firebase Hosting 多網站功能 每項專案最多支援 36 個網站。

啟動應用程式