在非本地服务器上测试和调试 Office 加载项

在 localhost 上完成了开发和测试,并且想要从非本地服务器或云帐户暂存和测试加载项时,可以对任何基于 Node.js 的外接程序项目使用 office-addin-debugging 工具。 (使用 Visual Studio.) 创建的项目中不支持该工具

注意

如果你使用的是 Windows 计算机,则可以使用其他选项进行非本地测试。 请参阅 旁加载 Office 加载项,以便从网络共享进行测试

使用 Teams 工具包或 Office Yeoman 生成器创建的项目 (Yo Office)

如果你的项目是使用 Teams 工具包Office Yeoman Generator (Yo Office) 创建的,则已安装 office-addin-debugging 工具,并且你的 package.json 文件和脚本已startstop调用该工具。 若要将其用于非本地测试,请更新清单中 URL 的域部分,以根据需要) 指向过渡服务器 (或 CDN。 然后在命令行 (运行npm run start,或Visual Studio Code终端) 旁加载加载项以进行测试和调试。

重要

office-addin-debugging 工具在 Windows 注册表或 Mac 上的特殊文件夹中注册加载项。 对于 Outlook 加载项,它还在 Exchange 中注册加载项。 为了避免在开发时出现细微的 bug,请始终通过运行 npm run stop 来结束测试会话,以确保删除这些注册并完全停止服务器进程。 手动关闭服务器、命令行窗口 (或终端) 、Visual Studio Code或 Office 应用程序不会删除这些注册。

其他项目

如果项目不是使用 Teams 工具包或 Yo Office 创建的,请在项目的根目录中使用 npx 运行该工具。 使用其 start 命令调用它,后跟清单的相对路径。 示例如下。

npx office-addin-debugging start manifest.json

此命令旁加载加载项以进行测试和调试。 该工具还适用于仅外接程序清单。

命令有许多选项 start 。 有关详细信息,请参阅 office-addin-debugging 中该工具的自述文件。

重要

office-addin-debugging 工具在 Windows 注册表或 Mac 上的特殊文件夹中注册加载项。 对于 Outlook 加载项,它还在 Exchange 中注册加载项。 为了避免在开发时出现细微的 bug,请始终通过运行 npx office-addin-debugging stop 来结束测试会话,以确保删除这些注册并完全停止服务器进程。 手动关闭服务器、命令行窗口 (或终端) 、Visual Studio Code或 Office 应用程序不会删除这些注册。 如果将 选项与 命令一起使用--prodstart,请对 stop 命令使用同一选项。