Skip to content

Latest commit

 

History

History
71 lines (50 loc) · 2.54 KB

File metadata and controls

71 lines (50 loc) · 2.54 KB

🚀 AutoClip Desktop 构建指南

桌面客户端只有一条打包路线:python-build-standalone(PBS)。它把便携 Python 运行时、 后端源码、静态 ffmpeg/ffprobe 全部打进 .app,用户机器无需预装 Python 或 ffmpeg

历史上的 PyInstaller / prepare_resources 路线(以及对应的 6+ 个 CI 工作流)从未成功产出可用包,已全部移除。

本地构建(macOS Apple Silicon)

./scripts/build_macos_arm.sh

产物:

src-tauri/target/release/bundle/macos/
├── AutoClip Desktop.app                    # 应用包(~550M)
└── AutoClip Desktop_1.0.0_aarch64.dmg      # DMG 安装包(~260M)

脚本各步骤说明见 scripts/README.md

前置依赖

工具 版本 说明
Node.js 18+ 前端构建
Rust stable aarch64-apple-darwin target
cargo-tauri 2.x cargo install tauri-cli

系统 不需要 预装 Python / ffmpeg —— 脚本自带便携版(首次构建会下载并缓存到 build/)。

CI / 发布(GitHub Actions)

.github/workflows/desktop-build.yml 跑同一个 build_macos_arm.sh

# 手动触发:仓库页面 → Actions → "Desktop Build (macOS arm64)" → Run workflow

# 或打 tag 触发,并自动把 DMG 挂到 GitHub Release:
git tag v1.0.0
git push origin v1.0.0

安装与首次运行

DMG 是 ad-hoc 签名(未做 Apple 公证),所以:

  1. 双击 DMG,把 AutoClip Desktop 拖到 Applications
  2. 首次打开右键点应用 → 选「打开」 以绕过 Gatekeeper
  3. 后端会自动启动并在 ~/Library/Application Support/AutoClip 建数据目录

故障排除

命令行直接跑 app 看后端输出:

'/Applications/AutoClip Desktop.app/Contents/MacOS/autoclip-desktop'

应看到 Backend started on port: XXXXXApplication startup complete

现象 排查
ModuleNotFoundError: No module named 'X' X 加进 requirements.txt 重新构建(构建期的依赖检查应该已经拦下,正常不会发生)
窗口黑屏 前端没挂载,看 WebView 控制台;通常是打包/资源问题
视频处理失败 确认 Contents/Resources/resources/ffmpeg/{ffmpeg,ffprobe} 存在且可执行
构建失败想重来 rm -rf src-tauri/target build/pbs-cache build/ffmpeg-cache 后重跑(会重新下载)

已知限制

  • 仅 Apple Silicon (arm64),暂无 Intel / Windows / Linux 包
  • ad-hoc 签名、未公证,首次需右键打开