将 Outlook on Mac 中的 Outlook 外接程序支持与其他 Outlook 客户端进行比较

可以在 Outlook on Mac 中创建和运行 Outlook 加载项的方式与其他客户端相同,包括 Outlook 网页版、Windows (新的和经典) 、iOS 和 Android,而无需为每个客户端自定义 JavaScript。 从外接程序对 Office JavaScript API 的相同调用通常以相同方式工作,但下表中所述的区域除外。

有关详细信息,请参阅部署和安装 Outlook 外接程序以进行测试

领域 Outlook 网页版、Windows (新的和经典) 以及移动设备 Mac 版 Outlook
支持的 office.js 版本 Office.js 中的所有 API。 Office.js 中的所有 API。

注意:在 Outlook on Mac 中,只有版本 16.35 (20030802) 或更高版本支持保存会议。 否则, saveAsync 当在撰写模式下从会议调用 时,方法将失败。 若需解决办法,请参阅无法在 Outlook for Mac 中使用 Office JS API 将会议另存为草稿
定期约会系列实例
  • 可以获得主约会的项目 ID 和其他属性或定期系列约会的实例
  • 可以使用 mailbox.displayAppointmentForm 显示定期序列的实例或主项目。
  • 可以获得主约会的项目 ID 和其他属性,但无法获得定期系列约会的实例
  • 可以显示定期系列的主约会。 不显示项目 ID 和定期系列的实例。
约会参与者的收件人类型 可以使用 EmailAddressDetails.recipientType 标识与会者的收件人类型。 EmailAddressDetails.recipientType 为约会与会者返回 undefined
客户端应用程序的版本字符串 诊断.hostVersion 返回的版本字符串的格式取决于 Outlook 客户端。
  • Windows 上的 Outlook:返回 Outlook 客户端的版本。 例如,16.0.4454.1002
  • Outlook 网页版和新的 Windows 版 Outlook:返回Exchange Server的版本。 例如,15.0.918.2
调用 diagnostics.hostVersion 返回 Outlook 客户端的版本。 例如,16.0 (140325)
项目自定义属性 如果网络出现故障,外接程序仍可以访问缓存的自定义属性。 由于 Outlook on Mac 不缓存自定义属性,因此如果网络出现故障,外接程序将无法访问它们。
附件详细信息 AttachmentDetails 对象中的内容类型和附件名称取决于客户端的类型:
  • AttachmentDetails.contentType 的 JSON 示例:"contentType": "image/x-png"
  • AttachmentDetails.name 不包含任何文件扩展名。 例如,如果附件是主题为“RE: Summer activity”的邮件,则表示附件名称的 JSON 对象为 "name": "RE: Summer activity"
  • AttachmentDetails.contentType 的 JSON 示例:"contentType" "image/png"
  • AttachmentDetails.name 始终包含文件扩展名。 作为邮件项目的附件包含 .eml 扩展名,约会包含 .ics 扩展名。 例如,如果附件是主题为“RE: Summer activity”的电子邮件,则表示附件名称的 JSON 对象为 "name": "RE: Summer activity.eml"

    注意:如果文件以编程方式附加 (例如通过没有扩展名的加载项) ,则 AttachmentDetails.name 不会将扩展名作为文件名的一部分包含。

表示 dateTimeCreateddateTimeModified 属性中的时区的字符串 示例:Thu Mar 13 2014 14:09:11 GMT+0800 (China Standard Time) 示例:Thu Mar 13 2014 14:09:11 GMT+0800 (CST)
dateTimeCreateddateTimeModified 的时间准确度 如果外接程序使用以下代码,准确度精确到毫秒。
JSON.stringify(Office.context.mailbox.item, null, 4);
准确度精确到秒。

新 Mac UI 上的 Outlook 中的加载项支持

新的 Mac UI (现在支持 Outlook 加载项,) 版本 16.38.506 中提供。 对于新 Mac UI 中当前支持的要求集,请参阅 Outlook API 要求集客户端支持

若要了解有关新 Mac UI 的详细信息,请参阅新Outlook for Mac

可以确定你使用的是哪个 UI 版本,如下所示:

经典 UI

Mac 上的经典 UI。

新建 UI

Mac 上的新 UI。

支持具有 Microsoft 365 的统一清单的加载项

使用 Microsoft 365 统一清单 的外接程序在 Outlook on Mac 中不受直接支持。 若要运行这种类型的外接程序,必须先将其发布到Microsoft市场,然后部署在Microsoft 365 管理中心中。 然后,从统一清单生成仅加载项清单,该清单使加载项能够安装在 Outlook on Mac 中。

注意

使用统一清单的自定义加载项或业务线 (LOB) 加载项可以在Microsoft 365 管理中心的集成应用门户中部署,但它们无法在 Outlook on Mac 中安装。

有关详细信息,请参阅 Office 加载项的“客户端和平台支持”部分 ,其中包含 Microsoft 365 的统一应用清单