通过

为新的 Windows 版 Outlook 开发 Outlook 加载项

新的 Outlook on Windows 桌面客户端统一 Windows 和 Web 代码库，为用户和管理员创建更一致的 Outlook 体验。 其新式和简化的界面增加了功能，旨在提高用户的工作效率、组织和协作。 更重要的是，新的 Outlook on Windows 支持 Outlook Web 加载项，以便你可以继续扩展 Outlook 的功能。

对 VSTO 和 COM 加载项的影响

新的 Windows 版 Outlook 旨在统一所有 Outlook 平台的扩展体验。 为了提供更可靠、更稳定的外接程序体验，新的 Outlook on Windows 不支持 VSTO 和 COM 加载项。 若要确保外接程序继续在新的 Outlook on Windows 中工作，必须将 VSTO 或 COM 加载项迁移到 Outlook Web 外接程序。 迁移到 Outlook Web 加载项不仅可实现与新 Outlook on Windows 的兼容性，而且还使你的解决方案可供其他平台（如 Mac 版 Outlook、移动设备或 Web 版）上的用户使用。

若要帮助你开始迁移过程，请查看以下指南。

注意

经典 Outlook on Windows 中仍支持 VSTO 和 COM 加载项。

Outlook Web 加载项中支持的方案

Outlook Web 加载项使用的 Outlook JavaScript API 开发侧重于缩小仅 VSTO 和 COM 外接程序解决方案支持的方案的差距。 这样，过渡到 Outlook Web 加载项的用户可以继续获得无缝体验。

下表标识了主要 Outlook 方案及其在 Web 外接程序中的支持状态。 此表将随着支持其他方案而更新。 计划迁移 VSTO 或 COM 加载项时，请定期检查此部分。

提示

当我们继续更新受支持方案表时，如果想要查看最近所做的更改，请从文章右上角选择 “编辑此文档 (铅笔图标) ”，然后选择“ 历史记录”。

若要了解有关预览版 Outlook 外接程序功能的详细信息，请参阅 Outlook 外接程序API 预览要求集。

应用场景 说明 Outlook Web 加载项中的支持状态 相关功能和示例
垃圾邮件报告和教育 使用户能够报告未经请求且可能不安全的消息，并了解如何识别这些消息。 支持。
联机会议 允许用户创建和加入联机会议。 支持。
会议增强功能 为安排会议的用户提供其他服务，例如位置选择、餐饮服务、会议室照明和温度调整。 支持。
联机签名 自动向邮件和约会添加主题签名。 支持。
客户关系管理 (CRM) 和跟踪服务 使用户能够从其 CRM 系统发送和检索信息，以跟踪与现有和潜在客户的通信。 支持。
内容重用 使用户能够从合作伙伴系统传输和检索文本和其他内容类型。 支持。
邮件项转换 使用户能够将邮件项转换为其他格式。 支持。
项目管理 使用户能够从合作伙伴系统创建和跟踪项目工作项。 支持。
附件管理 允许用户从合作伙伴位置导入或导出附件。 支持。
邮件加密 使用户能够加密和解密邮件。 部分支持。 尚未解决基本功能，以创建与 VSTO 或 COM 加载项类似的体验。
数据丢失防护 防止用户转发包含高度敏感信息的邮件项目。 支持。
邮件项分类 使用户能够识别和分类包含敏感信息的邮件。 部分支持。 尚未解决基本功能，以创建与 VSTO 或 COM 加载项类似的体验。
数据同步服务 启用邮件项与合作伙伴系统的双向同步。 部分支持。 尚未解决基本功能，以创建与 VSTO 或 COM 加载项类似的体验。
校对邮件项目 为用户提供撰写邮件时的实时校对帮助。 目前尚不支持。 不可用

可通过加载项扩展 Outlook 功能。如果 VSTO 或 COM 加载项解决方案不适合表中的任何方案， 请完成调查以共享你的方案。

对经典 Outlook on Windows 的支持

具有 Microsoft 365 订阅或 Office 2016 零售永久版或更高版本的 Windows 经典 Outlook 将继续支持开发新的和现有的 Outlook Web 加载项。此外，它将继续接收最新 Outlook 加载项功能的发布。

在新的 Outlook on Windows 中测试加载项

