本文介绍Java SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。
变更说明
如表1所示，本节将为您展示Java SDK的版本变更情况和兼容性说明。
表1 Java SDK版本变更及兼容性说明 版本 | 变更类型 | 说明 | 是否兼容 |
|---|
v3.25.10 | 新功能 | 新功能： - 支持并行文件系统快照特性
- 支持桶qos特性
- 支持生命周期2.0
| 是 |
v3.25.7 | 新功能 | 新功能： | 是 |
v3.25.5 | 新功能 | 新功能： | 是 |
v3.25.4 | 新功能 问题修复和优化 | 新功能： - 支持设置okhttp的callTimeout
- 支持crr配置中的DeleteData
- 支持自定义域名相关配置
问题修复和优化： | 是 |
v3.24.12 | 新功能 | 新功能： - 支持bpa特性
- 支持智能分级特性
- 支持并行文件系统trash特性
| 是 |
v3.24.9 | 问题修复和优化 | 问题修复和优化： - 优化合并段的xml构建逻辑
- 优化xml解析逻辑
- 增加时间不正确导致请求失败时的自动重试
- 生命周期规则新增ExpiredObjectDeleteMarker属性
- 修复无法自动添加webp格式的ContentType的问题
| 是 |
v3.24.8 | 新功能 问题修复和优化 适配第三方组件 | 新功能： - PutObject、Getobject、GetObjectMetadata、UploadPart、AppendObject、CopyObject、CopyPart、CompeleMultiUploadPart支持crc64校验
- 断点续传上传支持暂停、取消
- 支持设置okhttp的EventListenerFactory，用于统计http请求各阶段耗时，默认关闭
问题修复和优化： - 优化断点续传上传时的进度条设置逻辑
- 优化部分日志打印格式
- 修复客户端加密只能在obs协议下使用的问题，增加加密算法为null时的判断
适配第三方组件： - 使用 okio 3.8.0 替代 okio 3.6.0
- 使用 log4j-core 2.20.0 替代 log4j-core 2.18.0
- 使用 jackson-core 2.15.4 替代 jackson-core 2.15.2
- 使用 jackson-databind 2.15.4 替代 jackson-databind 2.15.2
- 使用 jackson-annotations 2.15.4 替代 jackson-annotations 2.15.2
- 使用 log4j-api 2.20.0 替代 log4j-api 2.18.0
| 是 |
v3.24.3 | 问题修复和优化 适配第三方组件 | 问题修复和优化： - 优化某些堆栈的日志打印
- 增加client close时的日志打印
- 优化重试逻辑
- 优化临时url的路径编码逻辑
- 优化解析、生成时间字符串的性能
- 优化xml生成逻辑
- 修复域名校验不正确的问题
- 修复部分空指针问题
- 修复拷贝对象时的元数据设置不生效的问题
- 客户端加密功能的安全整改
适配第三方组件： - 使用 okhttp 4.12.0 替代 okhttp 4.11.0
- 使用 okio 3.6.0 替代 okio 3.5.0
- 使用 jackson-core 2.15.2 替代 jackson-core 2.13.3
- 使用 jackson-databind 2.15.2 替代 jackson-databind 2.13.4.1
- 使用 jackson-annotations 2.15.2 替代 jackson-annotations 2.13.3
| 是 |
v3.23.9.1 | 新功能 适配第三方组件 | - 新功能：支持设置自定义dns解析器
- 适配第三方组件：移除 java-xmlbuilder，使用默认的javax.xml库
| 是 |
v3.23.9 | 新功能 适配第三方组件 | 新功能： - 新增配置桶清单接口
- 新增客户端加密
- 支持在生命周期规则中配置碎片过期时间
适配第三方组件： - 使用 okio 3.5.0 替代 okio 2.10.0
- 使用 okhttp 4.11.0 替代 okhttp 4.10.0
| 是 |
v3.23.5 | 新功能 | 新功能： - 新增双写桶功能
- 支持标准存储、低频存储、归档存储
- 三种桶容量的统计
| 是 |
v3.23.3 | 新功能 适配第三方组件 | 新功能： - 支持crr进度查询
- 新增对象标签接口（设置、获取、删除 对象标签）
适配第三方组件： - 使用 powermock-module-junit4 2.0.9 替代 powermock-module-junit4 1.6.5
- 使用 powermock-api-mockito2 2.0.9 替代 powermock-api-mockito 1.6.5
- 使用 mockito-core 4.11.0 替代 mockito-core 1.10.19
| 是 |
v3.22.12 | 新功能 适配第三方组件 | 新功能： - Java SDK支持深度归档
- Java SDK 实现 posix accesslable相关接口
适配第三方组件： - 使用 log4j2 2.18.0 替代 log4j2 2.17.1
- 使用 okhttp 4.10.0 替代 okhttp 4.9.3
- 使用 jackson-core 2.13.3 替代 jackson-core 2.13.0
- 使用 jackson-databind 2.13.4.1 替代 jackson-databind 2.13.0
- 使用 jackson-annotations 2.13.3 替代 jackson-annotations 2.13.0
| 是 |
低于v3.22.12（停止配套，EOM） | - | 版本过低，已停止维护，建议及时升级版本。 | - |
完整的版本变更情况请参见：ChangeLog。
兼容性说明
- 推荐使用的JDK版本：JDK 8及以上版本。
- 旧版本（2.x）已不再维护，建议尽快升级至最新版。
