visionA/local-tool/scripts/bootstrap-linux.sh
jim800121chen 485a2e01ff fix(local-tool): bootstrap-linux.sh 自動安裝 appimagetool
使用者在 Linux build 時遇到「appimagetool 未安裝」錯誤(wails binary
已產出 9.3M,但打包 AppImage 失敗)。原本 bootstrap-linux.sh 只裝 Go /
Node / Wails CLI,沒裝 appimagetool,build-appimage.sh 到打包步驟才
fail。

修法:

1. bootstrap-linux.sh 新增 [5/6] 步驟自動下載 + 安裝 appimagetool
   - 從 AppImage/appimagetool 官方 continuous release 拉
     appimagetool-x86_64.AppImage
   - chmod +x + sudo mv 到 /usr/local/bin/appimagetool
   - 已安裝則跳過

2. build-appimage.sh 的 appimagetool not found 錯誤訊息更新
   - 提供一鍵安裝 curl 指令(不需重跑整個 bootstrap)
   - 提示可重跑 bootstrap-linux.sh 一併補所有依賴
   - 舊訊息裡的 URL 指向已 archived 的 AppImageKit repo,換成
     AppImage/appimagetool(新 repo 位置)

使用者立即可用(不想重跑 bootstrap):
  curl -fsSL https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage \\
    -o /tmp/appimagetool && chmod +x /tmp/appimagetool && sudo mv /tmp/appimagetool /usr/local/bin/appimagetool
  make appimage

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 08:11:49 +08:00

97 lines
3.7 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env bash
# visionA-local — Ubuntu 22.04/24.04 x86_64 一鍵 build
#
# 使用方式:
# git clone https://github.com/jim800121/visionA.git
# cd visionA/local-tool
# bash scripts/bootstrap-linux.sh
#
# 環境變數:
# VISIONA_TARGET 預設 appimage可設 wails-linux / payload-linux
set -euo pipefail
TARGET="${VISIONA_TARGET:-appimage}"
GO_VERSION="1.22.5"
log() { printf '\033[1;36m==> %s\033[0m\n' "$*"; }
err() { printf '\033[1;31m!!! %s\033[0m\n' "$*" >&2; exit 1; }
[[ "$(uname -s)" == "Linux" ]] || err "此腳本只支援 Linux"
[[ "$(uname -m)" == "x86_64" ]] || err "此腳本只支援 x86_64"
[[ -f Makefile && -d visiona-local ]] || err "請先 cd 到 local-tool/ 目錄再執行此腳本"
log "[1/5] 安裝系統套件(需要 sudo"
sudo apt update
sudo apt install -y \
git curl ca-certificates build-essential pkg-config \
libgtk-3-dev \
python3 python3-pip python3-venv \
file desktop-file-utils fuse libfuse2
# webkit2gtk優先 4.1Ubuntu 22.10+ / Debian 12+),退回 4.0Ubuntu 20.04 / 22.04)。
# Makefile wails-linux target 會偵測已安裝的版本並自動加 -tags webkit2_41。
if apt-cache show libwebkit2gtk-4.1-dev >/dev/null 2>&1; then
log " → 偵測到 libwebkit2gtk-4.1-dev 可用,安裝中"
sudo apt install -y libwebkit2gtk-4.1-dev
elif apt-cache show libwebkit2gtk-4.0-dev >/dev/null 2>&1; then
log " → 偵測到 libwebkit2gtk-4.0-dev 可用,安裝中"
sudo apt install -y libwebkit2gtk-4.0-dev
else
err "找不到 libwebkit2gtk-4.1-dev 或 libwebkit2gtk-4.0-dev。請手動安裝對應的 webkit2gtk dev packageUbuntu: sudo apt install libwebkit2gtk-4.1-dev"
fi
log "[2/5] 安裝 Go $GO_VERSION"
if ! command -v go >/dev/null || [[ "$(go version 2>/dev/null)" != *"go$GO_VERSION"* ]]; then
curl -fsSL "https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz" -o /tmp/go.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf /tmp/go.tar.gz
rm /tmp/go.tar.gz
fi
export PATH="/usr/local/go/bin:$HOME/go/bin:$PATH"
if ! grep -q '/usr/local/go/bin' "$HOME/.bashrc" 2>/dev/null; then
echo 'export PATH=/usr/local/go/bin:$HOME/go/bin:$PATH' >> "$HOME/.bashrc"
fi
log "[3/5] 安裝 Node 20 + pnpm"
if ! command -v node >/dev/null || [[ "$(node -v)" != v20.* ]]; then
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
fi
command -v pnpm >/dev/null || sudo npm i -g pnpm
log "[4/6] 安裝 Wails CLI"
if ! command -v wails >/dev/null; then
go install github.com/wailsapp/wails/v2/cmd/wails@latest
fi
wails doctor || log "wails doctor 有警告,繼續"
log "[5/6] 安裝 appimagetool打包 AppImage 用)"
# appimagetool 只在 target=appimage 時才真的需要,但一併裝起來省事。
# 官方 release 就是一個 self-contained AppImage下載後 chmod +x 即可用。
if ! command -v appimagetool >/dev/null; then
APPIMAGETOOL_URL="https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage"
log " → 下載 appimagetool from $APPIMAGETOOL_URL"
curl -fsSL "$APPIMAGETOOL_URL" -o /tmp/appimagetool
chmod +x /tmp/appimagetool
sudo mv /tmp/appimagetool /usr/local/bin/appimagetool
log " → 已安裝到 /usr/local/bin/appimagetool"
else
log " → appimagetool 已安裝,跳過"
fi
log "[6/6] 開始 buildtarget=$TARGET"
log "ffmpeg 使用 LGPL v3 buildv2 TDD §4BtbN n7.1 LGPL"
make vendor-python-linux vendor-wheels-linux vendor-ffmpeg-linux
make payload-linux
case "$TARGET" in
payload-linux) ;;
wails-linux) make wails-linux ;;
appimage|*) make wails-linux && make appimage ;;
esac
log "完成 ✅"
log "產出位置:$(pwd)/dist/"
ls -lh dist/ 2>/dev/null || true