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

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

注意

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

使用 Microsoft 365 Agents Toolkit 或 Office Yeoman Generator (Yo Office) 创建的项目

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

重要

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

其他项目

如果项目不是使用 Agents Toolkit 或 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 命令使用同一选项。