打包构建
功能
bt_app.exe build 会读取当前目录的桌面项目配置,收集资源,构建 Bundle,并把 Bundle 注入到复制出来的运行器 exe 尾部。
准备目录
典型项目结构:
my-app/
app.json
index.html
main.bt
assets/
app.css
app.js
纯 HTML 项目可以只有:
my-html-app/
index.html
style.css
main.js
执行打包
在项目目录运行:
bt_app.exe build
输出位置:
dist/{app.name}.exe
例如
app.name 为
Diary 时:
dist/Diary.exe
资源收集
resources 支持普通文件和 glob:
{
"resources": [
"index.html",
"main.bt",
"assets/**",
"pages/*.html"
]
}
构建阶段会自动加入必要资源,包括
app.json、
static 入口、主脚本、
server.bt 和图标。
assets/** 会递归打包目录下所有文件。
图标和元信息
配置
app.icon 后,构建会校验图标文件存在,并在 Windows 上写入输出 exe 的图标资源:
{
"app": {
"name": "IconDemo",
"icon": "logo.ico",
"description": "图标示例",
"copyright": "Copyright 2026 BT"
}
}
当前
app.icon 只支持
.ico。
description 和
copyright 会写入 Windows exe 版本资源。
控制台
app.console 为
false 时,构建会把 Windows exe 子系统改成 GUI,双击运行时不弹出控制台。
{
"app": {
"console": false
}
}
开发阶段建议使用
console:true,便于查看启动摘要、错误和
echo() 输出。
其他命令
bt_app.exe run
bt_app.exe bundle-check
bt_app.exe export
-
run:运行当前目录项目。
-
bundle-check:检查当前 exe 是否包含 Bundle,并打印 Bundle 文件列表。
-
export:当前版本是预留入口,会提示平台导出将在后续接入。
平台说明
当前构建逻辑输出单个
.exe 文件,Windows 下会处理 GUI 子系统、exe 图标和元信息。Linux、macOS 的正式平台导出能力当前版本暂未完成,后续由
export 接入。