請在發布前仔細測試外掛程式,確保外掛程式正常運作。Apps Script 可讓您針對特定 Google 文件試算表、表單或簡報檔案,在開發過程中測試編輯器外掛程式。此用途可用來:
- 確認將獨立指令碼編寫的外掛程式套用至工作表、文件、簡報或表單時,能正常運作。
- 確認外掛程式安裝流程正常運作,特別是針對不同的初始授權生命週期狀態 (已安裝、啟用或兩者)。
- 驗證對特定文件及其內容進行操作時,外掛程式功能是否正常。
- 測試及比較外掛程式的目前版本和先前版本。
建立測試部署作業
測試部署作業結合外掛程式和測試文件。建立指令碼版本並想以外掛程式形式進行測試後,請按照下列步驟操作:
- 如果還沒有,請建立試算表、文件、簡報或表單來測試外掛程式。
- 開啟含有外掛程式的指令碼專案。
- 依序點選「部署」>「測試部署作業」。
- 按一下「選取類型」旁的「啟用部署類型」圖示 ,然後選取「編輯器外掛程式」。
- 按一下「建立新測試」或「新增測試」。
- 選擇程式碼版本或選取「最新程式碼」。
- 在「Config」部分中,選取測試的初始授權狀態。
- 在「測試文件」下方,點選「未選取任何文件」。選取要用來測試外掛程式的試算表、文件、簡報或表單檔案,然後按一下「插入」。
- 按一下「儲存測試」。
所有已儲存的測試部署作業都會顯示在「Test Deployment」對話方塊中。這可讓您稍後再次前往相同的測試部署作業。
執行測試部署作業
如果您有一或多個已儲存的測試部署作業,可以按照下列步驟執行其中一個:
- 開啟含有外掛程式的指令碼專案。
- 依序點選「部署」>「測試部署作業」。
- 在「Saved Tests」下方,在已儲存的測試部署作業旁選取圓形按鈕,然後點選「執行」。
測試文件會在新分頁中開啟。外掛程式處於測試部署中指定的授權狀態。您可以與選單和 UI 元素互動,驗證外掛程式函式是否符合預期。
測試詳細資料
以這種方式測試編輯器外掛程式時,請注意以下事項:
- 測試時不支援可安裝觸發條件。無法測試需可安裝觸發條件的功能。
- 執行設定以最新程式碼進行測試的測試部署作業時,您可以重新整理測試文件,查看已儲存至外掛程式指令碼的變更。
- 測試文件提供的網址,您可以分享給原始測試文件的編輯者。如此一來,您就能在測試及開發時,更輕鬆地與他人協同合作。
- 如果您的外掛程式使用屬性服務,屬性會保留,並在下次執行測試部署作業時保持可用。
- 此外,使用相同外掛程式和測試文件的任何測試部署,也都可以存取相同的屬性資訊。舉例來說,假設您建立了兩個測試部署作業,則在執行第一個測試時儲存的屬性可以使用第二個測試,反之亦然,但前提是部署作業使用相同的指令碼和測試文件。
- 執行測試部署作業時,如果您不曾執行指令碼,系統可能會提示您進行授權。請注意,在測試時授權指令碼也會在測試之外授權指令碼。