生态桌面应用
版本兼容政策
言界 1.0、言台 1.0、工具链、协议和言窗之间的稳定兼容边界。
言窗 1.0 稳定线
| 组件 | 兼容范围 | 已验证版本 |
|---|---|---|
| 言序 | >=1.1.12 | 1.1.12 |
| 言包 | 格式 2 清单与锁、GUI Bundle | 0.5.x |
| 言窗 | ^1.0、ABI v2 | 1.0.0 |
| 平台 | Linux GNU、macOS、Windows | x86-64 / ARM64 |
言窗 Git 标签保存源码和清单模板;完整六目标包以 1.0.0 Release 归档发布。Linux GNU 制品需要 glibc 2.39,macOS 公开制品仅做临时签名。精确限制见言窗 1.0。
言界与言台 1.0 稳定线
| 组件 | 兼容范围 | 已验证版本 |
|---|---|---|
| 言序 | 言界源码>=1.1.9;正式 YXB 使用当前稳定工具链 | 1.1.9、1.1.20 |
| 言包 | 格式 2 清单、按目标生成的锁文件 | 0.6.1 |
| 言台 | ^1.0,言序>=1.1.7, <2.0.0,ABI v2 | 1.0.0 |
| 言界 | ^1.0 | 1.0.0 |
| 言据 | ^1.1 | 1.1.2 |
| 言窗 | 独立并行路线 | 1.0.0 |
言界 1.0 同时验证最低言序 1.1.9 的源码/API 兼容和言序 1.1.20 的正式构建与回放。应用 通常使用当前稳定工具链;最低版本是兼容下限,不是新项目的推荐降级目标。言界固定消费 言台 1.0 标签与言据 1.1.2 已审核提交,应用只直接声明言界即可。
言台 1.0 冻结 ABI v2、平台 1.7、事件 1.3、无障碍 1.0、绘制 1.1 和 70 个稳定错误码。
言界 1.0 冻结 30 个声明、23 个类、7 个包级函数、125 个域和 375 个方法,并用机器门禁
证明从v0.1.0到v0.9.0的已发布 API 仍可调用。两条 GUI 路线互不替换或强制迁移。
版本政策
1.0.x只接受向后兼容的实现、安全、文档和生产门禁修复;- 后续
1.x可以增加可选控件、方法、能力、事件或协议字段,但不能让旧调用新增必需条件; - 删除/重命名公开 API、收窄参数、扩大旧调用方必须处理的返回类型、改变单位、所有权或 二进制布局,必须进入新的包、协议或 ABI 主版本;
- 新增替代接口后,旧接口在整个 1.x 中继续可用并明确标为弃用;
- 言据主题与等价 JSON 入口、事件名称、布局单位和控件创建方法属于 1.x 兼容承诺。
已知限制
- 当前使用统一 CPU 二维后端,没有 GPU 后端、隔离离屏图层或任意旋转文字保证;
- 言界 1.0 没有表格、树、富文本或代码编辑器成品控件;
- 数据源不创建线程、网络请求或隐式异步调度;加载器的执行与取消由应用负责;
- 系统字体会导致跨系统文字像素差异,像素金图需携带固定字体;
- 文件对话框、剪贴板、真实 IME 候选窗和屏幕阅读器最终播报依赖用户桌面会话;
- 不支持移动端、Web、musl、32 位目标、全局快捷键、系统托盘或打印。
升级前检查两个项目的 CHANGELOG、Release notes、协议主/次版本和目标锁文件;不要只修改 包版本而保留旧原生摘要。言台的支持周期见其 兼容政策,言界的 1.x 修复边界见支持政策。