# quick-build

**Repository Path**: YSisrich/quick-build

## Basic Information

- **Project Name**: quick-build
- **Description**: 本地快速构建项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-29
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快速构建工具

一个基于 uTools 的本地快速构建工具插件，用于快速执行项目构建任务。

## 主要功能

- 任务卡片管理：以卡片形式展示多个打包任务
- 新增/编辑任务：通过表单创建和管理任务
- 项目路径选择：支持文件夹选择器
- 包管理器选择：支持 npm、yarn、pnpm
- 环境配置：测试环境、正式环境、自定义环境
- 构建状态显示：就绪、构建中、成功、失败、已取消
- 构建和取消：支持单个任务构建和取消
- 任务持久化：所有任务自动保存

## 项目结构

```
quick-build/
├── page_app/              # Vue 应用
│   ├── src/              # 源代码
│   └── package.json      # 依赖配置
└── utools/               # uTools 插件
    ├── dist/             # 构建输出
    ├── plugin.json       # 插件配置
    └── preload/quickbuild.js  # Preload 脚本
```

### 安装依赖

```bash
cd page_app
npm install
# 或者使用 yarn
yarn install
```

### 开发模式

```bash
cd page_app
npm run dev
# 或
yarn dev
```

**注意**: 开发模式下使用 Mock Services，实际功能（文件选择、命令执行）需要在 uTools 环境中使用。开发模式主要用于界面调试。

### 构建项目

```bash
cd page_app
npm run build
# 或
yarn build
```

构建后的文件会输出到 `utools/dist` 目录。

### 安装到 uTools

1. 构建项目
2. 打开 uTools 开发者工具
3. 添加开发插件
4. 选择 `utools` 目录

## 使用方法

1. 在 uTools 中输入 `build` 或 `快速构建`
2. 点击"新增任务"按钮创建打包任务
3. 填写任务信息（名称、路径、包管理器、环境）
4. 在任务卡片上点击"开始构建"
5. 可随时编辑、删除或取消构建任务

## 技术栈

- Vue 3 + Vite
- uTools 插件
- Electron Dialog API
- Node.js child_process

## 常见问题

**Q: 构建失败？**
- 确保项目路径正确
- 确认项目已运行 `npm install`
- 检查 package.json 中是否有对应的构建命令
- 查看日志中的错误信息

**Q: 选择路径没反应？**
- 确保在 uTools 中使用（不是浏览器）
- 检查插件是否正确构建和安装
- 按 F12 查看控制台错误

## 注意事项

- Windows 系统使用 CMD 执行命令
- Linux/macOS 使用 Bash 执行命令
- 构建命令需要在项目的 package.json 中定义
- 所有配置自动保存到 uTools 数据库