通过

在 Trident 上测试 Office 加载项

  • 项目

如果你计划支持较旧版本的 Windows 和 Office，则外接程序必须在 Internet Explorer 11 提供的名为“Trident”的可嵌入浏览器控件中工作。 可以使用命令行从加载项使用的更现代的 Web 视图切换到 Trident 进行此测试。 有关哪些版本的 Windows 和 Office 使用 Internet Explorer 11 Webview 控件的信息，请参阅 Office 外接程序使用的浏览器和 Webview 控件。在本文中，“webview”是指 Webview 控件和 JavaScript 引擎的组合。

重要

Office 加载项中仍使用 Internet Explorer 和 Microsoft Edge 旧版中的 Web 视图

平台和 Office 版本的一些组合（包括通过 Office 2019 的批量许可永久版本）仍使用 Internet Explorer 11 (名为“Trident”) 和Microsoft Edge 旧版 (“EdgeHTML”) 来托管外接程序，如 Office 外接程序使用的浏览器和 Webview 控件中所述.Internet Explorer 11 已于 2023 年 2 月在 Windows 10 和 Windows 11 中禁用，用于启动它的 UI 已删除;但它仍随这些操作系统一起安装。 因此，Office 仍可通过编程方式调用 Internet Explorer 中的 Trident 和其他功能。

我们建议 (但不需要) 支持这些组合（至少以最小方式），方法是在加载项在这些 Web 视图中启动时向外接程序的用户提供正常失败消息。 请记住以下附加要点：

  • Web 版 Office 不再在 Internet Explorer 中打开，也不会Microsoft旧版 Edge 中打开。 因此， AppSource 不会在这些浏览器上的 Web 上测试 Office 中的加载项。
  • AppSource 仍会测试使用 Trident 或 EdgeHTML 的平台和 Office 桌面 版本的组合。 但是，仅当加载项不支持这些 Web 视图时，才会发出警告;AppSource 不会拒绝加载项。
  • 脚本实验室工具不再支持 Trident。

如果你计划支持较旧版本的 Windows 和 Office，则外接程序必须在 Internet Explorer 11 提供的名为“Trident”的可嵌入浏览器控件中工作。 可以使用命令行从加载项使用的更现代的 Web 视图切换到 Trident 进行此测试。 有关哪些版本的 Windows 和 Office 使用 Internet Explorer 11 Webview 控件的信息，请参阅 Office 外接程序使用的浏览器和 Webview 控件。

重要

Trident 不支持 ES5 之后的 JavaScript 版本。 如果要使用 ECMAScript 2015 或更高版本的语法和功能，则必须使用转译器或 polyfill 或两者。 有关这些选项的详细信息，请参阅 支持较旧的Microsoft Webviews 和 Office 版本。

此外，Trident 不支持某些 HTML5 功能，例如媒体、录制和位置。 若要了解详细信息，请参阅 确定加载项在运行时运行的 Web 视图。

注意

  • 无法在 Internet Explorer 11 中打开 Web 上的 Office，因此你无法 (，也无需) 使用 Internet Explorer 在 Office 网页版上测试加载项。

  • 必须关闭 Internet Explorer 的增强安全配置 (ESC) 才能使 Office Web 加载项正常工作。 如果在开发外接程序时使用 Windows Server 计算机作为客户端，请注意，默认情况下，在 Windows Server 中打开 ESC。

切换到 Trident Webview

提示

在 Office 的最新版本中，标识 Office 正在使用的 Web 视图控件的一种方法是通过任何加载项上的 个性菜单 （如果有）。 (Outlook 中不支持“个性”菜单。) 打开菜单并选择“ 安全信息”。 在 Windows 上的“安全信息”对话框中，运行时报告Microsoft Edge、Microsoft Edge 旧版或 Internet Explorer。 旧版 Office 中的对话框中不包含运行时。

有两种方法可以切换 Trident Webview。 可以在命令提示符下运行简单的命令，也可以安装默认使用 Trident 的 Office 版本。 建议使用第一种方法，但应在以下方案中使用第二种方法。

  • 你的项目是使用 Visual Studio 和 IIS 开发的。 它不是基于 Node.js。
  • 你希望在测试中绝对可靠。
  • 不能在开发计算机上对 Microsoft 365 使用 Beta 版通道。
  • 你在 Mac 上进行开发。
  • 如果出于任何原因，命令行工具不起作用。

通过命令行切换

