測試編輯器外掛程式

請在發布前徹底測試外掛程式，確保其運作方式符合預期。您可以使用 Apps Script 在特定 Google 文件、試算表、表單或簡報檔案上測試編輯器外掛程式。這項功能可用於：

  • 確認以獨立指令碼編寫的外掛程式，在套用至試算表、文件、簡報或表單時，是否能正常運作。
  • 確認外掛程式安裝流程是否正常運作，特別是針對不同的初始授權生命週期狀態 (已安裝、已啟用或兩者皆是)。
  • 驗證在處理特定文件及其內容時，外掛程式是否能正常運作。
  • 測試並比較目前和先前版本的外掛程式。

建立測試部署

測試部署是外掛程式和測試文件的組合。開發完成指令碼版本後，如果想以外掛程式模式進行測試，請按照下列步驟操作：

  1. 如果尚未建立，請建立試算表、文件、簡報或表單，以便測試外掛程式。
  2. 開啟包含外掛程式的指令碼專案。
  3. 依序按一下「部署」>「測試部署作業」。
  4. 按一下「選取類型」旁的「啟用部署類型」圖示 ，然後選取「編輯器外掛程式」。
  5. 按一下「建立新測試」或「新增測試」。
  6. 選擇程式碼版本，或選取「最新程式碼」。
  7. 在「Config」部分，選取測試的初始授權狀態。
  8. 在「測試文件」下方，點選「未選取任何文件」。選取要用來測試外掛程式的試算表、文件、簡報或表單檔案，然後按一下「插入」。
  9. 按一下「儲存測試」。

所有已儲存的測試部署作業都會顯示在「Test deployments」對話方塊中。這樣一來，您日後就能重新查看相同的測試部署作業。

執行測試部署

如果您有一個或多個已儲存的測試部署，可以按照下列步驟執行其中一個：

  1. 開啟包含外掛程式的指令碼專案。
  2. 依序按一下「部署」「測試部署作業」。
  3. 在「已儲存的測試」下方，選取要執行的已儲存測試部署旁邊的圓形按鈕，然後按一下「執行」。

測試文件會在新分頁中開啟。外掛程式處於測試部署作業中指定的授權狀態。您可以透過互動選單和 UI 元素，確認外掛程式是否正常運作。

測試詳細資料

以這種方式測試編輯器外掛程式時，請留意以下幾點：

  • 測試時不支援可安裝的觸發條件。依賴可安裝觸發事件的功能無法測試。
  • 執行設定為使用最新程式碼進行測試的測試部署作業時，您可以重新整理測試文件，查看儲存至外掛程式的變更。
  • 測試文件含有網址，您可以將該網址分享給原始測試文件的編輯者。這樣一來，您在測試和開發時，就能更輕鬆地與他人協同合作。
  • 如果外掛程式使用屬性服務，屬性會持續存在，並在下次執行測試部署時保持可用。
  • 此外，任何使用相同外掛程式和測試文件組合的測試部署作業，都會存取相同的資源資訊。舉例來說，如果您建立兩個測試部署，則執行第一個部署時儲存的屬性，可在執行第二個部署時使用，反之亦然。但前提是兩個部署都使用相同的指令碼和測試文件。
  • 如果您執行測試部署作業，且先前未執行過指令碼，系統可能會提示您授權。請注意，在測試期間授權指令碼，也會授權在測試之外執行指令碼。