ci: 构建链补完 wails v2→v3 迁移,CI 触发收敛到 main

代码早就全量迁到 v3(go.mod 只要 wails/v3、main.go import v3/pkg/application),
但"怎么构建"这一层从没跟上,全还是 v2:

- release.yml 装 v2 CLI(wails@v2.12.0)去编 v3 代码,编不过;产物路径也还
  指向 v2 的 build/bin/,而 v3 落在 bin/。这条只在打 v* tag 时触发,迁移后
  一次都没跑过,所以坏了半个月没人知道 —— 下次发版必炸。
- Makefile 的 wails dev/build 直接 command not found。
- README 叫人装 v2 CLI;RELEASE.md 还在提早已删除的 wails.json。

改动:
- ci.yml 触发从 [main, dev] 收到 [main]。dev 分支已删,开发在 feat/wails3,
  留着 dev 是死条件;PR 以 main 为目标仍会跑,合入前有关卡。
- release.yml 全量转 v3:
  * CLI 钉死 v3.0.0-alpha2.117,与 go.mod 的 wails/v3 版本一致 —— alpha 阶段
    CLI 生成的 bindings 和运行时配套,版本错开会出难查的怪问题。
  * mac 走 wails3 task darwin:package:universal。v3 的 build 只出裸二进制
    (macOS 上双击不起窗),必须 package 才有 .app;本地实跑验证过,
    lipo -archs 确认是真 universal(x86_64 + arm64)。
  * Windows 保持 v2 时代行为发裸 .exe。v3 的 package 默认走 NSIS 出 installer,
    依赖 runner 上有 makensis,属额外未知数,要升级安装包再单独议。
  * 产物路径 build/bin/ → bin/。
  * fail_on_unmatched_files 改 true,并按 matrix 只匹配自己那个产物 ——
    原来是 false 且两个平台都列全量文件,产物路径写错会安静发一个没附件的
    Release。这次的 bug 正是路径漂移,得让它当场炸。
- RELEASE.md 版本号对齐表补上第三处 build/config.yml 的 info.version(此前写着
  "必须三处对齐"却只列了两处,第三处是已删的 wails.json),并记下改完必须跑
  wails3 task common:update:build-assets 重新生成 Info.plist —— 这坑踩过。
- 清掉 v2 残留:frontend/wailsjs/(v2 绑定,v3 用已跟踪的 bindings/)及其
  gitignore 规则、build/bin/ 里 v2 时代的 .app。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Blizzard
2026-07-16 15:03:32 +08:00
parent 759483bf92
commit a5cf2c5f36
6 changed files with 47 additions and 24 deletions
+5 -2
View File
@@ -1,7 +1,7 @@
# 发版清单(桌面端 Release)
`vX.Y.Z` 标签即触发 [`.github/workflows/release.yml`](.github/workflows/release.yml)
GitHub 用 macOS/Windows runner `wails build`安装包并发布到 **Releases**
GitHub 用 macOS/Windows runner `wails3` 出包并发布到 **Releases**mac 出 universal `.app` 的 zip、Windows 出 `.exe`
旧版用户的 App 启动时查 `releases/latest`,发现新版即弹横幅提示下载
(逻辑见 [`version.ts`](sundynix-desktop/frontend/src/lib/version.ts))。
@@ -15,8 +15,11 @@ GitHub 用 macOS/Windows runner `wails build` 出安装包并发布到 **Release
|---|---|---|
| `sundynix-desktop/frontend/src/lib/version.ts` | `APP_VERSION` | **功能性**App 拿它和 GitHub 最新版比,决定是否提示更新 |
| `sundynix-desktop/frontend/package.json` | `version` | 前端包版本(保持一致,便于追溯) |
| `sundynix-desktop/build/config.yml` | `info.version` | 原生包元数据版本(macOS `Info.plist``CFBundleShortVersionString` 由它生成) |
> `wails.json` 当前无版本字段;要在原生包元数据里带版本,可自行加 `info.productVersion`。)
> ⚠️ 改完 `build/config.yml` 必须跑 `wails3 task common:update:build-assets` 重新生成
> `build/darwin/Info.plist` 等资产,**光改 config.yml 不生效**——生成物是提交进仓库的。
> (这坑踩过:config.yml 填好了但没重新生成,`.app` 里还是脚手架模板值,直接起不来。)
⚠️ **`APP_VERSION` 必须等于即将打的 tag(去掉 v)**,否则更新提示会错乱:
新包内嵌的 APP_VERSION = 新版本;旧用户 App 内是旧版本,比对才会提示。