维护 Office 加载项

发布加载项后,应使其与上游库中的任何重要更改保持同步。 修补安全问题对于建立客户信任至关重要。 由于这些更改对已发布的清单没有影响,因此客户无需执行任何操作即可获取外接程序的最新版本。

Office.js 中的中断性变更

Microsoft 365 开发人员平台致力于确保加载项的兼容性。 我们努力避免对 API 表面和行为进行中断性变更。 但是,在某些情况下,为了安全性或可靠性,我们需要进行中断性更新。 在这些极少数情况下,将采取以下步骤来确保外接程序的用户不受影响。

  • Microsoft 365 开发人员博客上发布了描述受影响功能和建议更改的公告。
  • 如果你的外接程序在 AppSource 中发布,将通过你提供的信息联系你。
  • 如果可能,受影响的 Microsoft 365 个租户 ((包括 Microsoft 365 开发人员计划租户) )的管理员将通过 消息中心联系。 管理员负责联系 AppSource 外部发布的外接程序解决方案提供商。

弃用策略

可能已弃用具有更好替代方案的 API 或工具。 Microsoft在停用前至少 24 个月尽最大努力将其声明为已弃用。 同样,对于通常可用的 (GA) 单个 API,Microsoft 会在从 GA 版本将其删除之前至少 24 个月时声明其为弃用产品。

弃用并不一定意味着功能或 API 将被开发人员删除并不可用。 它确实显示,在 24 个月时间段之后,Microsoft将不再支持 API 或功能。

当 API 被标记为已弃用时,我们强烈建议你尽快迁移到最新版本。 在某些情况下,我们将宣布新应用程序必须在原始 API 弃用后不久开始使用新 API。 在这些情况下,仅当前使用已弃用 API 的活动应用程序能够继续使用它们。

重要

如果等待该时间对加载项或Microsoft造成安全风险,则 24 个月的弃用期将加快。

应用保证

Microsoft的应用保证服务实现了Microsoft对应用程序兼容性的承诺:你的应用将在 Windows 和 Microsoft 365 应用版 上运行。 应用保证工程师可以帮助解决你可能遇到的任何问题,无需额外付费。

如果确实遇到应用兼容性问题,应用保证工程师将与你一起帮助你解决问题。 我们的专家将:

  • 帮助你排查和确定根本原因。
  • 提供指导来帮助修正应用程序兼容性问题。
  • Engage独立软件供应商 (ISV) 代表你修正其应用的某些部分,使其适用于我们产品的最新版。
  • 与Microsoft产品工程团队合作,修复产品 bug。

若要了解有关应用保证的详细信息,watch使用应用保证将应用带到 Microsoft Edge:提示和技巧。 若要提交应用与 App Assure 的兼容性请求,请填写Microsoft FastTrack注册表单或发送电子邮件至 achelp@microsoft.com

对 Yeoman 模板和 Web 依赖项的更改

适用于 Office 加载项的 Yeoman 生成器依赖于来自 Microsoft 等许多库。 这些库独立于任何Microsoft 365 活动进行更新。 使用生成器创建的任何项目都应在开发、发布和维护加载项时保持最新。 以下工具可帮助确保项目使用任何依赖库的安全版本。

本指南也适用于从 Office 外接程序代码示例 和其他源获取的示例副本。

当前最佳做法

虽然我们努力保持向后兼容性,但我们建议的模式和做法会不断改进。 我们的文档致力于介绍当前的最佳做法。 若要随时了解可能改进现有功能的新功能,请加入我们的每月 Office 加载项社区通话

更新加载项

更新外接程序时,需要考虑两个部分:Web 应用程序和清单。 汇报 Web 应用程序不需要用户执行任何操作。 这些用户在其 Office 应用程序中仅具有清单。 对清单的更改确实需要用户进行更新。 如果已将加载项发布到 AppSource,则需要更新提交。 有关该过程的详细信息,请参阅 更新现有产品/服务一文。

每当对清单进行更改时,都必须引发清单的版本号。

  • 如果外接程序使用仅外接程序清单,请参阅 Version 元素
  • 如果外接程序使用统一清单,请参阅 version 属性

如果外接程序由一个或多个管理员部署到其组织,某些清单更改需要管理员同意更新。 在授予同意之前,将阻止用户从外接程序访问。 以下清单更改需要管理员再次同意。

社区参与

由于建议对 Microsoft 365 开发人员平台进行更新,我们将听取反馈。 请向 Office 加载项其他资源中列出的频道报告问题、潜在后果或其他问题。