本頁簡要概述了有關 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 應用程序(例如,一個應用程序的 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 控制台以及Google Cloud Console和Google APIs 控制台中與項目交互。
您可以在項目中同時使用 Firebase 和 Google Cloud 的產品和 API。
刪除項目會在 Firebase 和 Google Cloud 中刪除它。
設置 Firebase 項目並註冊應用
您可以在Firebase 控制台中設置 Firebase 項目並註冊應用程序(或者,對於高級用例,通過Firebase Management REST API或Firebase CLI )。當您設置項目並註冊應用程序時,您需要做出一些組織決策並將特定於 Firebase 的配置信息添加到您的本地項目。
對於生產應用程序,您需要設置清晰的開發工作流程,這通常涉及使用多個環境。查看我們關於開發人員工作流程的文檔,包括用於設置 Firebase 項目和註冊應用程序以創建開發工作流程的一般最佳實踐和一般安全準則。
與 Firebase 項目交互
除了產品 SDK 之外,您還可以使用多種不同的工具和界面直接與 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 項目的項目編號:
使用 Firebase 控制台: 單擊項目設置。項目編號顯示在頂部窗格中。
使用 Firebase CLI :運行
firebase projects:list
。項目編號與與您的帳戶關聯的所有 Firebase 項目一起顯示。使用 Firebase Management REST API :調用
projects.list
。響應正文包含FirebaseProject
對像中的項目編號。
對於許多 API 調用,您需要包含項目的唯一標識符。儘管許多 API 都接受項目 ID ,但建議您使用項目編號對 Firebase、Google 或第三方服務進行 API 調用。
詳細了解如何在 Google 的AIP 2510 標準中使用項目標識符,尤其是項目編號。
項目編號
Firebase 項目(及其關聯的 Google Cloud 項目)有一個項目 ID 。這是用戶為整個 Firebase 和 Google Cloud 中的項目定義的唯一標識符。當您創建 Firebase 項目時,Firebase 會自動為項目分配一個唯一 ID,但您可以在項目設置期間對其進行編輯。此標識符通常應被視為引用項目的方便別名。
使用以下選項之一查找您的 Firebase 項目的項目 ID :
使用 Firebase 控制台: 單擊項目設置。項目 ID 顯示在頂部窗格中。
使用 Firebase CLI :運行
firebase projects:list
。項目 ID 與與您的帳戶關聯的所有 Firebase 項目一起顯示。使用 Firebase Management REST API :調用
projects.list
。響應正文包含FirebaseProject
對像中的項目 ID。
項目 ID 顯示在公開可見的 Firebase 資源中,例如:
- 默認託管子域 —
PROJECT_ID .web.app
和PROJECT_ID .firebaseapp.com
- 默認實時數據庫 URL —
PROJECT_ID -default-rtdb.firebaseio.com
或PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- 默認 Cloud Storage 存儲桶名稱 -
PROJECT_ID .appspot.com
對於上述所有資源,您可以創建非默認實例。非默認值的公開可見名稱是完全可定制的。您可以將自定義域連接到 Firebase 託管的站點,對實時數據庫進行分片,並創建多個雲存儲桶(訪問特定於平台的入門頁面)。
對於某些用例,您可能有多個 Firebase 項目與同一個本地應用程序目錄相關聯。在這些情況下,當您使用Firebase CLI時,您需要將--project
標誌與firebase
命令一起傳遞,以傳達您想要與之交互的 Firebase 項目。
您還可以為每個 Firebase 項目設置一個項目別名,這樣您就不必記住項目 ID。
對於許多 API 調用,您需要包含項目的唯一標識符。儘管許多 API 都接受項目 ID,但建議您使用項目編號對 Firebase、Google 或第三方服務進行 API 調用。
詳細了解如何在 Google 的AIP 2510 標準中使用項目標識符,尤其是項目編號。
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 Apple 應用程序:
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 個站點。
啟動您的應用程序
- 在 Google Cloud Console 中為您的項目設置預算提醒。
- 監控 Firebase 控制台中的使用情況和計費儀表板,以全面了解您的項目在多個 Firebase 服務中的使用情況。
- 查看Firebase 啟動清單。