測試編輯器外掛程式

在發布外掛程式之前,應先進行全面測試,確保外掛程式能正常運作。Apps Script 可讓您在開發特定 Google 文件試算表、表單或簡報檔案時,測試編輯器外掛程式。用途如下:

  • 套用至工作表、文件、簡報或表單時,確認透過獨立指令碼函式編寫的外掛程式是否符合預期。
  • 確認外掛程式安裝流程可正常運作,特別是針對不同的初始授權生命週期狀態 (已安裝、啟用或兩者)。
  • 對特定文件執行操作時,請確認外掛程式功能如預期運作。
  • 測試及比較目前和先前版本的外掛程式。

建立測試部署作業

測試部署作業是指外掛程式和測試文件的組合。在您建立指令碼版本後,如想以外掛程式形式進行測試,請按照下列步驟操作:

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

所有已儲存的測試部署作業都會顯示在「測試部署作業」對話方塊中。這樣您之後就能回頭查看相同的測試部署作業。

執行測試部署作業

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

  1. 開啟含有外掛程式的指令碼專案。
  2. 依序點選「部署」>「測試部署作業」
  3. 在「Saved Tests」下方,選取您想執行的已儲存測試部署旁的圓形按鈕,然後按一下「Execute」(執行)

測試文件會在新分頁中開啟。外掛程式處於測試部署中指定的授權狀態。您可以與外掛程式的選單和 UI 元素互動,確認外掛程式功能是否符合預期。

測試詳細資料

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

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