測試及偵錯 Apps Script Google Workspace 外掛程式

發布外掛程式後，使用者就能透過主機應用程式或 Google Workspace Marketplace 安裝外掛程式。發布前，請先在擴充的宿主應用程式中，測試您開發的外掛程式。

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

必要條件

  • 您必須具備外掛程式指令碼專案的編輯者存取權。
  • 如要讓貴機構的其他使用者測試外掛程式，請授予他們指令碼專案的編輯者存取權。如要瞭解如何授予存取權，請參閱「與其他開發人員協作」。

安裝未發布的外掛程式

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

如要安裝未發布的 Google Workspace 外掛程式進行測試，請按照下列步驟操作：

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

您可以與其他使用者的帳戶共用 Apps Script 專案 (必須具備編輯權限)，讓他們測試外掛程式。然後請使用者按照上述步驟操作。

安裝完畢後，外掛程式會立即在擴充的主機應用程式中提供。外掛程式可能需要重新整理主機應用程式分頁，才會顯示。使用外掛程式前，也必須先授權。如果專案已獲得授權，請使用 ScriptApp.invalidateAuth 撤銷現有授權，以便在外掛程式上測試精細 OAuth 功能。

解除安裝未發布的外掛程式

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

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

完成這些步驟後，系統會立即移除部署作業，外掛程式也不會再顯示於任何主機應用程式中。您隨時可以重複安裝程序，重新安裝部署作業。

測試最佳做法

測試 Google Workspace 外掛程式時，請務必遵循外掛程式開發的最佳做法。此外，請務必完成下列事項：

  1. 在擴充功能延伸的所有主機應用程式中，徹底測試資訊卡導覽流程。請確保使用者在不同內容之間移動，以及在非內容和內容資訊卡之間移動時，外掛程式的行為正確無誤。

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

  3. 如果外掛程式會連線至第三方 API 或其他服務，請確認服務可供存取，且運作方式符合預期。請確認外掛程式正確處理授權和登入詳細資料。

  4. 請確保妥善處理所有錯誤情況。視需要使用錯誤資訊卡。

  5. 請注意外掛程式的效能。如果您變更程式碼後，外掛程式開始變慢，可能需要移除或重新設計該功能。