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調試工具(本次不展開了)