如何为 mac 调试 office 加载项?
How to debug office add-in for mac?
我正在为 Word 开发 MS office 插件。测试版本在 Windows 的 Word 上运行良好,但在 Mac 的 Office 上运行失败。
在 Mac 的 Office 上,加载项按预期加载,但每当我尝试单击一个按钮来执行调用 php Web 服务的 JS 脚本时与 MySQL 数据库通信,没有任何反应。
我没有收到任何错误消息,因此我正在寻找有关如何在 mac 上调试加载项的建议。我可以使用哪些工具?
背景,我试过了
- 这里的Vorlon.js指导:
https://blogs.msdn.microsoft.com/mim/2016/02/18/vorlonjs-plugin-for-debugging-office-addin/
不过好像不行。问题可能是我对 Git 不是很熟悉,按照字面上的说明可能行不通。
- 我也试过直接在 Chrome 中加载插件,并使用开发工具。这不起作用,因为加载项依赖于 API,它只能在通过 Word 启动时访问。
你试过看一下这两个主题吗?
http://dev.office.com/docs/add-ins/testing/sideload-an-office-add-in-on-ipad-and-mac
http://dev.office.com/docs/add-ins/testing/debug-office-add-ins-on-ipad-and-mac
问题很可能与 HTTPS 有关。加载项需要 HTTPS,并且扩展它们使用的任何脚本也必须是 HTTPS,包括 Vorlon 脚本。因此,您必须将 Vorlon 配置为使用 SSL 才能将 Vorlon 与加载项一起使用。
如果您使用 git 安装了 Vorlon,您应该知道 Vorlon 文件夹的位置。如果你用 npm 安装它,我在 /usr/local/lib/node_modules 中找到了它。在 vorlon/ 文件夹下,转到 Server 文件夹并编辑 config.json 文件。如果您使用 npm 安装,则需要按住 ctrl-click > Get Info > unlock 并将权限更改为 Read & Write,因为默认情况下它们是只读的。在 config.json 文件中,将 useSSL 属性 更改为 true。当您在那里时,您还可以根据需要启用 Office 插件。
现在您可以使用命令 sudo vorlon
启动 vorlon 服务器,它应该 运行 使用 SSL。您将需要信任该证书,当您导航到 https://localhost:1337 时,系统会提示您这样做,否则您可以在 /Server/cert 下的 vorlon 文件夹中找到证书文件。
确保加载项的默认 html 文件(例如 home.html)中的元素现在使用 https URL,即 https://localhost:1337/vorlon.js。
现在您应该能够在 Vorlon 界面中看到连接的客户端并调试您的加载项。
我们需要更新调试主题以更好地反映这些设置要求。感谢您找出这个差距!
https://docs.microsoft.com/en-us/office/dev/add-ins/testing/debug-office-add-ins-on-ipad-and-mac 上的文档现已更新,您可以使用以下指南将 Safari Web Inspector 用于 Mac:
要能够在 Mac 上调试 Office Add-ins,您必须有 Mac OS High Sierra 和 Mac Office 版本:16.9.1 (内部版本 18012504)或更高版本。如果您没有 Office Mac 版本,可以通过加入 Office 365 开发人员计划获得一个。
首先,打开终端并为相关的 Office 应用程序设置 OfficeWebAddinDeveloperExtras 属性,如下所示:
默认写入com.microsoft.Word OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Excel OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Powerpoint OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Outlook OfficeWebAddinDeveloperExtras -bool true
然后,打开 Office 应用程序并插入您的 add-in。 Right-click add-in 并且您应该在上下文菜单中看到检查元素选项。 Select 该选项,它将弹出检查器,您可以在其中设置断点并调试 add-in。
Note
请注意,这是一项实验性功能,不保证我们会在未来版本的 Office 应用程序中保留此功能。
我正在为 Word 开发 MS office 插件。测试版本在 Windows 的 Word 上运行良好,但在 Mac 的 Office 上运行失败。
在 Mac 的 Office 上,加载项按预期加载,但每当我尝试单击一个按钮来执行调用 php Web 服务的 JS 脚本时与 MySQL 数据库通信,没有任何反应。
我没有收到任何错误消息,因此我正在寻找有关如何在 mac 上调试加载项的建议。我可以使用哪些工具?
背景,我试过了
- 这里的Vorlon.js指导: https://blogs.msdn.microsoft.com/mim/2016/02/18/vorlonjs-plugin-for-debugging-office-addin/
不过好像不行。问题可能是我对 Git 不是很熟悉,按照字面上的说明可能行不通。
- 我也试过直接在 Chrome 中加载插件,并使用开发工具。这不起作用,因为加载项依赖于 API,它只能在通过 Word 启动时访问。
你试过看一下这两个主题吗?
http://dev.office.com/docs/add-ins/testing/sideload-an-office-add-in-on-ipad-and-mac
http://dev.office.com/docs/add-ins/testing/debug-office-add-ins-on-ipad-and-mac
问题很可能与 HTTPS 有关。加载项需要 HTTPS,并且扩展它们使用的任何脚本也必须是 HTTPS,包括 Vorlon 脚本。因此,您必须将 Vorlon 配置为使用 SSL 才能将 Vorlon 与加载项一起使用。
如果您使用 git 安装了 Vorlon,您应该知道 Vorlon 文件夹的位置。如果你用 npm 安装它,我在 /usr/local/lib/node_modules 中找到了它。在 vorlon/ 文件夹下,转到 Server 文件夹并编辑 config.json 文件。如果您使用 npm 安装,则需要按住 ctrl-click > Get Info > unlock 并将权限更改为 Read & Write,因为默认情况下它们是只读的。在 config.json 文件中,将 useSSL 属性 更改为 true。当您在那里时,您还可以根据需要启用 Office 插件。
现在您可以使用命令 sudo vorlon
启动 vorlon 服务器,它应该 运行 使用 SSL。您将需要信任该证书,当您导航到 https://localhost:1337 时,系统会提示您这样做,否则您可以在 /Server/cert 下的 vorlon 文件夹中找到证书文件。
确保加载项的默认 html 文件(例如 home.html)中的元素现在使用 https URL,即 https://localhost:1337/vorlon.js。
现在您应该能够在 Vorlon 界面中看到连接的客户端并调试您的加载项。
我们需要更新调试主题以更好地反映这些设置要求。感谢您找出这个差距!
https://docs.microsoft.com/en-us/office/dev/add-ins/testing/debug-office-add-ins-on-ipad-and-mac 上的文档现已更新,您可以使用以下指南将 Safari Web Inspector 用于 Mac:
要能够在 Mac 上调试 Office Add-ins,您必须有 Mac OS High Sierra 和 Mac Office 版本:16.9.1 (内部版本 18012504)或更高版本。如果您没有 Office Mac 版本,可以通过加入 Office 365 开发人员计划获得一个。
首先,打开终端并为相关的 Office 应用程序设置 OfficeWebAddinDeveloperExtras 属性,如下所示:
默认写入com.microsoft.Word OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Excel OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Powerpoint OfficeWebAddinDeveloperExtras -bool true
默认写入 com.microsoft.Outlook OfficeWebAddinDeveloperExtras -bool true
然后,打开 Office 应用程序并插入您的 add-in。 Right-click add-in 并且您应该在上下文菜单中看到检查元素选项。 Select 该选项,它将弹出检查器,您可以在其中设置断点并调试 add-in。
Note
请注意,这是一项实验性功能,不保证我们会在未来版本的 Office 应用程序中保留此功能。