Unity 2019+打包APK卡在Building Gradle？试试这招替换阿里云镜像，5分钟搞定
Unity 2019+打包APK卡在Building Gradle？5分钟镜像替换实战指南
当你满怀期待点击"Build APK"按钮，却看到Unity卡在"Building Gradle project"进度条半小时毫无反应时，那种焦躁感每个Android开发者都深有体会。特别是在使用Unity 2019及以上版本时，这个看似简单的构建步骤常常成为新手开发者的噩梦——不是因为代码问题，而是Gradle依赖下载这个看似与开发无关的环节。本文将带你直击问题本质，用国内开发者最熟悉的阿里云镜像彻底解决这个痛点。
1. 为什么Gradle构建会成为Unity打包的拦路虎
Gradle作为Android项目的标准构建工具，其依赖管理默认从Google和JCenter仓库获取资源。这两个服务器位于海外，在国内访问时经常遇到：
- 下载速度极慢：一个几MB的依赖包可能需要半小时
- 连接不稳定：经常出现超时中断导致构建失败
- 完全无法访问：某些网络环境下根本连不上
Unity 2019版本开始使用更新的Gradle版本，这个问题变得尤为突出。当你在Unity中看到这样的日志时：
> Configure project :launcher Downloading https://services.gradle.org/distributions/gradle-5.6.4-all.zip ..........然后进度就永远停在这里——这就是典型的Gradle下载卡死现象。更糟糕的是，Unity的构建进程不会主动超时退出，可能让你白白等待数小时。
2. 阿里云镜像：国内开发者的加速利器
阿里云提供的Maven镜像服务完美解决了这个问题，它具有：
- 国内CDN加速：下载速度提升10-100倍
- 全量同步：包含Google、JCenter等主流仓库内容
- 稳定可靠：阿里云基础设施保障
- 免费使用：无需注册或配置密钥
镜像地址对照表：
| 原始仓库 | 阿里云镜像地址 |
|---|---|
| google() | http://maven.aliyun.com/repository/google |
| jcenter() | http://maven.aliyun.com/repository/jcenter |
| gradle-plugin | http://maven.aliyun.com/repository/gradle-plugin |
| 公共仓库 | http://maven.aliyun.com/nexus/content/groups/public/ |
注意：请始终使用http协议而非https，部分环境下https可能仍有访问问题
3. 实战修改Gradle模板文件
找到Unity安装目录下的Gradle模板文件是解决问题的关键。不同Unity版本路径略有差异：
[Unity安装根目录]/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/GradleTemplates典型路径示例：
- Windows:
C:\Program Files\Unity\Hub\Editor\2019.4.19f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\GradleTemplates - macOS:
/Applications/Unity/Hub/Editor/2019.4.19f1/Unity.app/Contents/PlaybackEngines/AndroidPlayer/Tools/GradleTemplates
需要修改的文件是baseProjectTemplate.gradle，建议先备份原文件。用文本编辑器打开后，找到以下两个关键部分：
3.1 修改buildscript仓库配置
原配置：
buildscript { repositories { **ARTIFACTORYREPOSITORY** google() jcenter() } // ... 其他配置 }修改为：
buildscript { repositories { **ARTIFACTORYREPOSITORY** maven{ url 'http://maven.aliyun.com/repository/google'} maven{ url 'http://maven.aliyun.com/repository/gradle-plugin'} maven{ url 'http://maven.aliyun.com/nexus/content/groups/public/'} maven{ url 'http://maven.aliyun.com/repository/jcenter'} } // ... 其他配置保持不变 }3.2 修改项目仓库配置
原配置：
repositories { **ARTIFACTORYREPOSITORY** google() jcenter() flatDir { dirs "${project(':unityLibrary').projectDir}/libs" } }修改为：
repositories { **ARTIFACTORYREPOSITORY** maven{ url 'http://maven.aliyun.com/repository/google'} maven{ url 'http://maven.aliyun.com/repository/gradle-plugin'} maven{ url 'http://maven.aliyun.com/nexus/content/groups/public/'} maven{ url 'http://maven.aliyun.com/repository/jcenter'} flatDir { dirs "${project(':unityLibrary').projectDir}/libs" } }4. 验证与常见问题排查
修改完成后保存文件，重新尝试构建APK。正常情况下应该能看到明显的速度提升：
- 首次构建：从原来的30+分钟缩短到2-5分钟
- 后续构建：依赖缓存后可在1分钟内完成
如果仍然遇到问题，可以检查以下几点：
- 文件权限问题：确保Unity有权限写入Gradle缓存目录
- 代理设置冲突：检查系统是否设置了可能干扰的HTTP代理
- Unity版本差异：某些特殊版本可能需要修改其他模板文件
- 镜像同步延迟：极少数情况下新发布的依赖可能有几小时同步延迟
实用技巧：在Unity的Console窗口开启详细日志模式（Window > Analysis > Profiler，然后切换到Log级别），可以实时查看Gradle下载进度。
5. 进阶配置：自定义Gradle版本
对于需要特定Gradle版本的项目，可以结合镜像方案实现更灵活的配置：
- 从Gradle官网下载所需版本的二进制包
- 在Unity偏好设置中取消勾选"Gradle Installed with Unity"
- 指定本地Gradle路径
// 在gradle.properties中添加 unityStreamingAssets=*.unity3d org.gradle.jvmargs=-Xmx4096M systemProp.http.proxyHost= systemProp.http.proxyPort=这种组合方案特别适合：
- 需要使用最新Gradle特性的项目
- 企业内网开发环境
- 对构建过程有特殊定制的场景
6. 其他加速构建的小技巧
除了Gradle镜像替换，这些方法也能显著提升Unity的Android构建速度：
- 禁用Lint检查：在Player Settings > Publishing Settings > Build
- 关闭自动压缩：对开发构建关闭APK压缩
- 使用增量构建：仅当必要资源变化时重新构建
- 配置合适的JDK路径：避免使用过旧的Java版本
实际项目中，我通常会创建一个构建配置预设，将所有这些优化项保存为可一键应用的模板，不同场景（开发、测试、发布）使用不同的优化组合。