在 localhost 上完成了开发和测试,并且想要从非本地服务器或云帐户暂存和测试加载项时,可以对任何基于 Node.js 的外接程序项目使用 office-addin-debugging 工具。 (使用 Visual Studio.) 创建的项目中不支持该工具
注意
如果你使用的是 Windows 计算机,则可以使用其他选项进行非本地测试。 请参阅 旁加载 Office 加载项,以便从网络共享进行测试。
使用 Microsoft 365 Agents Toolkit 或 Office Yeoman Generator (Yo Office) 创建的项目
如果项目是使用 Agents Toolkit 或 Office 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 应用程序不会删除这些注册。 如果将 选项与 命令一起使用--prod
start
,请对 stop
命令使用同一选项。