测试 Office 加载项

本文包含有关测试、调试和排查 Office 加载项问题的指南。

测试跨平台及多个版本的 Office

Office 加载项跨主要平台运行，因此需要在用户可能运行 Office 的所有平台上测试加载项。 这通常包括Office web 版、Windows 上的 Office (永久订阅和 Microsoft 365 订阅) 、Office on Mac、Office on iOS 以及适用于 Outlook 外接程序的 () Android 上的 Office。 但是，有些情况下，你可以确定你的任何用户都没有在某些平台上工作。 例如，如果你为一家公司创建一个外接程序，要求其用户使用 Windows 计算机和订阅 Office，则无需测试 Mac 上的 Office 或 Windows 上的永久 Office。

注意

在 Windows 计算机上，Windows 和 Office 的版本将确定加载项使用的浏览器或 Web 视图控件。有关详细信息，请参阅 Office 外接程序使用的浏览器和 Web 视图控件。为简洁起见，本文使用“浏览器控件”来表示“浏览器或 Web 视图控件”。

针对Office web 版测试的加载项

加载项使用所有主要现代浏览器（包括基于 Microsoft Edge (Chromium 的 WebView2) 、Chrome 和 Safari）测试Office web 版。 因此，在提交到 AppSource 之前，应在这些平台和浏览器上进行测试。 有关验证详细信息，请参阅 商业市场证书策略，尤其是 第 1120.3 一节，以及 Office 加载项应用程序和可用性页面。

Office web 版不再在 Internet Explorer 或 Microsoft Edge 旧版 (EdgeHTML) 中打开。 因此，AppSource 不会在这些浏览器上测试Office web 版。 Office 仍支持这些浏览器用于外接程序运行时，因此，如果你认为加载项在浏览器中的运行方式中遇到了 bug，请在 office-js 存储库中创建问题。 有关详细信息，请参阅 支持较旧的 Microsoft Webview 和 Office 版本 和 排查 EdgeHTML 和 WebView2 (Microsoft Edge) 问题。

在 Windows 上测试 Office 的加载项

Windows 上的某些 Office 版本仍使用 Internet Explorer 和 Microsoft Edge 旧版 附带的 Webview 控件。 AppSource 测试加载项是否支持这些浏览器控件。 如果外接程序不支持这些浏览器控件，AppSource 仅发出警告，不会拒绝加载项。 在这种情况下，我们建议在加载项上配置正常故障消息，以便获得更流畅的用户体验。 有关进一步指南，请参阅 支持较旧的 Microsoft Webview 和 Office 版本。

旁加载 Office 加载项以供测试

可以通过旁加载来安装 Office 加载项以供测试，而无需先将它添加到加载项目录中。 加载项的旁加载过程因平台而异，在某些情况下，也因产品而异。 以下每篇文章都介绍如何在特定平台上或特定产品中旁加载 Office 加载项。

注意

使用 Microsoft 365 统一清单的 Office 加载项在 Office web 版、新的 Windows 版 Outlook (预览版) 中以及连接到 Microsoft 365 订阅版本 2304 (内部版本 16320.00000) 或更高版本的 Office 上直接受支持。 当包含统一清单的应用包旁加载到不直接支持该类型的清单的平台时，如果清单具有有效的“alternateIcons”属性，则会从统一清单生成 XML 清单，并且此清单是旁加载的清单。

• 在 Office 网页版中旁加载 Office 加载项
• 在 Windows 上旁加载 Office 加载项
• 在 Mac 上旁加载 Office 加载项
• 在 iPad 上旁加载 Office 加载项
• 旁加载 Outlook 加载项以供测试

单元测试

若要了解如何向加载项项目添加单元测试，请参阅 Office 加载项单元测试。

调试 Office 加载项

调试 Office 加载项的过程因平台和环境而异。 有关详细信息，请参阅 调试 Office 加载项。

验证 Office 加载项清单

若要了解如何验证描述 Office 加载项的清单文件，以及如何排查清单文件问题，请参阅验证并排查清单问题。

排查用户错误

若要了解如何解决用户在使用 Office 加载项时可能会遇到的常见问题，请参阅排查 Office 加载项中的用户错误。