生态桌面应用

版本兼容政策

言界 1.0、言台 1.0、工具链、协议和言窗之间的稳定兼容边界。

言窗 1.0 稳定线

组件兼容范围已验证版本
言序>=1.1.121.1.12
言包格式 2 清单与锁、GUI Bundle0.5.x
言窗^1.0、ABI v21.0.0
平台Linux GNU、macOS、Windowsx86-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 v21.0.0
言界^1.01.0.0
言据^1.11.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 修复边界见支持政策。