发布分发
功能
发布时通常分发
bt_app.exe build 生成的
dist/{app.name}.exe。该 exe 尾部包含 Bundle,运行时会从自身读取应用资源。
Windows
Windows 用户直接双击打包后的 exe 运行。若系统缺少 WebView2 Runtime,
bt_app 会在启动错误路径给出友好提示,用户需要安装 Microsoft Edge WebView2 Runtime。
建议发布前确认:
-
app.console 是否为 false。
-
app.icon 是否是有效 .ico。
-
dist/{app.name}.exe 能在干净目录中独立运行。
-
static 模式所需资源都进入 Bundle。
-
server 模式的端口没有和常见软件冲突。
Linux 和 macOS
当前项目的正式打包输出仍以
.exe 单文件逻辑为主,
bt_app.exe export 是预留入口,跨平台导出能力当前版本暂未完成。需要面向 Linux 或 macOS 发布时,应以当前实际构建产物和运行环境验证结果为准,不要把
.icns、
.png 平台图标写成已支持打包能力。
远程应用更新
远程入口模式下,软件壳本身可以保持稳定,业务页面和 BT 脚本可以部署在服务器端。开发者更新服务器内容后,用户再次打开应用即可使用新版本功能,不一定需要重新下载安装客户端。
{
"app": {
"mode": "remote",
"entry": "https://example.com/app"
}
}
远程页面当前可以调用
window.bt.call() 和窗口控制能力。发布时只应配置可信 HTTPS 地址,并注意远程页面的账号、权限和内容安全。
本地打包应用更新
static 和
server 模式的本地资源已经打进 exe。更新页面、BT 脚本、图标或
app.json 后,需要重新执行:
bt_app.exe build
然后把新的
dist/{app.name}.exe 分发给用户。
WebView2 依赖
Windows 桌面窗口依赖 WebView2。开发和发布测试时,如果窗口无法打开、提示 WebView 相关错误,优先检查系统是否安装 WebView2 Runtime。