向后兼容性说明
我们努力开发我们的产品,使其尽可能地向后兼容 (BC)。
只有主要版本(例如 4.0、5.0 等)才允许破坏向后兼容性。次要版本(例如 4.2、4.3 等)可能会引入新功能,但必须在不破坏现有 API 的情况下进行。
但是,代码还不成熟,错误修复可能会在次要版本甚至补丁版本(例如 4.2.5)中破坏兼容性。在这种情况下,所有破坏性更改都将在 更改日志 中描述。
哪些不是破坏性更改
弃用的项目不受向后兼容性 (BC) 承诺的约束。它可能在下一个下一个 **次要** 版本或更高版本中被删除。例如,如果某个项目从 4.3.x 开始就被弃用,它可能在 4.5.0 中被删除。
在 **system/Language/en/** 中定义的系统消息严格用于内部框架使用,不受向后兼容性 (BC) 承诺的约束。如果开发人员依赖于语言字符串输出,他们应该检查它与函数调用 (
lang('...')
) 相匹配,而不是内容。命名参数 不受向后兼容性 (BC) 承诺的约束。我们可能会选择在必要时重命名方法/函数参数名称以改进代码库。