e2ea309ee6
完整实现 Tauri + Vanilla JS 轻量级截图工具 Phase 1 - 项目搭建 - Tauri 2.x 项目初始化 - Vite 前端项目搭建 - 基础 UI 框架（CSS 变量、组件库） - 构建配置优化 Phase 2 - 核心截图功能 - 全屏/区域/窗口截图 - 截图预览和管理 - 文件命名和缩略图 - 全局快捷键集成 Phase 3 - 上传与存储 - 多图床上传（GitHub/Imgur/自定义） - 配置管理系统 - SQLite 数据库 Phase 4 - OCR 集成 - 云端 OCR（百度/腾讯云） - 插件管理系统 - 本地 OCR 插件（Go） - OCR 结果处理 Phase 5 - AI 分类系统 - Claude/OpenAI API 集成 - Prompt 模板引擎 - 模板管理界面 - 自动分类流程 Phase 6 - 历史记录与管理 - 图库视图（网格/列表） - 搜索与筛选 - 批量操作 - 导出功能（JSON/CSV/ZIP） Phase 7 - 打包与发布 - 多平台构建配置 - CI/CD 工作流 - 图标和资源 - 安装包配置 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
打包与发布指南
本文档介绍如何构建和发布 CutThenThink Lite 应用程序。
系统要求
通用要求
- Node.js 18+
- npm 或 yarn
- Rust 1.70+ (用于 Tauri)
Linux
sudo apt-get update
sudo apt-get install -y \
libgtk-3-dev \
libwebkit2gtk-4.0-dev \
libappindicator3-dev \
librsvg2-dev \
patchelf
macOS
- Xcode 命令行工具
- macOS 10.13+
Windows
- Microsoft C++ Build Tools
- WebView2 Runtime (通常已预装)
快速开始
1. 安装依赖
npm install
2. 构建应用
npm run build
npm run tauri:build
3. 开发模式
npm run tauri:dev
使用脚本
完整构建
./scripts/build.sh
开发构建
./scripts/dev.sh
仅打包前端
./scripts/package-frontend.sh
构建输出
构建完成后，打包文件位于：
- Linux:
src-tauri/target/release/bundle/ - macOS:
src-tauri/target/release/bundle/dmg/ - Windows:
src-tauri/target/release/bundle/nsis/
Linux 打包格式
.AppImage- 通用 Linux 应用格式.deb- Debian/Ubuntu 包.tar.gz- 源代码压缩包
macOS 打包格式
.dmg- 磁盘映像.app- 应用程序包
Windows 打包格式
.exe- NSIS 安装程序.msi- MSI 安装程序
CI/CD
项目使用 GitHub Actions 进行自动化构建：
.github/workflows/build.yml- 发布构建.github/workflows/test.yml- 测试构建
触发构建：
git tag v0.1.0
git push origin v0.1.0
数字签名
Windows
需要代码签名证书来避免 Windows SmartScreen 警告。
macOS
需要 Apple Developer 账户来签名应用。
发布检查清单
- 更新版本号 (package.json, tauri.conf.json)
- 更新 CHANGELOG.md
- 创建 Git 标签
- 推送标签到远程仓库
- 等待 CI/CD 构建
- 下载并测试构建产物
- 创建 GitHub Release
- 上传构建产物到 Release
- 更新应用商店（如适用）
故障排除
构建失败
- 清理缓存：
npm run clean
cargo clean
- 重新安装依赖：
rm -rf node_modules
npm install
- 检查 Rust 版本：
rustc --version
Linux 依赖问题
如果遇到 GTK 或 WebKit 相关错误，请确保安装了所有依赖：
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev
图标未显示
确保图标文件位于 src-tauri/icons/ 目录：
- 32x32.png
- 128x128.png
- 128x128@2x.png
- icon.icns (macOS)
- icon.ico (Windows)
许可证
MIT License - 详见 LICENSE 文件