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