版本策略

SocketIO4j 版本策略

socketio4j 遵循 语义化版本控制 使用格式：

x.y.z  →  主版本.次版本.补丁

版本号语义

主版本 (x)

在以下情况下递增：

• 引入了破坏性 API 更改

• 协议行为发生更改

• 发生重大的架构重设计

次版本 (y)

在以下情况下递增：

• 添加新功能或 API

• 向后兼容性得到保留

补丁 (z)

在以下情况下递增：

• 应用错误修复

• 进行性能改进

• 内部重构不影响公共 API

主版本策略

3.x – 兼容线

• 与上游分支保持兼容

• 与上游的分歧最小

• 专注于稳定性和修复错误

• 不进行重大 API 重设计

3.y.z

4.x – 长期支持线（即将到来）

• 引入新 API 和扩展功能

• 包括架构和性能改进

• 为生产和企业使用而设计

• 在 4.x 线内保持向后兼容

当前状态： 4.0.0 当前处于 快照（SNAPSHOT） 并处于积极开发中。 一旦发布为 GA， 4.x 将成为长期支持（LTS）线.

4.0.0-SNAPSHOT   ← 当前
4.y.z            ← 未来的 LTS 发布

5.x – 开发线（计划中）

• 面向未来并具有实验性质

• 可能引入破坏性更改

• 快速迭代和功能探索

• 不建议用于生产环境

5.0.0-SNAPSHOT

发布限定符

预发布版本通过后缀限定符标识 在 GA 之前:

限定符	说明
-SNAPSHOT	积极开发中，不稳定
-M1, -M2	里程碑版本
-RC1, -RC2	候选发布（Release Candidate）
（无后缀）	一般可用（GA）

发布流程示例

4.0.0-SNAPSHOT
4.0.0-M1
4.0.0-RC1
4.0.0        ← GA（LTS）

---

稳定性与支持保障

• GA 发布 可用于生产

• 补丁发布（x.y.z) ）向后兼容

• 次要发布（x.y) ）在不破坏 API 的情况下添加功能

• 主要发布（x) ）可能引入破坏性更改

• LTS（4.x） 将收到：

  • 关键错误修复

  • 安全更新

  • 长期维护

• SNAPSHOT 版本应该 绝不 在生产中使用

• 里程碑（-M）和候选发布（-RC）版本用于验证和反馈

• 只有 GA 发布 被视为完全稳定