使用者在 Linux build 看到:
pkg-config --cflags ... webkit2gtk-4.0
Package 'webkit2gtk-4.0' not found
根因:Wails v2.11 預設 cgo pkg-config 指定 webkit2gtk-4.0,但 Ubuntu
22.10 之後的版本已經把系統 package 從 webkit2gtk-4.0 改名為 4.1
(API 大致相容)。使用者 bootstrap 裝的是 libwebkit2gtk-4.1-dev,
pkg-config 找不到 4.0.pc 就 fail。
修法:
1. Makefile wails-linux target 自動偵測 webkit2gtk 版本
- 優先 pkg-config --exists webkit2gtk-4.1 → wails build -tags webkit2_41
(Wails v2.10+ 支援的 build tag,切換到 4.1 的 cgo 宣告)
- 退回 pkg-config --exists webkit2gtk-4.0 → wails build 預設
- 兩者都沒有 → 清楚錯誤訊息 + 建議安裝指令
2. scripts/bootstrap-linux.sh 裝 webkit2gtk dev package 時也做版本偵測
- apt-cache show 優先查 4.1,退回 4.0
- Ubuntu 22.04 及之前 repo 有 4.0;22.10+ / 24.04 repo 只有 4.1
- 兩個都試過才 err
驗證:
- make -n wails-linux dry-run 正常 parse
- bash -n scripts/bootstrap-linux.sh 語法 OK
- macOS 端 make dmg 仍 work(未改 darwin target)
使用者待做:Linux 端 git pull 拉新版 → 重跑 bootstrap-linux.sh
(確保 webkit2gtk-4.1-dev 安裝)→ make appimage。
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
visionA
Innovedus visionA monorepo. Currently contains:
Subprojects
local-tool/
visionA-local — local-first edge AI desktop tool, derived from edge-ai-platform. Wails + Go + Next.js, packaged as macOS dmg / Windows exe / Linux AppImage.
See local-tool/README.md for details.
License
TBD (internal use)
Description
Languages
Go
42.4%
TypeScript
33.7%
JavaScript
7.5%
Python
5.3%
Makefile
3.7%
Other
7.4%