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

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

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

必要條件

• 您必須具備指令碼專案的編輯者存取權。
• 如要讓其他人測試外掛程式，請授予他們專案的編輯者權限。請參閱「與其他開發人員協作」。
• 測試使用者必須與指令碼擁有者位於相同網域。

安裝未發布的外掛程式

從「Deployments」(部署) 對話方塊安裝未發布的外掛程式。

如要安裝未發布的增效工具進行測試，請按照下列步驟操作：

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

如要讓其他使用者測試外掛程式，請與對方的帳戶共用專案 (需要編輯存取權)。然後請使用者按照相同的步驟操作。

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

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

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

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

完成這些步驟後，部署作業就會移除，外掛程式也不會再顯示。您隨時可以重新安裝部署項目。

測試最佳做法

測試外掛程式時，請遵循最佳做法。此外，請執行下列操作：

1. 在外掛程式擴充的所有主機應用程式中，測試資訊卡導覽流程。確認使用者在不同情境之間移動，以及在非情境和情境資訊卡之間移動時的行為。

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

3. 如果外掛程式會連線至第三方 API，請確認該服務是否可存取。確認外掛程式正確處理授權和登入。

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

5. 監控外掛程式的成效。如果外掛程式在程式碼變更後變慢，您可能需要重新設計該功能。