# ocr-mac-builder

**Repository Path**: xiangchengkang/ocr-mac-builder

## Basic Information

- **Project Name**: ocr-mac-builder
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 OCR Mac 可视化打包工具

一个简单、美观的网页版打包工具，用于打包 OCR Mac 应用程序。

## ✨ 特性

- 🎨 **现代化界面** - 漂亮的渐变色设计，操作简单直观
- 📦 **多平台支持** - 支持 macOS、Windows、Linux 平台
- 📊 **实时日志** - 打包过程实时反馈，清晰了解每一步
- 🔄 **版本管理** - 自动更新项目版本号
- ⚡ **快速便捷** - 一键式操作，无需记忆复杂命令

## 🚀 快速开始

### 方法 1: 使用启动脚本（推荐）

**macOS / Linux:**

```bash
cd /Users/xiangchengkang/projects/ocr-mac-builder
chmod +x start.sh
./start.sh
```

**Windows:**

```bash
cd C:\projects\ocr-mac-builder
start.bat
```

脚本会自动安装依赖并启动服务。首次运行前，请编辑 `start.sh` 或 `start.bat` 文件，修改其中的项目路径。

### 方法 2: 手动启动

#### 1. 安装依赖

```bash
cd /Users/xiangchengkang/projects/ocr-mac-builder
npm install
```

#### 2. 启动服务

**方式一：手动输入项目路径**

```bash
npm start
```

服务启动后会自动打开浏览器，然后在输入框中填写项目路径。

**方式二：自动填充项目路径（推荐）**

```bash
npm start -- --project /Users/xiangchengkang/projects/ocr-mac
```

这样启动后会自动填充项目路径，并加载当前版本号。

## 📖 使用步骤

1. **输入项目路径** - 在输入框中填写 OCR Mac 项目的完整路径
   - 例如: `/Users/xiangchengkang/projects/ocr-mac`
   - 如果使用 `--project` 参数启动，会自动填充

2. **设置版本号** - 输入新版本号或点击"获取当前版本"
   - 格式: `x.y.z` (例如: `0.2.0`)

3. **选择平台** - 勾选需要打包的目标平台
   - macOS、Windows、Linux

4. **选择构建模式**
   - Release: 生产版本（推荐）
   - Debug: 调试版本

5. **开始打包** - 点击"开始打包"按钮

6. **查看结果** - 实时查看打包日志和最终输出文件位置

## 📁 项目结构

```
ocr-mac-builder/
├── index.html      # 前端界面
├── app.js          # 前端逻辑
├── server.js       # 后端服务
├── package.json    # 项目配置
└── README.md       # 说明文档
```

## 🛠️ 工作原理

1. **版本更新** - 自动更新 `package.json`、`tauri.conf.json`、`Cargo.toml` 中的版本号
2. **依赖检查** - 检查并安装项目依赖
3. **前端构建** - 执行 `npm run build` 构建前端资源
4. **应用打包** - 执行 `npm run tauri build` 打包应用
5. **结果展示** - 显示打包日志和输出文件位置

## 📝 注意事项

- 确保 OCR Mac 项目已经正确配置
- 跨平台打包需要对应的操作系统环境
- 首次打包可能需要较长时间下载依赖
- 打包过程中请勿关闭浏览器或终止服务

## 🎯 系统要求

- Node.js >= 16.0.0
- npm >= 8.0.0
- 对应平台的开发环境（Xcode for macOS, Visual Studio for Windows, etc.）

## 💡 提示

- 打包产物位置：
  - macOS: `src-tauri/target/release/bundle/dmg/` 或 `macos/`
  - Windows: `src-tauri/target/release/bundle/msi/` 或 `nsis/`
  - Linux: `src-tauri/target/release/bundle/deb/` 或 `appimage/`

## 🐛 故障排除

### 无法连接到服务器
- 确保服务已启动 (`npm start`)
- 检查端口 3001 是否被占用

### 打包失败
- 检查项目路径是否正确
- 确保项目依赖已安装
- 查看日志输出中的错误信息

### 版本号格式错误
- 版本号必须符合 `x.y.z` 格式
- 例如: `0.1.0`、`1.2.3`

## 📄 许可证

MIT License

---

Made with ❤️ for OCR Mac