|
1 | 1 |
|
2 | | -# 1.0.1(2025/08/07) |
3 | | -### 新增 |
4 | | -* 无 |
| 2 | +本文介绍网易云信服务端 Java SDK 的更新日志。具体功能请前往 [集成 SDK](https://doc.yunxin.163.com/messaging2/server-apis/jQxNjEwMjI?platform=server) 体验。 |
5 | 3 |
|
6 | | -### 更新 |
7 | | -* 规范YunxinV1ApiServices的命名 |
| 4 | +<style> |
| 5 | +table th:first-of-type {width: 20%;} |
| 6 | +table th:nth-of-type(2) {width: 40%;} |
| 7 | +table th:nth-of-type(3) {width: 40%;} |
| 8 | +</style> |
8 | 9 |
|
9 | | -### fix |
10 | | -* 无 |
| 10 | +## 1.0.1 (2025-08-07) |
11 | 11 |
|
| 12 | +**新增功能** |
12 | 13 |
|
13 | | -# 1.0.0(2025/08/07) |
14 | | -### 新增 |
15 | | -* 新增 `IM` 面向对象接口封装 |
| 14 | +**面向对象 IM 接口封装**:全新推出面向对象的 IM 服务接口,大幅简化开发体验。开发者无需再处理复杂的原始 API 调用,可通过直观的对象方法完成 IM 相关操作,如用户管理、消息发送、群组管理等。 |
16 | 15 |
|
17 | | -### 更新 |
18 | | -* 无 |
| 16 | +**缺陷修复** |
19 | 17 |
|
20 | | -### fix |
21 | | -* 修复默认域名不可用时,sdk初始化失败的问题 |
| 18 | +修复了当默认域名不可用时 SDK 初始化失败的问题,提升服务可用性。 |
22 | 19 |
|
| 20 | +**接口变更** |
23 | 21 |
|
24 | | -# 0.9.0(2025/06/30) |
25 | | -### 新增 |
26 | | -* 新增对 `RTC/SMS/LIVE/VOD/NEROOM/MEETING` 等业务的支持(目前仅支持raw-client) |
| 22 | +根据 API 服务类命名规范,修改部分代码命名。 |
27 | 23 |
|
28 | | -### 更新 |
29 | | -* PrometheusConverter新增biz字段,用于标识 IM/RTC/NEROOM/SMS/MEETING 等业务属性 |
30 | | -* 修改了包名,包名前缀从 `com.netease.nim.im.server.sdk` 修改为 `com.netease.nim.server.sdk` ,以便实现对非IM业务的支持(破坏性更新) |
31 | | -* maven仓库依赖的 `artifactId` 从 `yunxin-im-server-sdk` 修改为 `yunxin-server-sdk` ,以便实现对非IM业务的支持(破坏性更新) |
32 | | -* `HttpCodeException` 和 `YunxinSdkException` 的 `message` 中,增加 `bizName` 描述 |
| 24 | +| 变更项目 | 原值 | 新值 | |
| 25 | +| ---| ---| --- | |
| 26 | +| 接口 | `getSuperTeamV1Service` | `getSuperTeamService` | |
| 27 | +| 实例 | `superTeamV1Service` | `superTeamService` | |
33 | 28 |
|
34 | | -### fix |
35 | | -* PrometheusConverter格式化输出中耗时分位数相关metric的字段错误的问题 |
| 29 | +**兼容性** |
36 | 30 |
|
| 31 | +完全向后兼容,无需修改现有代码。 |
37 | 32 |
|
38 | | -# 0.2.0(2025/03/21) |
39 | | -### 新增 |
40 | | -* 在发起请求之前,允许设置超时,从而可以对单次请求设置和全局超时配置不一样的超时时间 |
| 33 | +**兼容性** |
41 | 34 |
|
42 | | -### 更新 |
43 | | -* 一个appkey/appsecret组合仅允许初始化YunxinHttpClient一次,多次初始化将直接报错 |
| 35 | +向后兼容,现有基于原始 API 的代码可正常运行。 |
44 | 36 |
|
45 | | -### fix |
46 | | -* 无 |
| 37 | +## 0.9.0 (2025-06-30) |
47 | 38 |
|
| 39 | +**新增功能** |
48 | 40 |
|
49 | | -# 0.1.0(2024/12/24) |
50 | | -### 新增 |
51 | | -* 第一个release版本 |
52 | | -* 提供sdk核心功能,包括:多域名切换和调度策略、重试策略、监控、trace等 |
53 | | -* 提供云信v1-api的raw-client,以及创建账号的面向对象client |
54 | | -* 提供云信v2-api的raw-client,以及创建账号、更新账号、查询账号的面向对象client |
| 41 | +**多业务线支持**:新增对音视频通话 RTC、短信服务 SMS、直播 LIVE、点播 VOD、房间组件 NEROOM、网易会议组件 MEETING 等业务的支持。您可以通过统一的 SDK 管理多条业务线,简化集成复杂度。 |
55 | 42 |
|
56 | | -### 更新 |
57 | | -* 无 |
| 43 | +**功能优化** |
58 | 44 |
|
59 | | -### fix |
60 | | -* 无 |
| 45 | +- **监控指标增强**:`PrometheusConverter` 新增 biz 字段,用于区分 IM、RTC、NEROOM、SMS、MEETING 等不同业务的监控数据,便于运维团队精细化监控和问题定位。 |
| 46 | +- **异常信息优化**:`HttpCodeException` 和 `YunxinSdkException` 的错误信息中新增 `bizName` 描述,帮助开发者快速识别异常来源的业务模块。 |
| 47 | + |
| 48 | +**缺陷修复** |
| 49 | + |
| 50 | +修复 `PrometheusConverter` 格式化输出中耗时分位数相关指标字段错误的问题,确保监控数据的准确性。 |
| 51 | + |
| 52 | +**兼容性** |
| 53 | + |
| 54 | +- ⚠️**破坏性更新**:为支持多业务线,进行了以下调整。 |
| 55 | + |
| 56 | + 变更项目 | 原值 | 新值 | |
| 57 | + ---| ---| --- | |
| 58 | + 包名前缀 | `com.netease.nim.im.server.sdk` | `com.netease.nim.server.sdk` | |
| 59 | + Maven artifactId | `yunxin-im-server-sdk` | `yunxin-server-sdk` | |
| 60 | + |
| 61 | +- **升级指南**:请更新 Maven 依赖配置,并调整 `import` 语句中的包名。 |
| 62 | + |
| 63 | +## 0.2.0 (2025-03-21) |
| 64 | + |
| 65 | +**新增功能** |
| 66 | + |
| 67 | +**单次请求超时配置**:支持在发起请求前动态设置超时时间,允许为特定请求设置与全局配置不同的超时值。适用于处理耗时不同的业务场景,如文件上传、批量数据处理等对超时要求不同的操作。 |
| 68 | + |
| 69 | +**功能优化** |
| 70 | + |
| 71 | +**SDK 初始化安全性增强**:同一个网易云信开发者账号的 appkey/appsecret 组合,仅允许初始化 `YunxinHttpClient` 一次,重复初始化会立即抛出错误。避免因误操作导致的资源浪费和潜在的配置冲突问题。 |
| 72 | + |
| 73 | +**兼容性** |
| 74 | + |
| 75 | +- 大部分场景向后兼容。 |
| 76 | +- 如果现有代码中存在重复初始化 `YunxinHttpClient` 的情况,需要进行相应调整。 |
| 77 | + |
| 78 | +## 0.1.0 (2024-12-24) |
| 79 | + |
| 80 | +**新增功能** |
| 81 | + |
| 82 | +- **SDK 核心功能**:首个正式版本发布,提供完整的 SDK 核心能力,包括智能多域名切换和调度策略、自动重试机制、全链路监控、分布式链路追踪等企业级特性。适用于对服务可用性和可观测性有高要求的生产环境。 |
| 83 | + |
| 84 | +- **网易云信 V1 IM API 支持**:提供网易云信 V1 版本 API 的原始客户端调用能力,同时封装了用户账号创建的面向对象接口。适用于需要使用 V1 版本 API 的存量业务和账号管理场景。 |
| 85 | + |
| 86 | +- **网易云信 V2 IM API 支持**:提供网易云信 V2 版本 API 的原始客户端调用能力,并封装了账号创建、更新、查询的完整面向对象接口。适用于新接入的业务和需要更丰富账号管理功能的场景。 |
| 87 | + |
| 88 | +**兼容性** |
| 89 | + |
| 90 | +首个版本,建立基础兼容性规范。 |
0 commit comments