# batch-builder

**Repository Path**: cosmolau/batch-builder

## Basic Information

- **Project Name**: batch-builder
- **Description**: Cocos Creator Batch Build Extension Plugin | Cocos Creator 批量构建扩展插件
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 批量构建工具

## 应用场景

在一个 Cocos Creator 项目中，如果每个场景为一个独立游戏，每个游戏有其独立的 Bundle，单独构建每一个场景时，每次都需要手动修改构建信息，包括项目名、项目路径、开始场景、Bundle 等，非常繁琐且有心智负担，容易出错。

使用`批量构建工具`扩展可以自动化为每个场景进行单独的构建。

## 面板

打开面板：`扩展` -> `批量构建工具 🛠️`

### 面板选项

* Cocos 路径：Cocos Creator 执行文件的路径。
* 项目列表：`scene` 文件夹下所有场景文件列表。

## 使用方法

### 前置条件

本扩展插件的使用情景为：

* 每个场景单独构建为一个项目。
* 支持 bundle 包，bundle 的名字需要与场景名相同。

### 步骤

1. 先在构建面板中正常进行一次构建，确保配置能成功构建。
2. 从构建面板中导出构建配置到 `[项目根目录]\build-templates\batch-builder` 目录下（推荐）或者其他位置，需要加入到版本管理中。
3. 打开本扩展插件的面板，将导出的构建配置文件路径填入 `构建配置模版` 中。（如果使用推荐路径，且模板命名为 `buildConfig_template.json`，这一项会自动填入）
4. 选择 `构建方式` 和需要构建的***场景***，点击 `构建` 按钮即可开始批量构建。

### 配置说明

| 配置项       | 说明                                                                 |
| ------------ | -------------------------------------------------------------------- |
| Cocos 路径   | Cocos 引擎的 `.exe` 可执行文件路径                                   |
| 构建配置模板 | 从构建面板导出的配置文件                                             |
| 构建方式     | 单独构建：一个场景构建为一个项目<br>合并构建：所有场景构建为一个项目 |
| 项目列表     | 项目中所有的场景文件                                                 |
| 导出路径     | 构建完成后产物存放的路径                                             |