SDK 与接口版本#
| SDK 版本 | 发布日期 | 接口版本 | 契约版本 | 状态 |
|---|---|---|---|---|
2.1.2 |
2026-10-13 | v1 | 2.1 |
当前版本，只发了安卓与 iOS 两个声通平替，新增中文开放题 open.eval.cn |
2.1.1 |
2026-10-13 | v1 | 2.1 |
只发了安卓与 iOS 两个声通平替，可直接升级到 2.1.2 |
2.1.0 |
2026-10-12 | v1 | 2.1 |
五端的当前版本，两个声通平替可直接升级到 2.1.2 |
2.0.0 |
2026-10-08 | v1 | 2.0 |
可用，可直接升级到 2.1.0 |
1.0.0 |
2026-06-24 | v1 | 1.x |
停止维护，2.0 起改包名与坐标，迁移见 MIGRATION-2.0.md |
接口 v1 在 SDK 2.0.0 发布时新增幂等，心跳与错误码细分，全部向后兼容，1.0.0 版本 SDK 仍可调用。SDK 2.1.0 发布时接口 v1 新增实时评测朗读进度帧，只在客户端请求时下发，2.0.0 版本 SDK 不受影响。
各端最低版本#
| 端 | 制品 | 语言与工具链 | 运行环境最低版本 |
|---|---|---|---|
| 服务端 Java | com.shengzhiai.yugu:yugu-java-sdk:2.1.0 |
Java 11 字节码，构建用 JDK 17 与 Maven 3.8 | JDK 11 |
| 安卓 | com.shengzhiai.yugu:yugu-android-sdk:2.1.0 |
Kotlin 1.9，AGP 8.5，Java 8 字节码 | Android 5.0，API 21 |
| 安卓声通平替 | com.shengzhiai.yugu:stkouyu-compat:2.1.2 |
Java 8 字节码，无第三方依赖 | Android 5.0，API 21 |
| 网页 | @shengzhiai/yugu-web-sdk@2.1.0 |
ES2018，附 TypeScript 声明 | Chrome 73，Edge 79，Firefox 68，Safari 13，Node 18 |
| 微信小程序 | @shengzhiai/yugu-miniprogram-sdk@2.1.0 |
ES2017 CommonJS，附 TypeScript 声明 | 基础库 2.20.1 |
| iOS | SwiftPM https://open.shengzhiai.com/git/yugu-ios-sdk.git 2.1.0 |
Swift 5.9，Xcode 15 |
iOS 13，macOS 11，YuguCore 另支持 Linux |
| iOS 声通平替 | SwiftPM https://open.shengzhiai.com/git/stkouyu-ios-compat.git 2.1.2 |
Objective-C | iOS 12，实时朗读进度需要 iOS 13 |
声通接口对应版本#
| 平替层 | 对齐的声通接口 |
|---|---|
安卓 com.stkouyu |
17kouyu_1.0.0.jar，Build.VERSION 为 1.0.62 的公开版本 |
iOS STKouyuEngine |
公开头文件 KYTestEngine.h，KYStartEngineConfig.h，KYTestConfig.h |
接入方手上的声通包版本不同时，用平替层附带的比对工具核对，见 SHENGTONG-MIGRATION.md。
版本规则#
版本号分主版本，次版本，修订号三段。修订号只修缺陷，次版本新增能力，同时保持兼容，接口或行为出现不兼容变化时升主版本，同时在 CHANGELOG.md 的破坏性变更一栏写明迁移方法。已发布的版本不会被覆盖，任何历史版本都可以按坐标重新拉取。