Script Lab 11：OIfficeJS的三種調試方式
- 2019 年 11 月 27 日
- 筆記
總結
上期教程己經學習了如何完成一個 web add-ins 插件，本期就總結一下如何調試插件。其實上期教程中己經用到了一種。一共有三種方法可用於調試：
- 通過將清單發布到 Office Online
- 通過將清單發布到網路文件共享
- 使用 sideload 命令進行測試
從方便和測試效果綜合來看，推薦使用 sideload 方法來做測試，簡單易行且效果最好。
Office Online
【適合範圍】
此方法需要在 Office Online 中操作，不適用於在 Windows上 運行測試。
【操作流程】
- 打開瀏覽輸入 office365.com 網址；
- 輸入用戶名、密碼並登錄帳戶；
- 在左上角的Office菜單上，單擊Excel；
- 找到 Excel 模板選擇空模板打開；
- 在「插入」菜單上，單擊「Office載入項」，在對話框的右上角，單擊「上載我的載入項」。
- 單擊「瀏覽」，上傳清單文件（比如：colorful-patterns–manifest.xml）；
- 載入項現在將載入到「主頁」選項卡上，切換到該選項卡，然後按「顯示任務窗格」。
Office Online 中出現插件TaskPan。
網路文件共享
【適合範圍】
此方法僅適用於在Windows上運行的Excel，Word和PowerPoint載入項; 並且僅適用於使用yo office工具創建並且在package.json文件sideload的scripts部分中具有腳本的載入項。（@1.1.5及以下的 office 模板創建的項目也沒有此腳本）
【設置目錄共享】
1、轉到項目所在文件夾的目錄；
2、選中目錄滑鼠右鍵設置文件夾共享；
3、複製共享目錄備用；
【設置Office信任】
1、將文件夾的完整網路路徑輸入「 目錄URL」框後，選擇「 添加目錄」按鈕；
2、選中新添加項目的「在菜單中顯示」複選框。
【設置Office信任】
1、打開 Excel 文件，插入–>我的載入項；
2、出現添加共享目錄所在的項目，選中點擊添加。
著Excel中會出現方載入項的TaskPan按鈕
sideload
【適合範圍】
如果項目是使用 Visual Studio 創建的，或者VSCode 使用較早的 Office 模板而沒有 sideload 腳本，則可以使用這種方法來達到與 sideload 相似的效果。
【操作流程】
1、以管理員身份打開命令提示符。
2、將目錄更改為載入項項目文件夾的根目錄。
3、運行以下命令以在埠3000上啟動本地Web伺服器實例以提供載入項項目：
npm run start
4、以管理員身份打開第二個命令提示符。
5、將目錄更改為載入項項目文件夾的根目錄。
6、運行以下命令以引導主機應用程式（例如Excel，Word）並在主機應用程式中註冊您的載入項：
npm run sideload
接著會自動啟動桌面Excel並載入該插件。
附加調試器
【適合範圍】
附加調試器功能將直接將調試器附加到正確的Internet Explorer進程。無論您使用的是Yeoman Generator，Visual Studio Code，node.js，Angular還是其他工具，都可以附加調試器。
1、在Office 2016 for Windows 的較高版本中，可以從任務窗格附加調試器；
2、前提是電腦上己經裝有 Visual Studio 2015 或更高版本；
3、只適用於桌面載入的插件，也就是後兩種調試模式。
【操作流程】
要啟動「 附加調試器」工具，請選擇任務窗格的右上角以激活「 個性」菜單（如下圖中的紅色圓圈所示）。選擇Attach Debugger。這將啟動Visual Studio實時調試器對話框，如下圖所示。
在Visual Studio中，您將在解決方案資源管理器中看到程式碼文件。您可以將斷點設置為要在Visual Studio中調試的程式碼行。
F12工具
【適合範圍】
Windows 10中包含的F12開發人員工具可幫助您調試，測試和加速網頁。如果您沒有使用像Visual Studio這樣的IDE，或者您需要在IDE外部運行載入項時調查問題，也可以使用它們來開發和調試Office載入項。
1、只能用於 Windows 10 平台
2、只能用於桌面 Office 程式
【操作流程】
1、啟動與您的Office版本對應的F12開發工具：
C:WindowsSysWOW64F12.IEChooser.exe
3、F12調試工具（本次不展開了）
