生态桌面应用

打包与发布

锁定目标原生制品并生成 macOS、Windows 或 Linux 图形应用 Bundle。

锁定依赖

言界 1.0.0 固定言台v1.0.0和言据 1.1.2 的已审核提交。应用清单固定言界标签后, 首次构建或切换目标平台后,在应用根目录运行:

yanbao 装
yanbao 查

提交生成的言序.lock。它记录当前目标、依赖精确提交、包内容摘要,以及所选言台动态库的 ABI、SHA-256 和大小。一个目标的锁文件不能冒充另一个架构的锁文件;升级言界、言台或宿主 后也必须重新生成锁和 YXB,不能只替换动态库。

图形应用清单

[应用]
类型 = "图形"
名称 = "我的言界应用"
标识 = "dev.example.my-ui-app"
版本 = "0.1.0"

[权限]
图形界面 = true
原生扩展 = true
剪贴板 = true
文件对话框 = true

构建当前宿主的正式 Bundle:

yanbao 构 --release --bundle

言包会把 YXB、当前目标的锁定言台动态库、权限元数据、资源、图标、许可和摘要装入 macOS .app、Windows GUI 应用目录或 Linux AppDir。生产 YXB 和 Bundle 使用言序 1.1.20 或更新 的兼容稳定版构建;言序 1.1.9 是源码/API 兼容下限,不是生产降级要求。应用不得复制或硬编码 DLL、dylib 或 so 路径,不使用的剪贴板或文件对话框权限应从清单删除。

六目标发布

每个目标都应在对应原生执行器重新生成锁、检查、测试、构建应用并运行自动退出窗口。上线 候选还应在实际桌面会话验证 IME、DPI、字体、屏幕阅读器、剪贴板、文件对话框和关闭报告。 平台签名、公证或商店上传属于产物验收后的分发步骤。

核对上游来源

言界 1.0 Release 公开六目标归档、独立 SHA-256、包清单和冻结 API。其 Release 工作流不会 重新编译,只复用同一标签提交的成功标签 CI 候选,并核对候选报告中的来源提交和归档摘要。 应用的供应链记录至少应保存:

  • 言界与言台标签、精确提交和 Release 链接;
  • 下载附件的 SHA-256,以及应用各目标锁中的包/原生制品摘要;
  • 构建使用的言序、言包、系统和架构;
  • 应用测试、真实桌面冒烟、签名/公证和回滚结果。

若需要回滚,恢复同一目标一起保存的旧清单和锁,再重新构建 Bundle;不要把旧 YXB 与新 动态库或新锁混装。言界自身的候选来源门禁见 生产验收。