測試編輯器外掛程式
請在發布前徹底測試外掛程式,確保其運作方式符合預期。您可以使用 Apps Script 在特定 Google 文件、試算表、表單或簡報檔案上測試編輯器外掛程式。這項功能可用於:
- 確認以獨立指令碼編寫的外掛程式,在套用至試算表、文件、簡報或表單時,是否能正常運作。
- 確認外掛程式安裝流程是否正常運作,特別是針對不同的初始授權生命週期狀態 (已安裝、已啟用或兩者皆是)。
- 驗證在處理特定文件及其內容時,外掛程式是否能正常運作。
- 測試並比較目前和先前版本的外掛程式。
建立測試部署
測試部署是外掛程式和測試文件的組合。開發完成指令碼版本後,如果想以外掛程式模式進行測試,請按照下列步驟操作:
- 如果尚未建立,請建立試算表、文件、簡報或表單,以便測試外掛程式。
- 開啟包含外掛程式的指令碼專案。
- 依序按一下「部署」>「測試部署作業」。
- 按一下「選取類型」旁的「啟用部署類型」圖示 settings,然後選取「編輯器外掛程式」。
- 按一下「建立新測試」或「新增測試」。
- 選擇程式碼版本,或選取「最新程式碼」。
- 在「Config」部分,選取測試的初始授權狀態。
- 在「測試文件」下方,點選「未選取任何文件」。選取要用來測試外掛程式的試算表、文件、簡報或表單檔案,然後按一下「插入」。
- 按一下「儲存測試」。
所有已儲存的測試部署作業都會顯示在「Test deployments」對話方塊中。這樣一來,您日後就能重新查看相同的測試部署作業。
執行測試部署
如果您有一個或多個已儲存的測試部署,可以按照下列步驟執行其中一個:
- 開啟包含外掛程式的指令碼專案。
- 依序按一下「部署」「測試部署作業」。
- 在「已儲存的測試」下方,選取要執行的已儲存測試部署旁邊的圓形按鈕,然後按一下「執行」。
測試文件會在新分頁中開啟。外掛程式處於測試部署作業中指定的授權狀態。您可以透過互動選單和 UI 元素,確認外掛程式是否正常運作。
測試詳細資料
以這種方式測試編輯器外掛程式時,請留意以下幾點:
- 測試時不支援可安裝的觸發條件。依賴可安裝觸發事件的功能無法測試。
- 執行設定為使用最新程式碼進行測試的測試部署作業時,您可以重新整理測試文件,查看儲存至外掛程式的變更。
- 測試文件含有網址,您可以將該網址分享給原始測試文件的編輯者。這樣一來,您在測試和開發時,就能更輕鬆地與他人協同合作。
- 如果外掛程式使用屬性服務,屬性會持續存在,並在下次執行測試部署時保持可用。
- 此外,任何使用相同外掛程式和測試文件組合的測試部署作業,都會存取相同的資源資訊。舉例來說,如果您建立兩個測試部署,則執行第一個部署時儲存的屬性,可在執行第二個部署時使用,反之亦然。但前提是兩個部署都使用相同的指令碼和測試文件。
- 如果您執行測試部署作業,且先前未執行過指令碼,系統可能會提示您授權。請注意,在測試期間授權指令碼,也會授權在測試之外執行指令碼。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-22 (世界標準時間)。
[null,null,["上次更新時間:2024-12-22 (世界標準時間)。"],[[["Apps Script allows developers to test editor add-ons directly within Google Docs, Sheets, Slides, or Forms to verify functionality and installation flow."],["Developers can create test deployments to specify add-on versions, authorization states, and associated documents for controlled testing environments."],["Saved test deployments can be executed repeatedly, enabling developers to iterate on their add-ons and observe changes in real-time within the test document."],["While offering valuable testing capabilities, test deployments have limitations such as not supporting installable triggers and shared property persistence across deployments using the same add-on and document."],["Test deployments provide a shareable URL for collaborative testing and may require authorization for the script, both within and outside the testing environment."]]],["To test add-ons in development, create a test deployment linking a script version to a specific Google Docs, Sheets, Forms, or Slides file. Select the add-on's authorization state and save the test. Run saved tests by selecting them in the \"Test deployments\" dialog and clicking \"Execute.\" During testing, changes to the script can be viewed by refreshing the test document; the test document URL is shareable for collaboration. Any properties created are also persisted across multiple test deployments.\n"]]