简介Gradle 7.2 完整发行包gradle-7.2-all.zip面向 Android Studio 开发者适合需要离线安装或固定构建版本的场景可解决官方源下载慢、网络不稳定导致环境配置受阻的问题。压缩包为 zip 格式体积约 149.73MB内含 Gradle 运行时、核心库及相关构建工具便于开发者在本地直接完成版本切换资源页暂未列出文件总数与类型明细。目前已有 1463 人学习下载说明该版本在 Android 应用构建场景中具有较高的使用需求。下载后可在 Android Studio 中指定本地 Gradle 目录让项目编译跳过在线获取环节避免因网络问题反复等待同时 Gradle 自带的依赖管理、多项目构建、自定义构建逻辑和插件扩展能力也能帮助开发者更灵活地控制 APK/AAR 的生成与打包过程。对于希望统一构建环境、缩短同步等待时间的开发者这是一份实用的离线构建工具包。 不知道有没有人跟我一样第一次看到“gradle-7.2-all.zip”这个名字的时候脑子里蹦出来的是“这又是什么要装的环境”然后在公司网速不给力的下午盯着那个几十上百兆的压缩包下载进度条心态直接崩掉。说实话Gradle这个构建工具用好了是真省心用不好就是各种“could not install gradle distribution from”和“deprecated gradle features”轮番轰炸。今天不聊虚的就围绕这个gradle-7.2-all.zip把下载、安装、配置、换源、排查问题这条链路完整捋一遍该给的地址给地址该讲的原理讲原理保证你看完能少踩几个坑。这个zip文件本身是Gradle 7.2版本的完整发行包后缀里的“all”表示它包含源码、文档以及所有平台Windows/macOS/Linux的运行脚本和二进制内容。很多人一开始搞不清楚“bin”和“all”的区别简单说bin版只包含当前平台运行所需的最小文件集all版则是全家桶。如果你有离线安装、多平台切换、或者想翻源码的需求直接下all版准没错。接下来我把从零开始配置的过程以及我实际使用中遇到的各种疑难杂症全部拆开来讲。1. gradle-7.2-all.zip到底是什么为什么偏要选7.21.1 一个压缩包里的完整世界Gradle是一个基于JVM的自动化构建工具和Maven、Ant属于同一类工具但它的灵活性和性能表现更突出。它采用Groovy或Kotlin DSL来编写构建脚本天生适合复杂项目的多模块构建、增量编译和并行任务执行。Android官方从很早开始就主推Gradle作为构建系统所以凡是做Android开发的人几乎每天都要和它打交道。gradle-7.2-all.zip这个文件解压之后你会看到几个关键目录bin目录里存放的是gradle启动脚本lib目录里是Gradle运行所需的全部jar包docs目录是官方文档和DSL参考src目录则是Gradle本身的源码。这也就意味着你拿到这个压缩包就相当于拿到了一个完整的、自包含的构建工具链不需要再联网拉取任何Gradle核心组件。我为什么建议使用all版本而不是bin版本因为bin版本只有当前系统的可执行脚本和运行库如果你在公司电脑Windows写好的项目拿回家里的Mac上继续跑bin版的wrapper还能正常工作但如果你想在IDE里直接查看Gradle源码、或者执行某些需要完整发行版的任务bin版可能就会报找不到文件的错。all版则没有这种问题而且体积也就大几十MB现在的硬盘和带宽完全不在乎这一点。1.2 为什么偏偏是7.2版本选择的现实考量Gradle的版本迭代非常快新版本往往伴随着性能优化和API变更。7.2这个版本发布于2021年下半年属于7.x系列中比较稳定的一代。它支持Java 16默认使用Java 8字节码作为目标对Kotlin DSL脚本的编译速度和配置缓存Configuration Cache都做了大量改进。对于Android开发来说7.2和Android Gradle PluginAGP7.0.x配合得非常好很多项目组当时就是从AGP 4.2升级到AGP 7.0配套的Gradle版本要求就是不能低于7.0而7.2恰好是一个“踩坑少、资料多”的选择。网上搜索热词里经常出现“com.android.tools.build:gradle:4.2.0 怎么升级为agp”这个升级过程中最关键的一步就是同步升级Gradle。AGP 4.2对应的Gradle版本是6.7.1及以上而AGP 7.0则要求Gradle 7.0以上。如果你直接把AGP升到7.0却不动Gradle构建的时候就会直接提示你版本太低。我自己的经验是从AGP 4.2升到AGP 7.0时顺手把Gradle升到7.2-all过程非常平滑几乎没有因为版本兼容性问题浪费时间。还有一个小细节是Gradle 7.x对过时API的警告处理更严格。你在构建日志里看到的“deprecated gradle features were used in this build, making it incompatible with Gradle 8.0”就是从7.x开始打出来的警告。这个警告的意思是你当前项目用的某些写法在Gradle 7.x里还能跑但到了8.0就会被移除。所以如果你打算长期维护一个项目选7.2这个版本可以给你留出充足的时间来修复这些弃用警告。2. 下载攻略从官网到国内镜像的实操记录2.1 官网直下以及它为什么经常失败Gradle官方的下载地址是services.gradle.org/distributions/其中gradle-7.2-all.zip的直链是https://services.gradle.org/distributions/gradle-7.2-all.zip这个地址也是Gradle Wrapper默认的下载来源。所谓Wrapper就是项目中gradlew脚本根据gradle-wrapper.properties文件里的distributionUrl去自动下载对应版本的Gradle。这样团队协作时每个人不需要手动安装Gradle只需要运行gradlew命令它就会自动把对应版本的Gradle拉到本地。问题来了因为服务器在海外国内网络环境下这个下载经常非常慢甚至直接超时。很多人在Android Studio里新建项目时卡在“Gradle: Download gradle-7.2-all.zip”这一步一等就是半小时最后等来一个“could not install gradle distribution from... java.net.SocketTimeoutException”。这可以说是国内开发者最常见的痛点了。我实测过官网直连在普通宽带下经常只有几十KB/s一个100MB的包能下到天荒地老。所以如果你急着用千万不要死磕官网地址直接用镜像就好。2.2 国内镜像源的配置细节腾讯、阿里、华为国内比较靠谱的Gradle镜像源我用下来最稳的是腾讯云的镜像https://mirrors.cloud.tencent.com/gradle/gradle-7.2-all.zip这个地址会在你请求时自动重定向到腾讯云的对象存储速度非常快我自己在普通企业宽带下能跑到10MB/s以上几乎是秒下。腾讯镜像的目录结构和官网保持一致也就是说你只需要把services.gradle.org替换成mirrors.cloud.tencent.com/gradle就能下载任意版本的Gradle发行包。阿里云也有类似的镜像服务主要提供Maven仓库镜像常见的地址是https://maven.aliyun.com/repository/gradle不过阿里云这个更多的是用于依赖库的代理而不是Gradle发行版的下载。华为云的镜像同样有Gradle发行版https://mirrors.huaweicloud.com/gradle/我个人建议优先使用腾讯云镜像因为它的目录结构最完整更新速度也比较及时。如果你是公司内网环境可以先把gradle-7.2-all.zip下载到一个共享目录然后通过本地文件的方式安装这个在下一章会详细讲。3. 安装与配置从解压到命令行全局可用的完整流程3.1 Windows环境配置在Windows上下载好gradle-7.2-all.zip之后把它解压到一个路径中不含中文和空格的目录比如D:\Develop\gradle-7.2。然后需要配置环境变量新增一个系统变量GRADLE_HOME值就是你的解压目录再把%GRADLE_HOME%\bin加到Path变量里。具体操作步骤是右键“此电脑” - “属性” - “高级系统设置” - “环境变量”。在系统变量区域点击“新建”变量名填GRADLE_HOME变量值填D:\Develop\gradle-7.2。然后在系统变量里找到Path选中后点击“编辑”在列表末尾新增一行%GRADLE_HOME%\bin确定保存即可。配置完成后重新打开一个命令行窗口输入gradle -v如果能看到Gradle 7.2以及JVM、Kotlin等版本信息就说明安装成功了。这里有个常见的坑如果你之前安装过其他版本的Gradle或者电脑里同时存在多个GRADLE_HOME引用命令行可能会指向旧版本。解决办法是检查echo %GRADLE_HOME%输出的路径是不是你刚刚设置的以及where gradle确认实际调用的可执行文件位置。在Windows下我建议把解压目录放在D盘而不是C盘一方面是C盘空间通常比较紧张另一方面是Gradle运行时会生成大量缓存如果项目所在盘空间不够会非常尴尬。另外Gradle的用户级缓存目录默认是在用户主目录下的.gradle文件夹如果你不想让它占C盘空间可以在系统变量里新增GRADLE_USER_HOME指定到一个大一点的盘符。3.2 macOS/Linux环境配置macOS和Linux的配置原理是一样的把zip解压到一个固定目录比如/opt/gradle/gradle-7.2然后编辑用户级的环境变量文件。以macOS为例编辑~/.zshrc加上这两行export GRADLE_HOME/opt/gradle/gradle-7.2 export PATH$GRADLE_HOME/bin:$PATH保存后执行source ~/.zshrc让配置生效然后运行gradle -v验证。Linux下如果你的shell是bash就编辑~/.bashrc或者~/.profile格式完全相同。这里有一个细节值得注意把Gradle解压到/opt目录时如果当前用户对这个目录没有写权限需要先执行sudo chown -R $(whoami) /opt/gradle 或者用sudo解压。不然后续Gradle运行时尝试写入自己的临时文件可能会因为权限不足报错。如果你使用Homebrew也可以直接brew install gradle但这种方式安装的版本往往不是7.2而且brew的版本更新很快不一定能精确锁定到你想要的版本。所以想用gradle-7.2-all.zip的话手动解压配置环境变量仍然是最可控的方式。3.3 环境变量验证与常见坑配置完成后运行gradle -v会输出类似下面的信息------------------------------------------------------------ Gradle 7.2 ------------------------------------------------------------ Build time: 2021-08-17 09:59:03 UTC Revision: a6c5f840e6ac5c1e8b1c6e3a3f7b0f1f7f9d2a2b Kotlin: 1.5.21 Groovy: 3.0.8 Ant: Apache Ant(TM) version 1.10.9 JVM: 11.0.12 (Oracle Corporation 11.0.128) OS: Mac OS X 10.15.7 x86_64JVM这一行要特别注意Gradle要求JDK版本和项目要求的Java版本匹配。Gradle 7.2官方支持Java 8到16的版本范围如果你的项目是Java 11那你本地JDK至少得是11。如果JVM版本过低Gradle会提示你升级JDK。还有一个常见的坑是很多人配置完环境变量后发现重启电脑或者重启IDE之后gradle命令不见了。这通常是因为IDE比如Android Studio是在环境变量配置之前启动的IDE里的终端进程没有继承新的环境变量。解决方法是完全退出Android Studio并重新打开或者在新开的终端窗口里验证。不要相信那种“改完环境变量不需要重启”的说法至少在开发者工具类应用程序上重启是真的有必要的。4. 进阶实操解决“每次新建项目都下载Gradle”这个老大难4.1 让Gradle Wrapper走本地分发Android Studio每次新建项目都要下载gradle这背后的逻辑是每一个项目通过Gradle Wrapper定义了它需要的Gradle版本在gradle/wrapper/gradle-wrapper.properties文件里如果你本地没有一个匹配的发行版它就会从distributionUrl指向的地址下载。默认的distributionUrl指向官网所以就会出现每次新建项目都卡在下载的情况。要想根治这个问题有两个思路。第一个思路是把gradle-wrapper.properties里的distributionUrl改成一个更快的镜像地址。比如把distributionUrlhttps\://services.gradle.org/distributions/gradle-7.2-all.zip改成distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-7.2-all.zip这样每次项目需要Gradle 7.2时就会直接从腾讯镜像下载速度快很多。第二个思路是让本地已经存在的一个Gradle发行版作为“种子”然后在GRADLE_USER_HOME下的wrapper/dists目录里预置好对应的zip和解压目录。Gradle Wrapper在下载时会先把zip文件缓存到~/.gradle/wrapper/dists/gradle-7.2-all/ /目录下并生成一个名为gradle-7.2-all.zip.part的临时文件下载完成后改名。如果你手动把完整的zip文件放进这个目录即使没有.part文件Gradle在检测到完整zip存在时也会跳过下载直接解压使用。这个方法对于离线环境尤其好使。4.2 本地Maven仓库和POM文件的手动生成很多项目在构建时需要依赖本地的Maven仓库或者需要生成POM文件用于发布。Gradle项目生成POM最常用的方式是使用maven-publish插件。在build.gradle中配置plugins { id maven-publish } publishing { publications { mavenJava(MavenPublication) { from components.java } } }然后在项目根目录执行gradle publishToMavenLocalGradle就会把项目的构建产物和自动生成的POM文件发布到本地的~/.m2/repository目录。这个能力和Maven的mvn install是等效的。很多人在搜索“让.gradle生成本地maven和pom文件”其实就是想达到这个效果不通过Maven也能把Gradle项目产物安装到本地Maven仓库供其他基于Maven构建的项目依赖使用。实际操作中你可能会遇到“No publication named mavenJava found”这样的报错原因一般是你的项目没有应用java-library或者java插件。因为from components.java这个写法依赖java插件的SoftwareComponent。解决办法是在build.gradle里加上plugins { id java-library }然后重新执行publishToMavenLocal即可。4.3 仓库换源配置allprojects/repositories除了Gradle发行版的镜像依赖仓库的换源同样重要。默认情况下项目会从Google和Maven Central拉取依赖国内访问这两个仓库的速度也是一言难尽。常见的做法是使用阿里云的公共仓库buildscript { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/gradle-plugin } } } allprojects { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/gradle-plugin } } }这里有几个镜像对应关系需要搞清楚maven.aliyun.com/repository/google对应的是Google的Maven仓库repository/public是Maven Central和JCenter的聚合repository/gradle-plugin则对应Gradle Plugin Portal。把这三个配好绝大多数项目的依赖都能顺利下下来。换源的另一个收益是可以避免“could not get resource”这类因为网络问题导致的构建失败。我实际测试过同一台机器默认源构建一个中型Android项目需要十几分钟换成阿里云镜像后五分钟以内就能完成。这个时间差异对于日常开发来说影响非常大。5. 常见问题与排查技巧实录5.1 could not install gradle distribution fromSocketTimeoutException这个报错翻译成人话就是Gradle在下载发行版时连接超时了。原因几乎可以断定是网络无法稳定访问官网的下载服务器。排查步骤很简单先检查你的gradle-wrapper.properties里distributionUrl是不是指向了services.gradle.org如果指向官网那就把它换成腾讯镜像或者阿里云镜像。另外再把项目目录下的.gradle缓存清一下因为损坏的下载临时文件有时候会导致反复失败。如果换了镜像还是不行那就手动把zip文件下载下来然后按照4.1节里说的方式手动放进wrapper/dists目录。这个方法不需要任何代理完全离线是最保险的方案。5.2 deprecated gradle features were used in this build这个警告在Gradle 7.x中非常常见项目构建日志末尾会出现“deprecated gradle features were used in this build, making it incompatible with Gradle 8.0”。它的本质是你的项目或者项目里引用的某个插件使用了Gradle 7.x已经标记为弃用的API或特性。要定位到底是哪里用了弃用API可以在gradle.properties里加上org.gradle.warning.modeall这样Gradle会把每一个弃用警告的完整堆栈打出来。你看到具体是哪段代码后针对性地替换成新写法。对于大多数项目最常见的原因是旧版本的Android Gradle Plugin或者某个第三方插件调用了被标记弃用的Gradle API。如果暂时没有精力改可以暂时忽略这个警告它不会导致构建失败但会在升级到Gradle 8.0的时候变成硬性错误。5.3 Flutter项目的Gradle插件应用方式警告搜索热词里有一条“you are applying flutters main gradle plugin imperatively using the apply script method”这是Flutter项目迁移到新版Gradle时的高频警告。它的意思是你项目的settings.gradle或build.gradle里用了旧式的apply script方式引入Flutter插件而新版推荐使用plugins DSL。解决办法是把apply script改成plugins DSL。在settings.gradle里把apply from: $flutterRoot/packages/flutter_tools/gradle/app_plugin_loader.gradle改为plugins { id dev.flutter.flutter-plugin-loader version 1.0.0 }然后移除build.gradle里的对应apply配置。这个改动需要你的Flutter版本和Gradle版本匹配如果是在Flutter 2.x时代创建的项目直接改成plugins DSL可能会遇到插件找不到的问题需要先升级Flutter或者把settings.gradle里的pluginManagement仓库配置好。5.4 Android Studio每次新建项目都要下载gradle这个现象的根本原因是Android Studio在创建项目时会根据模板生成一个指定版本的Gradle Wrapper而这个版本你本地没有所以它就去下载。解决办法有两个层面第一个层面是给所有新项目指定一个统一版本Android Studio里File - Settings - Build Tools - Gradle可以配置Gradle的发行版为一个本地目录这样新建项目时会优先使用你指定的本地发行版而不是每次去下载wrapper指定的版本。第二个层面是修改IDE的模板文件让新项目的gradle-wrapper.properties默认指向你已经下载好的版本。这个方法比较麻烦需要在Android Studio安装目录里找到项目模板的wrapper配置不建议新手操作。对我来说最省事的方案就是把gradle-7.2-all.zip提前下载好然后在Android Studio的Gradle设置里选择“Use local Gradle distribution”路径指向你解压好的目录。这样IDE就不会再去重复下载发行版了无论是新建项目还是导入项目都会快很多。6. 避坑经验与实用建议6.1 备份和版本管理的血泪教训Gradle的发行包说大不大说小不小但每次网络不好时都要重新下载真的非常折磨人。我现在在公司电脑和个人的移动硬盘里各存了一份gradle-7.2-all.zip还专门建了一个目录用来收藏各种版本的Gradle发行包。因为项目迭代久了不同分支可能锁定在不同的Gradle版本如果没有本地备份切换分支时经常要等下载这效率实在是太低了。另外我强烈建议团队内部维护一个统一的Gradle版本规范。不要每个项目各写各的distributionUrl尽量统一到一个经过验证的版本上比如7.2。这样可以大幅减少团队成员“我本地可以跑你本地为什么不行”这种问题的出现频率。6.2 关于gradle.properties的优化配置在用户主目录下的.gradle文件夹中创建一个gradle.properties文件可以全局性地影响所有Gradle构建的性能。我常用的配置有org.gradle.daemontrue org.gradle.paralleltrue org.gradle.cachingtrue org.gradle.jvmargs-Xmx4096m -XX:MaxMetaspaceSize1024m开启daemon可以减少每次构建的JVM启动时间parallel可以让多模块项目并行构建caching则可以对构建输出做缓存大幅提升重复构建的速度。jvmargs的大小要根据你电脑内存来设定内存只有8G的话建议把Xmx设置为2048m不然Gradle和Android Studio同时跑机器容易卡死。6.3 什么时候需要重装或者清理Gradle用久了~/.gradle/caches目录会非常庞大动辄几个GB。如果你发现某次构建行为非常怪异比如依赖解析出现莫名其妙的错误、插件版本不对最直接的排查手段是执行gradle clean和gradle build如果还不行就直接删掉~/.gradle/caches目录重新构建。虽然是“核武器”级别的操作但确实能解决很大一部分隐藏的缓存问题。删缓存不会影响你之前安装的Gradle发行版发行版在wrapper/dists目录和caches是分开的。所以这个操作是安全的最多就是第一次重新构建时要把依赖重新拉一遍但换来的干净环境通常值得这个时间成本。最后再做个小结式的推荐新手也好老手也罢如果你要选择一个Gradle版本作为主力工具来使用7.2-all这个版本真的是一个非常稳妥的选择。配置好了之后日常开发的构建速度和稳定性都很不错网上能搜到的各种资料也多。下载的时候记得先去腾讯镜像安装的时候一定把环境变量配好遇到下载问题就手动放本地dists目录这几个关键点掌握住Gradle这个工具就再也难不倒你了。本文还有配套的精品资源点击获取