上期教程己經學習了如何完成一個 web add-ins 插件,本期就總結一下如何調試插件。其實上期教程中己經用到了一種。一共有三種方法可用于調試:
- 通過将清單釋出到 Office Online
- 通過将清單釋出到網絡檔案共享
- 使用 sideload 指令進行測試
從友善和測試效果綜合來看,推薦使用 sideload 方法來做測試,簡單易行且效果最好。
【适合範圍】
此方法需要在 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、選中新添加項目的“在菜單中顯示”複選框。
1、打開 Excel 檔案,插入-->我的附加元件;
2、出現添加共享目錄所在的項目,選中點選添加。
着Excel中會出現方附加元件的TaskPan按鈕
如果項目是使用 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中調試的代碼行。
Windows 10中包含的F12開發人員工具可幫助您調試,測試和加速網頁。如果您沒有使用像Visual Studio這樣的IDE,或者您需要在IDE外部運作附加元件時調查問題,也可以使用它們來開發和調試Office附加元件。
1、隻能用于 Windows 10 平台
2、隻能用于桌面 Office 程式
1、啟動與您的Office版本對應的F12開發工具:
C:\Windows\SysWOW64\F12.IEChooser.exe
3、F12調試工具(本次不展開了)