測試 Apps Script Google Workspace 外掛程式並進行偵錯

當您發布外掛程式時,使用者可以透過代管應用程式或 Google Workspace Marketplace 進行安裝。發布前,請先測試您在擴充的主機應用程式中開發的外掛程式。

本頁面說明如何安裝開發中的外掛程式 (稱為「未發布」或「開發人員」外掛程式),供測試或個人使用。您也可以使用 Apps Script IDE 的偵錯工具和中斷點對外掛程式偵錯。

先備知識

  • 你必須具備外掛程式指令碼專案的編輯者權限。
  • 如要讓機構中的其他使用者測試外掛程式,請授予指令碼專案的編輯者存取權。如要進一步瞭解如何授予存取權,請參閱「與其他開發人員合作」。

安裝未發布的外掛程式

您可以透過 Apps Script 的「Deployments」對話方塊安裝未發布的外掛程式。

請按照下列步驟安裝未發布的 Google Workspace 外掛程式來進行測試:

  1. 在 Apps Script 編輯器中開啟指令碼專案。
  2. 依序點選「部署」>「測試部署」
  3. 按一下 [安裝]。
  4. 按一下底部的「完成」

您可以讓其他使用者與其帳戶共用 Apps Script 專案,讓對方測試外掛程式 (需要編輯權限)。然後提示使用者按照上述步驟操作。

安裝後,外掛程式會立即在所擴充的主機應用程式中提供。您可能需要重新整理主機應用程式分頁,外掛程式才會顯示。此外,您必須先授權外掛程式才能使用外掛程式。

解除安裝已取消發布的外掛程式

如要解除安裝尚未發布的外掛程式部署作業,請按照下列步驟操作:

  1. 在 Apps Script 編輯器中開啟指令碼專案。
  2. 依序點選「部署」>「測試部署」
  3. 按一下 [Uninstall] (解除安裝)
  4. 按一下底部的「完成」

這些步驟會立即移除部署,這個外掛程式也不會再出現在任何主機應用程式中。您隨時可以重複執行安裝程序,重新安裝部署。

測試最佳做法

在測試 Google Workspace 外掛程式時,請務必按照最佳做法進行外掛程式開發作業。此外,請務必完成下列事項:

  1. 在外掛程式擴充的所有主機應用程式中,完整測試資訊卡導覽流程。在使用者從內容切換到內容資訊卡,以及在非內容資訊卡和內容資訊卡之間移動時,請確認外掛程式行為正確無誤。

  2. 使用範例測試資料評估外掛程式行為。

  3. 如果您的外掛程式連線至第三方 API 或其他服務,請確認服務可以存取,且能正常運作。請確定外掛程式能正確處理授權和登入詳細資料

  4. 務必妥善處理所有錯誤狀況。視需要使用錯誤資訊卡

  5. 注意外掛程式的效能。如果您對程式碼進行變更,外掛程式開始減緩,就可能必須移除或重新執行該功能。