BT编程语言文档

打包构建

功能

bt_app.exe build 会读取当前目录的桌面项目配置,收集资源,构建 Bundle,并把 Bundle 注入到复制出来的运行器 exe 尾部。

准备目录

典型项目结构: 纯 HTML 项目可以只有:

执行打包

在项目目录运行: 输出位置: 例如 app.nameDiary 时:

资源收集

resources 支持普通文件和 glob: 构建阶段会自动加入必要资源,包括 app.jsonstatic 入口、主脚本、server.bt 和图标。assets/** 会递归打包目录下所有文件。

图标和元信息

配置 app.icon 后,构建会校验图标文件存在,并在 Windows 上写入输出 exe 的图标资源: 当前 app.icon 只支持 .icodescriptioncopyright 会写入 Windows exe 版本资源。

控制台

app.consolefalse 时,构建会把 Windows exe 子系统改成 GUI,双击运行时不弹出控制台。 开发阶段建议使用 console:true,便于查看启动摘要、错误和 echo() 输出。

其他命令

  • run:运行当前目录项目。
  • bundle-check:检查当前 exe 是否包含 Bundle,并打印 Bundle 文件列表。
  • export:当前版本是预留入口,会提示平台导出将在后续接入。

平台说明

当前构建逻辑输出单个 .exe 文件,Windows 下会处理 GUI 子系统、exe 图标和元信息。Linux、macOS 的正式平台导出能力当前版本暂未完成,后续由 export 接入。