Catch up on highlights from Firebase at Google I/O 2023. Learn more

安裝 Firebase 擴展

您可以使用 Firebase 控制台或Firebase CLI (命令行界面)安裝(和管理)任何官方 Firebase 擴展。

請務必查看 Firebase CLI 和 Firebase 控制台支持的操作的差異


要安裝或管理擴展程序,您必須被分配以下角色之一: Owner 或 EditorFirebase Admin

要安裝擴展,您的項目必須採用Blaze (現收現付)計劃。雖然安裝擴展程序是免費的,但如果您的使用量超過服務的免費套餐,您可能會因使用 Firebase 服務或Cloud Secret Manager等雲服務而付費。

在你開始之前

  1. 如果您還沒有,請將 Firebase 添加到您的項目中

  2. 如果您還沒有,請將您的項目升級到Blaze (現收現付)計劃。

  3. 安裝或更新到最新版本的 Firebase CLI。

  4. 記下您的 Firebase 項目 ID 或之前配置的項目別名。

    • 項目 ID — 從您計算機上的任何位置運行firebase projects:list
    • 項目別名- 從本地應用程序目錄運行firebase use

第一步:查看擴展的詳細信息

此步驟是可選的,但強烈推薦。

在安裝 Firebase 擴展程序之前,我們建議您查看有關該擴展程序的詳細信息,包括:

  • 擴展的工作原理、任何預安裝任務以及有關擴展的詳細信息
  • 一般識別信息和描述
  • 擴展程序的任務是否需要計費帳戶
  • 操作所需的 Google 服務 (API) 和訪問角色
  • 為擴展創建的資源(如函數)
  • 用戶可配置參數說明

查看分機的詳細信息:

  1. 確保您已經設置好您的環境選擇了一個擴展

  2. 從計算機上的任何位置運行 extension-info 命令:

    firebase ext:info publisher-id/extension-id

    publisher-idextension-id參數是必需的,可以在擴展的預安裝詳細信息頁面上找到。

第 2 步:安裝擴展

在安裝過程中,系統會提示您查看擴展的基本規範(例如啟用的 API、創建的資源、授予的訪問權限等)。您將收到任何計費要求的通知,並且還會提示您為擴展程序的可配置參數指定值。

  1. 確保您已經設置好您的環境選擇了一個擴展

  2. 在您的本地 Firebase 目錄中,運行擴展安裝命令。如果出現提示,請輸入參數值以自定義擴展實例。

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-idextension-id參數是必需的,可以在擴展的預安裝詳細信息頁面上找到。

    運行此命令會​​將一個擴展實例添加到您的擴展清單中。

  3. 然後,要將清單中的擴展部署到 Firebase 項目,請運行:

    firebase deploy --only extensions --project=projectId-or-alias

第 3 步:完成安裝後設置

某些擴展程序具有必需或可選的步驟供您在使用前完成。在 Firebase 控制台的擴展儀表板的擴展安裝後詳細信息頁面中找到這些說明(儀表板的特定鏈接在安裝後顯示在終端中)。

您還可以在擴展源目錄中包含的POSTINSTALL.md文件中找到這些說明。

創建 Firebase 資源

如果您將擴展程序配置為使用尚不存在的 Firebase 資源(Cloud Firestore 集合、實時數據庫路徑、Cloud Storage 存儲桶),請在使用擴展程序之前創建它們。

創建 Eventarc 事件處理程序

當執行期間發生重要事件時,一些擴展會發佈到Eventarc 。如果擴展發布事件並且您在安裝期間啟用了事件,則您可以編寫使用您自己的自定義邏輯對這些事件做出反應的函數。這可能很有用,例如,在長時間運行的任務完成時通知用戶,或對擴展函數的輸出進行後處理。

有關它發布的事件列表(如果有),請參閱擴展的文檔。例如,請參閱Run Payments with Stripe 擴展的事件類型

然後,請參閱自定義事件觸發器以獲取有關編寫 Eventarc 事件處理程序的信息。

安裝多個擴展實例

您可以在同一個項目中多次安裝同一個擴展。每個已安裝的實例都可以有自己的自定義配置和擴展資源。您使用實例 ID標識和引用每個已安裝的實例,該實例在您的項目中是唯一的。系統將提示您確認或編輯您安裝的每個附加擴展實例的實例 ID。

下一步