您可以使用 Firebase 控制台或Firebase CLI (命令行界面)安裝(和管理)任何官方 Firebase 擴展。
請務必查看 Firebase CLI 和 Firebase 控制台支持的操作的差異。
要安裝或管理擴展程序,您必須被分配以下角色之一: Owner 或 Editor或Firebase Admin 。
要安裝擴展,您的項目必須採用Blaze (即用即付)計劃。雖然安裝擴展程序是免費的,但如果您的使用量超過服務的免費套餐,您可能需要為使用 Firebase 服務或 [Cloud Secret Manager][secret-pricing] 等雲服務付費。
在你開始之前
如果您還沒有,請將 Firebase 添加到您的項目並將您的 Firebase 項目升級到Blaze (即用即付)計劃。
第 1 步:查看有關擴展的詳細信息
此步驟是可選的,但強烈推薦。
在安裝 Firebase 擴展之前,我們建議您查看有關擴展的詳細信息,包括:
查看擴展的詳細信息:
從以下來源瀏覽官方 Firebase 擴展:
單擊擴展程序的卡片以:
顯示擴展的詳細信息。
在Firebase 擴展源代碼庫中找到擴展源代碼的鏈接。
在擴展的擴展目錄中,您可以在
README
中查看此詳細信息。
第 2 步:安裝擴展程序
在安裝過程中,系統會提示您查看擴展的基本規範(例如啟用的 API、創建的資源、授予的訪問權限等)。您將收到任何計費要求的通知,並且還會提示您為擴展程序的可配置參數指定值。
從以下來源瀏覽官方 Firebase 擴展:
單擊擴展卡,然後查看擴展的詳細信息,其中可以提供特定的使用說明和任何預安裝任務。
單擊安裝,然後按照屏幕上的說明安裝擴展程序。
第 3 步:完成安裝後設置
某些擴展在使用前需要或可選步驟供您完成。在 Firebase 控制台的 Extensions 儀表板的擴展程序安裝後詳細信息頁面中找到這些說明(儀表板的特定鏈接在安裝後顯示在終端中)。
您還可以在擴展的源目錄中包含的POSTINSTALL.md
文件中找到這些說明。
創建 Firebase 資源
如果您將擴展配置為使用尚不存在的 Firebase 資源(Cloud Firestore 集合、實時數據庫路徑、Cloud Storage 存儲分區),請在使用擴展之前創建它們。
創建 Eventarc 事件處理程序
當執行期間發生重要事件時,一些擴展會發佈到Eventarc 。如果擴展發布事件並且您在安裝期間啟用了事件,您可以編寫使用您自己的自定義邏輯對這些事件做出反應的函數。這可能很有用,例如,在長時間運行的任務完成時通知用戶,或對擴展函數的輸出進行後處理。
有關它發布的事件列表(如果有),請參閱擴展的文檔。
然後,請參閱自定義事件觸發器以獲取有關編寫 Eventarc 事件處理程序的信息。
安裝多個擴展實例
您可以在同一個項目中多次安裝相同的擴展。每個安裝的實例都可以有自己的自定義配置和自己的擴展資源。您可以使用實例 ID識別並引用每個已安裝的實例,該實例 ID 在您的項目中是唯一的。系統將提示您確認或編輯您安裝的每個附加擴展實例的實例 ID。
下一步
在 Firebase 控制台中查看已安裝擴展程序的詳細信息和配置。
監控已安裝擴展程序的活動,包括檢查其運行狀況、使用情況和日誌。
使用 Firebase 控制台管理已安裝的擴展程序。對於官方 Firebase 擴展,您可以重新配置或卸載擴展,以及將擴展更新到最新版本。
作為所有項目的最佳做法,請務必為您的項目設置預算提醒,並在 Firebase 控制台中監控您的使用情況和計費信息中心。