部署和安装 Outlook 加载项以进行测试

在开发 Outlook 加载项的过程中,可能会发现自己在反复部署和安装加载项以进行测试,会涉及以下步骤。

  1. 创建描述外接程序的清单文件。
  2. 将外接程序 UI 文件部署到 Web 服务器。
  3. 在邮箱中安装外接程序。
  4. 测试加载项,对 UI 或清单文件进行适当更改,并重复步骤 2 和步骤 3 来测试更改。

注意

已弃用自定义窗格,因此请确保正在使用受支持的加载项扩展点

创建加载项清单文件

每个加载项都由一个清单描述,一个文档,它向服务器提供有关外接程序的信息,为用户提供有关外接程序的描述性信息,并标识外接程序 UI HTML 文件的位置。 可以在本地文件夹或服务器上存储该清单,只要所测试的邮箱的 Exchange 服务器能够访问这个位置即可。 我们假定您在本地文件夹中存储清单。 有关如何创建清单文件的信息,请参阅 Office 外接程序清单

将加载项部署到 Web 服务器

可以使用 HTML 和 JavaScript 创建加载项。 生成的源文件存储在托管外接程序的 Exchange 服务器可以访问的 Web 服务器上。 最初为外接程序部署源文件后,可以通过将存储在 Web 服务器上的 HTML 文件或 JavaScript 文件替换为新版本的 HTML 文件来更新加载项 UI 和行为。

安装加载项

在准备外接程序清单文件并将外接程序 UI 部署到可以访问的 Web 服务器后,可以使用以下选项之一安装加载项。

注意

若要在邮箱中安装和管理加载项,必须为邮箱帐户分配 Exchange 中的 “我的自定义应用” 用户角色。 有关详细信息,请参阅指定可在 Exchange Online 中安装和管理 Outlook 加载项的管理员和用户

旁加载加载项

有关如何在 Outlook 中旁加载加载项的指导,请参阅 旁加载 Outlook 加载项进行测试

通过 Microsoft 365 管理中心部署加载项

测试 Outlook 加载项的另一个选项是通过Microsoft 365 管理中心将其部署到相关帐户。 在管理中心,转到 “设置>集成应用”。 然后,选择“ 上传自定义应用”。 有关详细信息,请参阅 通过集成应用门户部署和管理 Office 外接程序

使用远程 PowerShell 安装加载项

在 Exchange 服务器上创建远程 Windows PowerShell 会话后,可以运行 New-App cmdlet 和下列 PowerShell 命令,安装 Outlook 外接程序。

New-App -URL:"http://<fully-qualified URL">

完全限定的 URL 是为外接程序准备的外接程序清单文件的位置。

使用下列附加 PowerShell cmdlet,管理邮箱的加载项。

  • Get-App - 列出为邮箱启用的外接程序。
  • Set-App - 在邮箱中启用或禁用外接程序。
  • Remove-App - 从 Exchange 服务器中删除以前安装的外接程序。

客户端版本

若要决定测试什么版本的 Outlook 客户端,请综合考虑自己的开发需求。

  • 如果要开发外接程序供私人使用,或者仅针对组织成员开发,请务必测试公司使用的 Outlook 版本。 请记住,某些用户可能会使用 Outlook 网页版,因此测试公司的标准浏览器版本也很重要。

  • 如果要开发外接程序以在 Microsoft 市场中列出,则必须测试 商业市场认证策略 1120.3 中指定的所需版本。 这包括:

    • 最新版 Windows 版 Outlook 和前一个版本。
    • 最新版 Mac 版 Outlook。
    • 最新 iOS 版和 Android 版 Outlook(如果加载项支持移动设备规格)。
    • 商业市场验证策略 1120.3 中指定的浏览器版本。

注意

如果由于请求的 API 要求集不受客户端支持,导致外接程序不支持上述客户端之一,将从所需客户端列表中删除相应客户端。

Outlook 网页版和 Exchange 服务器版本

在访问 Outlook 网页版时,消费者和 Microsoft 365 帐户用户将看到新式 UI 版本,而不会再看到已弃用的经典版本。 但是,本地 Exchange 服务器将继续支持经典 Outlook 网页版。 因此,在验证过程中,你的提交可能会收到一条警告,指出加载项与经典 Outlook 网页版不兼容。 在这种情况下,需考虑在本地 Exchange 环境中测试加载项。 此警告不会阻止你提交到 Microsoft 市场,但如果客户在本地 Exchange 环境中使用Outlook 网页版,他们可能会遇到不理想的体验。

为缓解此问题,我们建议你在连接到你自己的专用本地 Exchange 环境的 Outlook 网页版中对加载项进行测试。 有关详细信息,请参阅在 Exchange Server 中建立Exchange Server测试环境和Outlook 网页版

或者,你也可以选择付费并使用托管和管理本地 Exchange 服务器的服务。 可用的选项有:

此外,如果不想面向连接到本地 Exchange 的用户提供自己的加载项,可将加载项清单中的要求集设置为 1.6 或更高版本。 在经典 Outlook 网页版上,不会对此类加载项进行测试或验证。

另请参阅