这是一个Unity项目，提供了一套完整的自动化构建解决方案，支持Android、iOS和Windows平台的一键构建。该工具旨在简化Unity项目的构建过程，提高开发效率，特别适用于CI/CD流程集成。
- 🔄 多平台支持：支持Android、iOS和Windows平台的构建
- ⌨️ 命令行支持：提供完整的命令行参数，可以在批处理模式下运行
- 📝 构建信息记录：自动生成构建信息文件，记录构建详情
- 🏷️ 版本管理：支持通过命令行参数配置版本号和构建号
- 🔐 Android签名配置：支持自定义签名文件或使用默认签名
- ⚡ 增量构建支持：提供增量构建选项，加快构建速度
- 🤖 CI/CD友好：设计适合自动化流程，可轻松集成至Jenkins、GitHub Actions等
- 克隆本项目到本地
- 使用Unity 2019.4或更高版本打开项目
- 选择菜单
构建/构建Android进行首次构建测试 - 或运行根目录下的
UnityBuild.bat进行命令行构建
- 打开Unity项目
- 通过菜单栏选择：
构建/构建全部平台- 构建所有平台构建/构建Android- 仅构建Android平台构建/构建iOS- 仅构建iOS平台构建/构建Windows- 仅构建Windows平台
使用以下命令在命令行中执行构建：
"C:\Program Files\Unity\Hub\Editor\2022.3.18f1\Editor\Unity.exe" -batchmode -quit -projectPath "项目路径" -executeMethod ProjectBuild.BuildForAndroid -logFile build.log -outputDir "D:/Builds" -versionName "1.0.0" -buildNumber 1| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
-project |
字符串 | 否 | 自定义项目名称 | -project=MyGame |
-outputDir |
路径 | 否 | 输出目录路径 | -outputDir=D:/Builds |
-versionName |
字符串 | 否 | 版本名称 | -versionName=1.0.0 |
-buildNumber |
整数 | 否 | 构建号 | -buildNumber=10 |
-keystoreName |
路径 | 否 | Android签名文件路径 | -keystoreName=path/to/keystore.jks |
-keystorePass |
字符串 | 否 | 签名文件密码 | -keystorePass=password |
-keyaliasName |
字符串 | 否 | 密钥别名 | -keyaliasName=alias |
-keyaliasPass |
字符串 | 否 | 密钥密码 | -keyaliasPass=password |
-development |
布尔 | 否 | 启用开发者模式 | -development |
-profiling |
布尔 | 否 | 启用性能分析 | -profiling |
-scriptDebugging |
布尔 | 否 | 启用脚本调试 | -scriptDebugging |
-verbose |
布尔 | 否 | 启用详细日志 | -verbose |
构建完成后，在指定的输出目录或默认的APK目录中，你将会找到:
- 构建的应用文件(APK/EXE等)
.buildinfo文件，包含构建的详细信息:- 构建时间和环境信息
- 产品名称和版本信息
- 构建大小和压缩率
- 使用的Unity版本和构建选项
- 包含的场景列表
项目中包含了UnityBuild.bat批处理脚本示例，可以用于快速构建:
@echo off
set UNITY_PATH="C:\Program Files\Unity\Hub\Editor\2022.3.18f1\Editor\Unity.exe"
set PROJECT_PATH=%~dp0
set OUTPUT_DIR=%~dp0APK
%UNITY_PATH% -batchmode -quit -projectPath %PROJECT_PATH% -executeMethod ProjectBuild.BuildForAndroid -logFile build.log -outputDir "%OUTPUT_DIR%" -versionName "1.0.0" -buildNumber 1
echo 构建完成，日志文件：build.log
pauseA: 可以通过 -outputDir 参数指定自定义输出路径。
A: 查看构建日志文件（默认为项目根目录下的build.log），通常会包含错误信息。
A: 创建一个调用Unity的脚本任务，加入必要的命令行参数，并确保CI环境中已安装Unity。
- Unity 2019.4 或更高版本
- 对应平台的构建支持模块（Android/iOS/Windows）
- Android构建需要安装Android SDK和JDK
- iOS构建只能在macOS系统上进行
- Fork本仓库
- 创建你的特性分支 (
git checkout -b feature/amazing-feature) - 提交你的更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 开启一个Pull Request
📅 更新日期: 2025年4月25日