立即在新版 Outlook on Windows 中测试 Outlook Web 加载项！ 若要切换到新的 Windows 版 Outlook，必须满足以下要求。

  • Microsoft 365 工作或学校帐户连接到Exchange Online。 新客户端当前不支持本地、混合或主权 Exchange 帐户。

    注意

    虽然可以将非Microsoft邮件帐户（如 Gmail）添加到新的 Windows 版 Outlook，但只能将 Outlook 加载项与Microsoft帐户一起使用。 有关详细信息，请参阅 Outlook 加载项概述的“支持的帐户”部分。

  • 具有最低作系统安装版本 1809 Windows 10 (内部版本 17763) 。

若要帮助你安装和设置 Outlook 桌面客户端，请参阅 新的 Outlook for Windows 入门。

有关如何旁加载加载项的指导，请参阅 旁加载 Outlook 加载项进行测试。

提示

  • 如果要从 Windows 上的经典 Outlook 客户端移动到新的 Outlook 客户端，请注意加载项的位置不同。 虽然从经典 Outlook 客户端的功能区或应用栏访问加载项，但访问新 Outlook 客户端中的加载项取决于是阅读还是撰写邮件项目。 若要了解详细信息，请参阅 在 Outlook 中使用加载项。
  • 在新的 Outlook on Windows 中，必须保持打开main客户端窗口才能运行加载项， (窗口) 可以处于活动状态或非活动状态。 如果最小化main窗口，外接程序将暂停或停止工作。

调试加载项

若要调试安装在新的 Outlook on Windows 桌面客户端中的加载项，请执行以下作：

  1. 关闭新的 Outlook on Windows 客户端（如果已打开）。

  2. 然后，在命令提示符下运行以下命令，打开新的 Outlook on Windows 客户端和 Microsoft Edge DevTools 实例。

    olk.exe --devtools

    提示

    运行命令后，DevTools 窗口将保持打开状态，以便可以在打开和关闭加载项时调试加载项的任务窗格。 如果关闭 DevTools 窗口，必须先关闭 Outlook 客户端，然后才能再次运行 olk.exe --devtools 。

  3. 将加载项旁加载到Outlook 网页版。

  4. 使用 Microsoft Edge DevTools 调试加载项。

脱机时的加载项可用性

在新的 Outlook on Windows 中打开 脱机设置 时，如果失去 Internet 连接，可以继续访问电子邮件和日历。 虽然某些功能仍然可用，但 Outlook 加载项以及 Microsoft 365 和 Copilot 存储在脱机时不可用。 下表描述了计算机脱机或间歇性连接时某些类型的外接程序的行为。

应用场景 任务窗格和函数命令加载项 基于事件的加载项
启动 Outlook 时无 Internet 连接 已安装的加载项不会显示在功能区或作栏上。 由于 Outlook 无法确定脱机时安装了哪些加载项，因此基于事件的外接程序在处理事件发生时无法激活。

在此方案中，为了确保智能警报加载项在发送邮件之前仍检查符合性，管理员可以在 PowerShell Exchange Online 配置 OnSendAddinsEnabled 邮箱策略。 配置后，传出邮件将保存到 “草稿 ”文件夹而不是 “发件箱” 文件夹，以防止计算机重新连接到 Internet 时自动发送。 有关详细信息，请参阅 使用智能警报处理 Outlook 外接程序中的 OnMessageSend 和 OnAppointmentSend 事件的“Outlook 启动时脱机”部分。
在脱机时启动 Outlook 后建立连接 已安装的加载项显示在功能区和作栏上。 Outlook 将能够确定安装了哪些基于事件的加载项。 然后，已安装的加载项可以在它们处理的事件发生时激活。

选择“发送”被 OnSendAddinsEnabled 邮箱策略阻止的邮件时，智能警报加载项将运行以检查符合性。
使用 Outlook 时计算机丢失连接 如果在使用 Outlook 时失去连接，则不会运行已安装的加载项。 将显示一个对话框或通知，以通知你处于脱机状态。 如果在事件发生时失去连接，则行为因基于事件的加载项的类型而异。
重新建立连接 已安装的加载项可以再次运行作。 已安装的加载项在发生事件时继续处理事件。 将发送已移动到 发件箱 文件夹的邮件。 发送 “草稿 ”文件夹中的邮件时，将激活智能警报加载项以确保符合性。

开发体验反馈

在新的 Outlook on Windows 中测试 Outlook Web 加载项时，请通过 GitHub 与开发人员社区分享有关体验的反馈。

另请参阅