后向兼容性说明

我们尽力开发具有尽可能好的后向兼容性(BC)的产品。

只有主版本发布(如 4.0、5.0 等)允许破坏后向兼容性。 次版本发布(如 4.2、4.3 等)可以引入新特性,但必须在不破坏现有 API 的情况下实现。

然而,代码还不够成熟, bug 修复可能会在次版本发布甚至补丁版本发布(如 4.2.5)中破坏兼容性。在这种情况下,所有破坏兼容性的更改都会在 变更记录 中描述。

什么不是破坏兼容性的更改

• 已弃用的项目不受后向兼容性(BC)承诺约束。它可能会在下一个 次要 版本或更高版本中被移除。例如，如果一个项目从 4.3.x 版本开始被弃用，那么它可能会在 4.5.0 版本中被移除。

• 定义在 system/Language/en/ 中的系统消息严格用于内部框架使用,不受后向兼容性(BC)承诺约束。如果开发者依赖语言字符串输出,应该检查函数调用 (lang('...')),而不是内容。

• 命名参数 不受后向兼容性(BC)承诺约束。当必要时,我们可能会重命名方法/函数的参数名以改进代码库。