feat/flutter-default
main
构建脚本把 Flutter 前端当「可选项」:flutter 缺失只告警、交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果包照出、日志刷过去一行红字,用户拿到的是 Avalonia 回退界面。1.0.7 的 Windows 包就是这么来的。
build_flutter_ui / build_flutter_ui_cross 缺 flutter 或编译失败一律返回非 0,build.sh 立即中断并打印原因(交叉编译失败时附日志尾巴)。真要出降级包,显式写:
build_flutter_ui
build_flutter_ui_cross
build.sh
./build.sh build --allow-no-ui
不再出现「在 Linux 上硬造一个没有前端的 mac 包」这种情况 —— macOS 包只在 macOS 上出。
之前仓库没有 linux/ runner,也没有 linux 包。这次:
linux/
flutter create --platforms=linux
BINARY_NAME=GC-UI
APPLICATION_ID=com.xhmcl.GC
Morris GC
GC-UI
lib/libflutter_linux_gtk.so
data/
dist/linux-amd64/
pack_launcher
GC-<版本>-linux-amd64.zip
踩到一个坑:linux/CMakeLists.txt 原本只在 CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT 时把前缀改成 bundle 目录,本机环境里它被初始化成 /usr/local,于是 flutter 报「构建成功」、build/.../bundle 是空的,产物全装进了 /usr/local。改成无条件 FORCE。
linux/CMakeLists.txt
CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT
/usr/local
build/.../bundle
settings.json
updateRepository
gitcode.com/Morris_1/GC
./build.sh build → win-amd64 109 MB / win-arm64 105 MB / linux-amd64 65 MB,三份都含 Flutter 前端 → version.json 签名 Verified(gc-2026-12)
Linux 包在 Xvfb + llvmpipe 下实跑:/api/health 返回 {"ok":true,"platform":"linux-x64"},GC-UI 进程起来,窗口正常渲染出模型库首页(截图附在 PR 描述外,可本地复现)。
Xvfb + llvmpipe
/api/health
{"ok":true,"platform":"linux-x64"}
Linux 主机额外需要:
sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-14-dev
libstdc++-14-dev 容易漏 —— clang 18 去 /usr/lib/gcc/x86_64-linux-gnu/14/ 找 -lstdc++,只装 gcc-13 的开发包会报 cannot find -lstdc++。已写进 GC-UI/CI.md。
libstdc++-14-dev
/usr/lib/gcc/x86_64-linux-gnu/14/
-lstdc++
cannot find -lstdc++
GC-UI/CI.md
在 Linux 上跑 ./build.sh build 不再产出 mac 包(除非 --allow-no-ui)。这是有意的:宁可少一个平台,也不发一个没有前端的包。要 mac 包请在 mac 上编。
./build.sh build
--allow-no-ui
此前 build.sh 在非 Windows 宿主上把前端当「可选项」:flutter 缺失只告警、 交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果是包照出,用户拿到 的是 Avalonia 回退界面,而构建日志里一行红字很容易被忽略。 改为默认必需: - build_flutter_ui / build_flutter_ui_cross 缺 flutter 或编译失败一律返回非 0, build.sh 立即中断并给出原因(交叉编译失败时带日志尾巴) - 确实要出降级包时显式声明 ./build.sh build --allow-no-ui 目标平台按构建主机决定,每条产物都带 Flutter: macOS 主机 → mac-arm64(Xcode 原生)+ win-amd64/win-arm64(mingw 交叉) Linux 主机 → linux-amd64(原生)+ win-amd64/win-arm64(mingw 交叉) Windows 主机 → win-amd64/win-arm64(原生) Linux 目标此前根本不存在,这次一并补上: - GC-UI/frontend/linux/ 由 flutter create 生成,BINARY_NAME=GC-UI、 APPLICATION_ID=com.xhmcl.GC、窗口标题 "Morris GC" - build_flutter_ui 增加 linux 分支,bundle(GC-UI + lib/ + data/)铺进 dist/linux-amd64/,pack_launcher 增加 Linux 整目录打包 - linux/CMakeLists.txt 强制 CMAKE_INSTALL_PREFIX 指向 build/.../bundle: 某些环境下它会被初始化成 /usr/local,导致 flutter 报「构建成功」但 bundle 是空的、产物装进了系统目录(本机实测踩到) 顺带修正两处: - 生成 settings.json 的默认 updateRepository 还是 gitcode 地址,与只保留 xhmcl 源的现状不符 - 进度条权重改为按实际目标动态计算,新平台不会再把总进度算过 100% 验证(Linux 主机,flutter 3.24.5): - ./build.sh build 出 win-amd64 109 MB、win-arm64 105 MB、linux-amd64 65 MB, 三份均含 Flutter 前端,清单签名 Verified - Linux 包在 Xvfb + llvmpipe 下实跑:后端 /api/health 返回 ok,GC-UI 窗口 正常渲染出模型库首页 - macOS 目标在 Linux 上不再产出 Avalonia 空壳包(要它得回 macOS 编)
No dependencies set.
The note is not visible to the blocked user.
问题
构建脚本把 Flutter 前端当「可选项」:flutter 缺失只告警、交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果包照出、日志刷过去一行红字,用户拿到的是 Avalonia 回退界面。1.0.7 的 Windows 包就是这么来的。
改动
1. 前端变成必需项
build_flutter_ui/build_flutter_ui_cross缺 flutter 或编译失败一律返回非 0,build.sh立即中断并打印原因(交叉编译失败时附日志尾巴)。真要出降级包,显式写:2. 目标平台按主机决定
不再出现「在 Linux 上硬造一个没有前端的 mac 包」这种情况 —— macOS 包只在 macOS 上出。
3. 补 Linux 目标
之前仓库没有
linux/runner,也没有 linux 包。这次:flutter create --platforms=linux生成 runner,BINARY_NAME=GC-UI、APPLICATION_ID=com.xhmcl.GC、窗口标题Morris GCbuild_flutter_ui增加 linux 分支,把 bundle(GC-UI+lib/libflutter_linux_gtk.so+data/)铺进dist/linux-amd64/pack_launcher增加 Linux 整目录打包,产物GC-<版本>-linux-amd64.zip踩到一个坑:
linux/CMakeLists.txt原本只在CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT时把前缀改成 bundle 目录,本机环境里它被初始化成/usr/local,于是 flutter 报「构建成功」、build/.../bundle是空的,产物全装进了/usr/local。改成无条件 FORCE。4. 顺手修的
settings.json的默认updateRepository还是gitcode.com/Morris_1/GC,与「只保留 xhmcl 源」不符验证(Linux 主机,Flutter 3.24.5)
Linux 包在
Xvfb + llvmpipe下实跑:/api/health返回{"ok":true,"platform":"linux-x64"},GC-UI进程起来,窗口正常渲染出模型库首页(截图附在 PR 描述外,可本地复现)。依赖
Linux 主机额外需要:
libstdc++-14-dev容易漏 —— clang 18 去/usr/lib/gcc/x86_64-linux-gnu/14/找-lstdc++,只装 gcc-13 的开发包会报cannot find -lstdc++。已写进GC-UI/CI.md。影响
在 Linux 上跑
./build.sh build不再产出 mac 包(除非--allow-no-ui)。这是有意的:宁可少一个平台,也不发一个没有前端的包。要 mac 包请在 mac 上编。