如果你的项目是基于 Node.js (，即不是使用 Visual Studio 和 Internet Information server (IIS) ) 开发的，则可以强制 Windows 上的 Office 使用 Edge 旧版提供的 EdgeHTML Webview 控件或 Internet Explorer 提供的 Trident Webview 控件来运行加载项，即使你拥有通常使用最新 Web 视图的 Windows 和 Office 版本的组合。 有关 Windows 和 Office 版本的各种组合使用哪些浏览器和 Web 视图的详细信息，请参阅 Office 外接程序使用的浏览器和 Web 视图控件。

注意

用于强制更改 Webview 的工具仅在 Microsoft 365 的 Beta 订阅频道中受支持。 加入 Microsoft 365 预览体验计划 ，然后选择 “Beta 频道 ”选项以访问 Office Beta 版本。 另请参阅 关于 Office：我使用的是哪个版本的 Office？。

严格来说， webview 此工具的开关 (请参阅需要 Beta 通道 的步骤 2) 。 该工具具有没有此要求的其他开关。

  1. 如果项目 不是 使用 Office 外接程序工具的 Yeoman 生成器 创建的，则需要安装 office-addin-dev-settings 工具。 在命令提示符下运行以下命令。

    npm install office-addin-dev-settings --save-dev

    重要

    Mac 不支持 office-addin-dev-settings 工具。

  2. 在项目的根目录中的命令提示符中，通过以下命令指定希望 Office 使用的 Web 视图。 将 替换为 <path-to-manifest> 相对路径，如果它位于项目的根目录中，则只是清单文件名。 ie将 替换为 <webview> 或 edge-legacy。 请注意，这些选项以源自 Web 视图的浏览器命名。 选项 ie 表示“Trident”， edge-legacy 选项表示“EdgeHTML”。

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    示例如下。

    npx office-addin-dev-settings webview manifest.xml ie

    npx office-addin-dev-settings webview manifest.json edge-legacy

    应在命令行中看到一条消息，指出 Web 视图类型现在设置为 IE (或 Edge 旧版) 。

  3. 完成后，使用以下命令将 Office 设置为继续使用 Windows 和 Office 版本组合的默认 Web 视图。

    npx office-addin-dev-settings webview <path-to-manifest> default

安装使用 Internet Explorer 的 Office 版本

使用以下过程安装从 Microsoft 365 订阅) 下载的 Office (版本，该版本使用 Microsoft Edge 旧版 Webview (EdgeHTML) 来运行加载项或使用 Internet Explorer (Trident) 的版本。

  1. 在任何 Office 应用程序中，打开功能区上的“ 文件 ”选项卡，然后选择“ Office 帐户 ”或“ 帐户”。 选择“ 关于 主机名 ”按钮 (例如 “关于 Word) ”。

  2. 在打开的对话框中，找到完整的 xx.x.xxxxx.xxxxx 内部版本号，并在某个位置复制它。

  3. 下载 Office 部署工具。

  4. 运行下载的文件以提取该工具。 系统会提示你选择工具的安装位置。

  5. 在安装该工具的文件夹中， setup.exe (文件所在的文件夹) ，创建一个名称 config.xml 为 的文本文件，并添加以下内容。

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Version更改值。

    • 若要安装使用 EdgeHTML 的版本，请将其更改为 16.0.11929.20946。
    • 若要安装使用 Trident 的版本，请将其更改为 16.0.10730.20348。

  7. （可选）将 的值 OfficeClientEdition 更改为 "32" 以安装 32 位 Office，并根据需要更改 Language ID 值以使用其他语言安装 Office。

  8. 以管理员身份打开命令提示符。

  9. 导航到包含 setup.exe 和 config.xml 文件的文件夹。

  10. 运行以下命令：

    setup.exe /configure config.xml

    此命令安装 Office。 这个过程可能需要几分钟。

  11. 清除 Office 缓存。

重要

安装后，请确保关闭 Office 的自动更新，以便在完成使用之前，Office 不会更新到不使用想要使用的 Web 视图的版本。 这可以在安装后的几分钟内发生。 请按照以下步骤操作。

  1. 启动任何 Office 应用程序并打开新文档。
  2. 打开功能区上的“ 文件 ”选项卡，然后选择“ Office 帐户 ”或“ 帐户”。
  3. 在 “产品信息” 列中，选择“ 更新选项”，然后选择“ 禁用更新”。 如果该选项不可用，则 Office 已配置为不自动更新。

使用完旧版 Office 后，请通过编辑 config.xml 文件并将 更改为 Version 之前复制的内部版本号来重新安装较新版本。 然后在管理员命令提示符下重复 setup.exe /configure config.xml 该命令。 （可选）重新启用自动更新。

另请参阅