维护 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 应用版。应用保证工程师可以帮助解决你可能遇到的任何问题，无需额外付费。

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

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

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

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

office-js NPM 包是托管在Office.js 内容分发网络上的内容的副本， (CDN) 。它适用于无法直接访问 CDN 的方案。 NPM 包不打算为 office.js 提供版本控制引用。强烈建议始终使用 CDN，以确保使用最新版本的 Office JavaScript API。

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

在加载项中添加功能或修复 bug 时，需要部署更新。如果外接程序由一个或多个管理员部署到其组织，则某些清单更改将要求管理员同意更新。在授予同意之前，将阻止用户从外接程序中访问。以下清单更改需要管理员再次同意。

注意

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

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