安裝 Firebase 擴充功能

您可以安裝 (及管理) 任何使用 Firebase 控制台 Firebase CLI (指令列介面)。

請務必詳閱差異 Firebase CLI 和 Firebase 控制台支援的動作。

如要安裝或管理擴充功能，您必須指派下列其中一個角色：擁有者或編輯者或 Firebase 管理員：

如要安裝擴充功能，專案必須採用 Blaze (即付即用方案) 前往) 計畫。雖然安裝擴充功能不必付費，但你可能要您必須支付使用 Firebase 服務或 Cloud 服務 (例如 Cloud Secret Manager (如果您的用量超過服務)免費級別。

事前準備

如果您尚未將 Firebase 新增至專案，請先完成這項作業。
如果您尚未將專案升級至 Blaze (即付即用)，前往) 計畫。
安裝或更新至新版的 Firebase CLI。
記下 Firebase 專案 ID 或先前設定的項目專案別名。
- 專案 ID - 執行從電腦的任何位置存取 firebase projects:list。
- 專案別名 - 執行本機應用程式目錄中的 firebase use。
注意： 如要使用 CLI 指令安裝及管理擴充功能，您必須具有與本機應用程式目錄相關聯的 Firebase 專案。如果發生以下情況：如果尚未設定，請執行 firebase init 來設定本機 Firebase 目錄。

這是選擇性步驟，但強烈建議執行。

安裝 Firebase 擴充功能前，建議您查看擴充功能的詳細資訊，包括：

如何查看擴充功能的詳細資訊：

請確認設定您的環境和選取了一部擴充功能。
從電腦上的任何位置執行擴充功能-info 指令：
```
firebase ext:info publisher-id/extension-id
```
《publisher-id》和《extension-id》需要引數，也可以位於擴充功能的預先安裝詳細資料頁面。

在安裝過程中，系統會提示您檢閱擴充功能的規格 (例如已啟用的 API 資源存取等方式)。如有任何帳單要求，您會收到通知，並提示您指定擴充功能可設定參數的值。

請確認設定您的和環境選取了一部擴充功能。
從本機 Firebase 目錄執行擴充功能安裝指令。如果出現提示訊息，請輸入參數值來自訂擴充功能例項。
```
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
```
《publisher-id》和《extension-id》需要引數，也可以位於擴充功能的預先安裝詳細資料頁面。

執行這個指令會將擴充功能執行個體新增至擴充功能資訊清單。
接著，將資訊清單中的擴充功能部署至 Firebase 執行：
```
firebase deploy --only extensions --project=projectId-or-alias
```
注意： 安裝及佈建擴充功能可能需要系統 3 到 5 的時間。

部分擴充功能必須提供必要或選用步驟，您才能開始使用具體做法是指示 Kubernetes 建立並維護一或多個代表這些 Pod 的物件請前往擴充功能的安裝後詳細資料頁面，查看操作說明： Firebase 控制台的擴充功能資訊主頁 ( 安裝之後，終端機中就會顯示資訊主頁)。

您也可以在下方的 POSTINSTALL.md 檔案中找到這些操作說明：擴充功能的來源目錄。

如果您將擴充功能設為使用 Firebase 資源 (Cloud Firestore)，現有的集合、即時資料庫路徑、Cloud Storage 值區) 請先建立網址，再使用擴充功能

部分擴充功能會發布至 Eventarc 在執行期間發生重要事件時如果擴充功能會發布事件如果您在安裝期間啟用事件，自訂邏輯這項功能很實用當使用者長時間執行的工作完成時，或是對以下內容進行後續處理時，加上擴充功能函式

請參閱擴充功能的說明文件，瞭解其發布的事件清單 (如果有的話)。如需範例，請參閱「透過 Stripe 執行付款」擴充功能的事件類型。

接著，請參閱「自訂事件觸發條件」一文瞭解如何編寫 Eventarc 事件處理常式。

您可以在同一個專案中多次安裝同一個擴充功能。每個已安裝的執行個體都能有專屬的自訂設定擴充功能資源您可以識別並參照每個已安裝的執行個體「執行個體 ID」，為專案中不重複的 ID。您系統會提示您確認或編輯每個額外執行個體的執行個體 ID 你安裝的擴充功能