重大变更和弃用

重大变更

重大变更是指对以下内容的修改，这些修改可能导致现有的第三方应用程序或脚本在升级到下一个稳定的小版本的 Dapr 工件（如 SDK、CLI、runtime 等）后出现编译错误或运行时问题：

• 代码行为
• 架构
• 默认配置值
• 命令行参数
• 发布的指标
• Kubernetes 资源模板
• 公开访问的 API
• 公开可见的 SDK 接口、方法、类或属性

以下情况可以立即应用重大变更：

• 版本未达到 1.0.0 的项目
• 预览功能
• Alpha API
• SDK 中的预览或 Alpha 接口、类、方法或属性
• 处于 Alpha 或 Beta 阶段的 Dapr 组件
• github.com/dapr/components-contrib 的接口
• 文档和博客中的 URL
• 例外情况，需要修复关键错误或安全漏洞。

应用重大变更的流程

应用重大变更需要遵循以下流程：

1. 弃用通知必须作为发布的一部分进行发布。
2. 重大变更将在弃用公告发布后的两个版本后生效。
   • 例如，功能 X 在 1.0.0 版本说明中宣布弃用，然后将在 1.2.0 中移除。

弃用

弃用可以应用于：

1. API，包括 alpha API
2. 预览功能
3. 组件
4. CLI
5. 可能导致安全漏洞的功能

弃用信息会在发布说明中名为“弃用”的部分中列出，说明：

• 当前弃用的功能将在未来某个版本中不再受支持。例如，发布 x.y.z。这至少是在两个版本之前。
• 在发布说明中记录用户需要采取的任何步骤以修改其代码、操作等（如果适用）。

在宣布未来的重大变更后，该变更将在 2 个版本或 6 个月后生效，以较长者为准。弃用的功能应响应警告，但除此之外不执行任何操作。

已宣布的弃用

相关链接

• 阅读 版本政策
• 阅读 支持的发布