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等主流仓库内容
• 稳定可靠：阿里云基础设施保障
• 免费使用：无需注册或配置密钥

镜像地址对照表：

注意：请始终使用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分钟内完成

如果仍然遇到问题，可以检查以下几点：

1. 文件权限问题：确保Unity有权限写入Gradle缓存目录
2. 代理设置冲突：检查系统是否设置了可能干扰的HTTP代理
3. Unity版本差异：某些特殊版本可能需要修改其他模板文件
4. 镜像同步延迟：极少数情况下新发布的依赖可能有几小时同步延迟

实用技巧：在Unity的Console窗口开启详细日志模式（Window > Analysis > Profiler，然后切换到Log级别），可以实时查看Gradle下载进度。

5. 进阶配置：自定义Gradle版本

对于需要特定Gradle版本的项目，可以结合镜像方案实现更灵活的配置：

1. 从Gradle官网下载所需版本的二进制包
2. 在Unity偏好设置中取消勾选"Gradle Installed with Unity"
3. 指定本地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版本

实际项目中，我通常会创建一个构建配置预设，将所有这些优化项保存为可一键应用的模板，不同场景（开发、测试、发布）使用不同的优化组合。