build: 默认编 Flutter 前端,补 Linux 目标并按主机选择产物 #9

Merged
Morris merged 1 commits from feat/flutter-default into main 2026-11-18 19:23:17 +08:00
Owner

问题

构建脚本把 Flutter 前端当「可选项」:flutter 缺失只告警、交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果包照出、日志刷过去一行红字,用户拿到的是 Avalonia 回退界面。1.0.7 的 Windows 包就是这么来的。

改动

1. 前端变成必需项

build_flutter_ui / build_flutter_ui_cross 缺 flutter 或编译失败一律返回非 0,build.sh 立即中断并打印原因(交叉编译失败时附日志尾巴)。真要出降级包,显式写:

./build.sh build --allow-no-ui

2. 目标平台按主机决定

构建主机 产物 前端来源
macOS mac-arm64 + win-amd64 + win-arm64 Xcode 原生 / mingw 交叉
Linux linux-amd64 + win-amd64 + win-arm64 原生 / mingw 交叉
Windows win-amd64 + win-arm64 原生

不再出现「在 Linux 上硬造一个没有前端的 mac 包」这种情况 —— macOS 包只在 macOS 上出。

3. 补 Linux 目标

之前仓库没有 linux/ runner,也没有 linux 包。这次:

  • flutter create --platforms=linux 生成 runner,BINARY_NAME=GC-UI、APPLICATION_ID=com.xhmcl.GC、窗口标题 Morris GC
  • build_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 源」不符
  • 进度条权重按实际目标动态算,新增平台不会把总进度算过 100%

验证(Linux 主机,Flutter 3.24.5)

./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 描述外,可本地复现)。

依赖

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。

影响

在 Linux 上跑 ./build.sh build 不再产出 mac 包(除非 --allow-no-ui)。这是有意的:宁可少一个平台,也不发一个没有前端的包。要 mac 包请在 mac 上编。

## 问题 构建脚本把 Flutter 前端当「可选项」:flutter 缺失只告警、交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果包照出、日志刷过去一行红字,用户拿到的是 Avalonia 回退界面。1.0.7 的 Windows 包就是这么来的。 ## 改动 ### 1. 前端变成必需项 `build_flutter_ui` / `build_flutter_ui_cross` 缺 flutter 或编译失败一律返回非 0,`build.sh` 立即中断并打印原因(交叉编译失败时附日志尾巴)。真要出降级包,显式写: ```bash ./build.sh build --allow-no-ui ``` ### 2. 目标平台按主机决定 | 构建主机 | 产物 | 前端来源 | |---|---|---| | macOS | mac-arm64 + win-amd64 + win-arm64 | Xcode 原生 / mingw 交叉 | | Linux | linux-amd64 + win-amd64 + win-arm64 | 原生 / mingw 交叉 | | Windows | win-amd64 + win-arm64 | 原生 | 不再出现「在 Linux 上硬造一个没有前端的 mac 包」这种情况 —— macOS 包只在 macOS 上出。 ### 3. 补 Linux 目标 之前仓库没有 `linux/` runner,也没有 linux 包。这次: - `flutter create --platforms=linux` 生成 runner,`BINARY_NAME=GC-UI`、`APPLICATION_ID=com.xhmcl.GC`、窗口标题 `Morris GC` - `build_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 源」不符 - 进度条权重按实际目标动态算,新增平台不会把总进度算过 100% ## 验证(Linux 主机,Flutter 3.24.5) ``` ./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 描述外,可本地复现)。 ## 依赖 Linux 主机额外需要: ```bash 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`。 ## 影响 在 Linux 上跑 `./build.sh build` 不再产出 mac 包(除非 `--allow-no-ui`)。这是有意的:宁可少一个平台,也不发一个没有前端的包。要 mac 包请在 mac 上编。
Morris added 1 commit 2026-11-18 19:15:16 +08:00
build: 默认编 Flutter 前端,补 Linux 目标并按主机选择产物
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
d7f6d8de9f
此前 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 编)
Morris merged commit 461e79aa7f into main 2026-11-18 19:23:17 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#9