# Cocos Creator 多渠道自动化打包工具 > 底部有作者个人微信 > > 无论是否购买，欢迎加我为好友 ## 注意（介意勿买） * 此项目需要一定的动手能力，并不是即插即用 * 由于作者没有windows设备，此项目只在mac上做了测试，windows上未经过测试 ## 一、前言 ### 1.1 你是否曾经历过这种绝望？发版前夜，对着 10+ 个渠道的打包列表，手动重复着：打开 Creator → 选平台 → 构建 → 等待 → 打开 Xcode/Android Studio → 编译 → 签名 → 上传 → 发通知... 然后从头再来一遍，再来一遍，再来一遍。第三个渠道你就开始怀疑人生，第七个渠道你开始思考为什么要做游戏开发。 ### 1.2 这个工具存在的唯一理由：让你不再做这种狗屎重复劳动。一条命令，所有渠道自动打包、自动上传、自动通知。你该干嘛干嘛去，等着收到结束消息就行了。 ## 二、核心特性 - **渠道共享构建**：相同平台的多渠道共享 Creator 构建产物，避免重复构建 - **Pipeline 架构**：模块化构建流程，易于扩展新渠道 - **一键打包**：支持命令行交互式打包和 CI/CD 集成 - **打包流程**：不同平台组装不同的打包流程 ## 三、支持情况 ### 3.1 支持平台 | 平台类型 | 支持 | 备注 | |---------|---------|------| | **Android** | ✅ | | | **iOS** | ❌ | 需自行实现 fastlane 脚本, 参考文档：https://docs.fastlane.tools/ | | **HarmonyOS Next** | ✅ | | | **微信小游戏** | ✅ | - | | **抖音小游戏** | ✅ | - | | **支付宝小游戏** | ✅ | - | | **华为快游戏** | ✅ | - | | **OPPO快游戏** | ✅ | - | | **VIVO快游戏** | ✅ | - | | **小米快游戏** | ✅ | - | ### 3.2 creator版本 | creator版本 | 支持 | |---------|---------| | **3.8+** | ✅ | | **其他** | 需自行扩展 | ## 四、使用说明 **📖 详细使用说明（见项目中文档）：** - **README.md**-项目基础文档 - **docs/FastUsage.md**-从零开始，10分钟完成第一个渠道打包 - **docs/Framework.md**-项目架构手册 - **docs/AddFeature.md**-添加新平台/渠道/步骤/CDN/通知等手册 ### 4.1 安装依赖进入到项目路径下，执行以下命令 ```bash # 1. 安装依赖 npm install ``` ### 4.2 配置文件配置文件模版在 `template`目录下，复制所有文件到 `config/` 目录各配置文件含义查看 `template`目录下的文件内容根据说明, 添加配置信息 ``` config/ ├── base.json # 基础配置（Creator 路径、项目路径） ├── channels.json # 渠道配置（渠道列表） ├── platforms.json # 平台配置（平台构建路径、证书） ├── certificates.json # 证书配置（Android/鸿蒙签名证书） ├── oss.json # OSS 配置（上传路径） ├── hotupdate.json # 热更新配置（CDN 地址、manifest 路径） └── notification.json # 通知配置 ``` ### 4.3 交互式打包运行后会出现交互式界面，选择渠道、版本号、构建模式等参数。 ```bash # 仅编译Creator项目 npm run buildcc # 完整流程打包 npm run build # 热更新 npm run hotupdate ``` ### 4.4 命令式打包 (适用于 CI/CD) ```bash # 打包 npm run build:jenkins -- \ -p <渠道类型> \ -v <版本号> \ -b \ -d <是否debug: true/false> \ -r <上传通道> \ -m <版本描述> \ -n <是否发送通知: true/false> # 热更新 npm run hotupdate:jenkins -- \ -p <平台类型> \ -v <游戏版本号> \ -r <资源版本号> \ -d <是否debug: true/false> \ -i <是否立即生效: true/false> \ -n <是否发送通知: true/false> ``` ## 五、项目目录结构 ``` src/ ├── core/ # 核心框架 │ ├── Context.js # 数据容器 │ ├── Step.js # 步骤基类 │ ├── Pipeline.js # 执行器 │ └── BuildCache.js # 构建缓存（buildGroup 共享） │ ├── builders/ # 构建器 │ ├── BuilderBase.js # 构建器基类 │ ├── BuilderFactory.js # 工厂类 │ ├── BuilderAndroid.js # Android 构建器 │ ├── BuilderIOS.js # iOS 构建器 │ ├── BuilderWechat.js # 微信小游戏构建器 │ └── ... │ ├── steps/ # 步骤 │ ├── creator/ # Creator 相关步骤 │ │ ├── BuildCreatorStep.js │ │ ├── ModifyVersionJsonStep.js │ │ └── GenerateManifestStep.js │ ├── compile/ # 编译相关步骤 │ │ ├── CompileAndroid.js │ │ ├── CompileWechat.js │ │ └── ... │ ├── sign/ # 签名相关步骤 │ │ ├── SignApkStep.js │ │ └── SignHapStep.js │ └── upload/ # 上传相关步骤 │ ├── UploadArtifactStep.js │ └── UploadRemoteResStep.js │ ├── config/ # 配置加载器 │ └── ConfigLoader.js │ └── ... # 各配置文件的解析 │ ├── utils/ # 工具类 │ ├── Logger.js │ ├── Command.js │ └── DataHelper.js │ └── bin/ # 入口脚本 ├── buildcc.js # 交互式打包（仅 Creator） ├── build.js # 交互式打包（完整流程） ├── hotupdate.js # 交互式热更新 ├── build-jenkins.js # CI/CD 打包 ├── hotupdate-jenkins.js # CI/CD 热更新 └── lib/ # 核心逻辑（交互式和 CI/CD 共享） ├── build-core.js # 构建核心逻辑 └── hotupdate-core.js # 热更新核心逻辑 ``` ## 六、更新声明 ### 1.0.0 (2025-11-13) - 首版本 ## 七、联系作者 * 邮箱: gong.xinhai@163.com * 微信: G0900901 * 扫码加微信: ![e9f2f7797c544f40a14897fc57fcf168.png](https://download.cocos.com/CocosStore/resource/a19e2514f14e4aa4a8b63ec25392a13c/a19e2514f14e4aa4a8b63ec25392a13c.png) ## 八、版权声明商业授权范围仅限于在您自行开发的游戏作品中使用不得进行任何形式的转售、租赁、传播等 ## 九、购买须知本产品为付费虚拟商品，一经购买成功概不退款，请在购买前谨慎确认购买内容。