1. 为什么需要自动化构建系统作为一个在游戏行业摸爬滚打多年的老鸟我见过太多团队在项目后期被频繁的打包需求折磨得苦不堪言。想象一下这样的场景策划要测试一个新功能程序说等我打个包美术想看看效果程序又说等我打个包。一天下来光打包就占用了开发者至少30%的工作时间。更糟的是手动打包过程中还容易出现各种人为失误。比如忘记切换平台、打包参数设置错误、版本号忘记更新等等。这些问题轻则导致测试中断重则可能让错误版本上线造成难以挽回的损失。自动化构建系统就是为了解决这些问题而生的。它能够解放开发者的双手把重复劳动交给机器确保每次构建的环境和参数完全一致支持多平台并行构建提升整体效率实现版本管理的规范化我去年接手的一个中型手游项目在引入自动化构建前每次发版都需要3个程序员轮流值守从下午忙到凌晨。而现在只需要点击一个按钮喝杯咖啡的功夫所有平台的包就都打好了。2. Jenkins基础环境搭建2.1 Java环境配置Jenkins是用Java开发的所以第一步要确保Java环境就位。这里我强烈推荐使用JDK 11 LTS版本它在稳定性和兼容性上都有很好表现。安装完成后需要配置两个关键环境变量JAVA_HOME指向JDK安装目录PATH添加%JAVA_HOME%\bin验证安装是否成功java -version如果看到类似下面的输出说明配置正确java version 11.0.12 2021-07-20 LTS Java(TM) SE Runtime Environment 18.9 (build 11.0.128-LTS-237) Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.128-LTS-237, mixed mode)2.2 Jenkins安装与初始化从官网下载最新的LTS版本安装包。我建议选择Windows Installer版本它会自动将Jenkins注册为系统服务。安装过程中有几个关键点需要注意服务账户选择Local System端口号建议使用8080以外的端口比如8077安装完成后会自动打开浏览器进入初始化向导初始化时系统会要求输入管理员密码。这个密码可以在以下位置找到C:\Program Files\Jenkins\secrets\initialAdminPassword第一次登录后建议立即创建一个新的管理员账号并记住密码。然后跳过插件安装后续再按需安装直接进入主界面。3. Unity项目配置3.1 多平台支持设置要让Unity项目支持多平台构建首先需要在Player Settings中进行基础配置打开File Build Settings添加需要支持的平台Android/iOS/Windows等为每个平台设置独特的Bundle Identifier配置各平台的图标、启动画面等资源特别提醒iOS平台需要额外配置有效的开发者证书正确的Provisioning Profile设置合适的Team ID3.2 命令行打包脚本自动化构建的核心是一个可靠的打包脚本。下面是我在项目中实际使用的C#脚本框架using UnityEditor; using System.Linq; public static class BuildPipeline { public static void BuildAndroid() { var options new BuildPlayerOptions { scenes EditorBuildSettings.scenes .Where(s s.enabled) .Select(s s.path) .ToArray(), locationPathName Builds/Android/app.apk, target BuildTarget.Android, options BuildOptions.None }; // 应用命令行参数 ApplyCommandLineArgs(); BuildPipeline.BuildPlayer(options); } private static void ApplyCommandLineArgs() { var args System.Environment.GetCommandLineArgs(); foreach(var arg in args) { if(arg.StartsWith(-version:)) { PlayerSettings.bundleVersion arg.Split(:)[1]; } // 其他参数处理... } } }这个脚本可以通过以下命令行调用Unity.exe -quit -batchmode -executeMethod BuildPipeline.BuildAndroid -projectPath 项目路径4. Jenkins与Unity集成4.1 基础任务配置在Jenkins中创建一个新的自由风格项目配置以下关键参数源码管理配置Git/SVN仓库地址构建触发器可以设置为代码提交时触发构建环境勾选Delete workspace before build starts构建步骤添加Windows批处理命令一个典型的构建命令如下call C:\Program Files\Unity\Hub\Editor\2021.3.4f1\Editor\Unity.exe ^ -quit ^ -batchmode ^ -projectPath %WORKSPACE% ^ -executeMethod BuildPipeline.BuildAndroid ^ -logFile %WORKSPACE%\build.log ^ -version:%BUILD_NUMBER%4.2 参数化构建为了让构建更加灵活我们可以设置参数化构建在任务配置中勾选This project is parameterized添加以下参数Choice Parameter平台选择Android/iOSString Parameter版本号Boolean Parameter是否上传到测试平台然后在构建脚本中根据这些参数动态调整构建行为if %PLATFORM%Android ( call unity.exe ... -executeMethod BuildPipeline.BuildAndroid ) else ( call unity.exe ... -executeMethod BuildPipeline.BuildiOS )5. 高级功能实现5.1 自动化测试集成构建完成后可以自动运行单元测试和集成测试call unity.exe ^ -runTests ^ -testPlatform EditMode ^ -testResults %WORKSPACE%\TestResults.xml然后在Jenkins中安装JUnit插件配置测试报告路径就能在构建结果中看到测试覆盖率等信息。5.2 构建产物管理我通常使用以下目录结构管理构建产物Builds/ ├── Android/ │ ├── v1.0.0/ │ │ ├── app-release.apk │ │ └── changelog.txt ├── iOS/ │ ├── v1.0.0/ │ │ ├── app.ipa │ │ └── symbols.zip └── Latest/ - Android/v1.0.0/ (符号链接)通过Jenkins的Archive the artifacts功能可以自动保存历史版本。5.3 邮件通知在构建后操作中添加Editable Email Notification配置团队成员的邮箱地址。可以设置构建失败时自动发送警报邮件成功时发送版本更新通知。6. 常见问题排查在实际项目中我遇到过各种稀奇古怪的问题。这里分享几个典型案例问题1Unity打包时卡住无响应解决方案检查是否有杀毒软件拦截添加Unity相关进程到白名单问题2Android包安装失败排查步骤检查logcat日志确认keystore配置正确验证设备是否开启了USB调试问题3iOS包上传TestFlight失败常见原因证书过期设备UUID未添加Provisioning Profile不匹配对于这类问题我的经验是首先查看Unity Editor.log检查Jenkins控制台输出对比成功和失败的构建参数差异7. 性能优化技巧经过多个项目的实践我总结出以下优化建议增量构建对于资源不变的构建可以使用AssetBundles减少打包时间分布式构建配置多个构建节点并行处理不同平台的打包任务缓存优化合理设置Unity的Cache Server地址构建机配置使用SSD硬盘至少16GB内存在我的一个MMO项目中通过优化构建流程将全平台打包时间从原来的2小时缩短到了30分钟。关键优化点包括使用增量AssetBundle构建并行执行不依赖的构建步骤预先生成光照贴图8. 安全注意事项自动化构建系统涉及代码和证书安全需要特别注意凭证管理不要将keystore密码硬编码在脚本中使用Jenkins的Credentials插件管理敏感信息访问控制限制构建任务的执行权限定期审计构建日志代码签名开发证书和生产证书分开管理定期轮换过期证书我曾经遇到过因为构建服务器被入侵导致证书泄露的情况。现在我们的做法是使用硬件加密的构建机每次构建后自动清理工作空间关键证书使用时才临时注入9. 扩展功能开发对于大型团队可以考虑开发一些增强功能自动化测试报告分析解析单元测试结果自动创建JIRA任务版本号自动递增根据Git提交历史自动生成语义化版本号资源检查工具构建前自动检测资源规范问题热更新包生成构建完成后自动生成差异更新包我在上一个项目中使用Python开发了一个构建监控面板实时显示各平台构建状态构建耗时趋势资源大小变化关键性能指标这个工具极大提升了团队的构建可视化程度帮助我们发现了很多潜在问题。10. 实际项目经验分享去年我们团队开发的一款休闲游戏需要同时发布到Android、iOS和WebGL平台。通过完整的自动化构建系统我们实现了一键多平台发布点击一次按钮30分钟内完成所有平台构建自动化测试构建后自动运行300测试用例版本追溯每个构建产物都关联具体的Git提交快速回滚任何版本都可以在10分钟内重新构建这个系统让我们的发布频率从每周一次提升到每天多次极大加快了迭代速度。特别是在游戏上线初期能够快速修复线上问题为产品赢得了宝贵的时间窗口。在实施过程中最大的挑战是统一不同平台的特殊需求。比如iOS需要处理证书问题WebGL需要考虑CDN部署。我们通过抽象平台相关逻辑保持核心构建流程一致最终实现了优雅的解决方案。