简介gradle-7.2-all.zip 是 Gradle 7.2 版本的完整发行包面向使用 Android Studio 进行 Java、Android 及多语言项目开发的工程师尤其适合网络环境不稳定、在线下载 Gradle 速度过慢的开发者用于离线安装与本地构建环境配置。压缩包整体约 149.73MB内含 Gradle 运行时、库文件及相关工具等完整组件解压后可在 Android Studio 中指定本地 Gradle 路径从而加快项目编译速度。该版本在依赖管理、多项目构建、自定义构建逻辑与插件支持方面表现成熟是 Android 项目编译、打包与依赖管理的重要基础工具。目前已有 1466 人学习下载适合需要稳定构建环境、希望避免网络问题导致编译延迟的 Android 开发者参考使用。1. 从一次构建卡死说起gradle-7.2-all.zip 到底解决什么问题如果你在 Android Studio 里遇到过Could not resolve all dependencies或者 Gradle 同步卡在Download https://services.gradle.org/distributions/gradle-7.2-all.zip半小时不动那你大概率已经和这个文件打过照面了。gradle-7.2-all.zip是 Gradle 7.2 发行版中体积最大的一个包和-bin版本的区别在于它额外包含了源码和文档离线环境下能直接查 API 定义不用再跳浏览器。它解决的核心问题就一个让 Android 项目在无外网或弱网环境下完成构建工具链的初始化。适合谁经常在内网环境做 Android 开发的人、需要批量部署 CI 构建节点的运维、以及被公司网络策略卡住下载的移动端工程师。这个包不是可选项是刚需。2. 拆开 gradle-7.2-all.zip目录结构与版本选型逻辑2.1 为什么是 7.2 而不是 7.0 或 8.0Gradle 7.2 在 Android 构建生态里是一个比较稳的锚点。它对应 Android Gradle Plugin 7.0.x 到 7.2.x 的兼容区间再往上走 AGP 8.x 会强制要求 JDK 17很多老项目还在 JDK 11 上跑直接升 8.0 会触发Unsupported class file major version报错。7.2 对 JDK 11 的支持是完整的同时修复了 7.0 里configuration cache在 Android 多模块项目中的几个已知问题。选型时看三个东西AGP 版本、JDK 版本、Kotlin 插件版本。AGP 7.0.4 配 Gradle 7.2 是官方兼容表里明确列出的组合Kotlin 1.5.31 也能正常跑。如果你手里是 AGP 4.2 的老项目那 Gradle 7.2 可能偏高需要先升 AGP。2.2 all 和 bin 的实质差异-all包比-bin多出约 60MB多出来的部分是src目录下的源码和docs目录下的 DSL 参考。实际构建时两者行为完全一致但调试构建脚本时差别很大。比如你在build.gradle里写了一个自定义 Task运行时抛No such property用-bin只能靠猜用-all可以直接在 IDE 里点进 Gradle API 源码看属性定义。常见做法是CI 节点用-bin省空间开发机用-all方便排查。但内网环境往往只允许传一个包进去那就统一用-all多占点磁盘换排查效率。2.3 解压后的关键目录拿到 zip 之后先别急着配解压看一眼结构unzip gradle-7.2-all.zip -d /opt/gradle ls /opt/gradle/gradle-7.2/输出里会看到bin、lib、src、docs四个主要目录。bin下是gradle和gradle.bat启动脚本lib下是gradle-launcher-7.2.jar等核心 jarsrc是源码docs是 DSL 文档。init.d目录默认不存在需要手动创建后面会用到。参数上注意解压路径不要带空格和中文Gradle 启动脚本对路径里的空格处理在 Windows 上偶发问题Linux 下相对稳但统一用纯英文路径最省心。3. 把 gradle-7.2-all.zip 接进 Android Studio三种落地方式3.1 方式一修改 gradle-wrapper.properties 指向本地文件这是最直接的做法。打开项目根目录下的gradle/wrapper/gradle-wrapper.properties把distributionUrl改成file:///开头的本地路径# 指向本地已解压的 gradle-7.2 目录下的 zip 文件 distributionUrlfile\:///opt/gradle/gradle-7.2-all.zip distributionBaseGRADLE_USER_HOME distributionPathwrapper/dists zipStoreBaseGRADLE_USER_HOME zipStorePathwrapper/dists逻辑说明Gradle Wrapper 会先检查GRADLE_USER_HOME/wrapper/dists下有没有对应版本的解压结果没有才去distributionUrl拉。改成file://后它直接从本地读 zip不再走网络。参数上注意 Windows 路径写法是file\:///D\:/gradle/gradle-7.2-all.zip冒号和斜杠都要转义。这个方式的好处是项目级生效不影响其他项目坏处是每个项目都要改一遍项目多了容易漏。3.2 方式二预置到 GRADLE_USER_HOME 缓存目录更省事的做法是让 Wrapper 以为它已经下载过了。Gradle 的缓存路径规则是~/.gradle/wrapper/dists/gradle-7.2-all/hash/那个hash是根据 distributionUrl 算出来的不能随便编。正确操作是先让 Wrapper 尝试下载一次等它创建好目录结构后中断然后把 zip 丢进去。# 触发目录创建后立即 CtrlC 中断 ./gradlew --version # 找到刚创建的 hash 目录 ls ~/.gradle/wrapper/dists/gradle-7.2-all/ # 把本地 zip 复制进去并解压 cp /opt/gradle/gradle-7.2-all.zip ~/.gradle/wrapper/dists/gradle-7.2-all/hash/ cd ~/.gradle/wrapper/dists/gradle-7.2-all/hash/ unzip gradle-7.2-all.zip # 创建标记文件告诉 Gradle 解压完成 touch gradle-7.2-all.zip.ok逻辑说明hash目录名是 Gradle 内部根据 URL 生成的手动创建容易算错所以用「先触发再替换」的方式最稳。gradle-7.2-all.zip.ok这个空文件是 Gradle 判断解压是否完成的标记缺了它 Wrapper 会重新解压甚至重新下载。参数上注意GRADLE_USER_HOME默认是~/.gradle如果改过环境变量路径要跟着变。这个方式一次配置所有项目通用适合开发机。3.3 方式三Android Studio 全局 Gradle 设置Android Studio 自身有一个 Gradle 配置入口在Settings Build, Execution, Deployment Build Tools Gradle里可以把Gradle user home指到一个自定义目录然后把预置好的wrapper/dists放进去。这个方式适合团队统一环境把配置好的 Gradle home 打包新机器解压即用。但注意 Android Studio 版本不同这个设置项的位置和名称有差异较新版本里叫Gradle JDK和Gradle user home两个独立字段别改错。常见翻车点是改了Gradle user home但没同步迁移旧缓存导致所有依赖重新下载内网环境下直接卡死。4. 避坑与排查gradle-7.2-all.zip 落地时的五个血泪经验4.1 现象解压后执行 gradle 命令报 Permission denied原因zip 包在 Windows 上解压后再传到 Linux或者用某些解压工具时bin/gradle的可执行权限丢失。解决手动补权限。chmod x /opt/gradle/gradle-7.2/bin/gradle chmod x /opt/gradle/gradle-7.2/bin/gradle.bat4.2 现象Android Studio 同步时报 Could not install Gradle distribution原因distributionUrl指向的本地路径里有中文或空格或者file://协议写法不对。解决把 zip 移到纯英文无空格路径下Linux 用file:///opt/...Windows 用file\:///D\:/...注意转义。另外确认 zip 文件本身没损坏用unzip -t测一下。4.3 现象构建时提示 Gradle 版本与 AGP 不兼容原因项目里build.gradle声明的 AGP 版本超出了 Gradle 7.2 的支持范围。解决查兼容表AGP 7.0.x 到 7.2.x 对应 Gradle 7.2 是安全的AGP 7.3 以上需要 Gradle 7.4。改build.gradle里的com.android.tools.build:gradle版本号或者换 Gradle 包。这个坑的隐蔽性在于报错信息不会直接说版本不匹配而是抛一堆NoClassDefFoundError。4.4 现象离线模式下依赖仍然解析失败原因Gradle 7.2 本身离线了但项目依赖的第三方库没进本地 Maven 缓存。解决Gradle 离线只解决构建工具不解决依赖。需要提前把~/.gradle/caches/modules-2/files-2.1下的依赖缓存一起打包迁移或者在settings.gradle里配mavenLocal()并预置本地仓库。常见做法是搭一个内网 Maven 镜像但那是另一个话题了。4.5 现象多模块项目里某个子模块用了不同 Gradle 版本原因子模块的gradle/wrapper/gradle-wrapper.properties没跟着改或者根目录和子目录各有一份 wrapper。解决统一用根目录的 wrapper删掉子模块里多余的gradle目录。Gradle 多模块构建只认根项目的 wrapper子模块里那份是历史遗留留着只会造成版本混乱。5. 进阶技巧用 init 脚本统一管理 Gradle 7.2 的仓库与缓存5.1 为什么需要 init 脚本内网环境下每个项目的build.gradle都写一遍仓库地址很烦而且容易漏。Gradle 的init.d机制可以在所有构建开始前注入全局配置位置在GRADLE_USER_HOME/init.d/下文件名以.gradle结尾。Gradle 7.2 对这个机制的支持是稳定的优先级高于项目级配置。5.2 写一个内网仓库指向脚本// ~/.gradle/init.d/internal-repo.gradle // 全局替换仓库地址所有项目生效 allprojects { repositories { // 先清掉默认仓库避免走外网 all { ArtifactRepository repo - if (repo instanceof MavenArtifactRepository) { def url repo.url.toString() if (url.startsWith(https://repo1.maven.org) || url.startsWith(https://jcenter.bintray.com)) { remove repo } } } // 指向内网 Maven 镜像 maven { url http://internal-maven.example.com/repository/maven-public/ allowInsecureProtocol true } mavenLocal() } }逻辑说明allprojects块确保对所有模块生效all { }遍历现有仓库并移除公网地址然后追加内网镜像。allowInsecureProtocol true是 Gradle 7.x 的新要求HTTP 仓库不加这行会直接报错这是 7.0 之后的一个硬性变化很多人从 6.x 升上来会踩。参数上注意内网地址换成实际镜像地址mavenLocal()放最后作为兜底。5.3 验证 init 脚本是否生效# 打印生效的仓库列表 ./gradlew buildEnvironment --info | grep -A 5 Repositories # 或者直接跑一个依赖解析任务 ./gradlew :app:dependencies --configuration debugCompileClasspath如果输出里只看到内网地址和 mavenLocal说明脚本生效。如果还有repo1.maven.org检查init.d目录路径和文件后缀。Gradle 7.2 只认.gradle后缀.gradle.kts也支持但语法不同别混用。5.4 缓存迁移的完整流程内网机器没法在线拉依赖需要从有网机器迁移缓存。步骤是在有网机器上跑一次完整构建然后把~/.gradle/caches/modules-2整个目录打包拷到内网机器的GRADLE_USER_HOME/caches/下。注意modules-2里的文件路径带哈希不能手动改直接整目录搬。迁移后第一次构建加--offline参数验证./gradlew assembleDebug --offline --stacktrace如果报No cached version available for offline mode说明某个依赖没进缓存回有网机器补跑一次对应模块的构建。这个流程我走过好几次最深的教训是缓存迁移前一定要在有网机器上把所有变体的构建都跑一遍debug和release的依赖树不完全一样只跑debug到了内网跑release就翻车。从那以后我每次迁移缓存都强制走一遍assembleDebug加assembleRelease确认两个都过了再打包。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 20:06:17 · 阅读 1.2k gradle-7.2-all.zip 离线配置与 Android 构建实战指南
简介gradle-7.2-all.zip 是 Gradle 7.2 版本的完整发行包面向使用 Android Studio 进行 Java、Android 及多语言项目开发的工程师尤其适合网络环境不稳定、在线下载 Gradle 速度过慢的开发者用于离线安装与本地构建环境配置。压缩包整体约 149.73MB内含 Gradle 运行时、库文件及相关工具等完整组件解压后可在 Android Studio 中指定本地 Gradle 路径从而加快项目编译速度。该版本在依赖管理、多项目构建、自定义构建逻辑与插件支持方面表现成熟是 Android 项目编译、打包与依赖管理的重要基础工具。目前已有 1466 人学习下载适合需要稳定构建环境、希望避免网络问题导致编译延迟的 Android 开发者参考使用。1. 从一次构建卡死说起gradle-7.2-all.zip 到底解决什么问题如果你在 Android Studio 里遇到过Could not resolve all dependencies或者 Gradle 同步卡在Download https://services.gradle.org/distributions/gradle-7.2-all.zip半小时不动那你大概率已经和这个文件打过照面了。gradle-7.2-all.zip是 Gradle 7.2 发行版中体积最大的一个包和-bin版本的区别在于它额外包含了源码和文档离线环境下能直接查 API 定义不用再跳浏览器。它解决的核心问题就一个让 Android 项目在无外网或弱网环境下完成构建工具链的初始化。适合谁经常在内网环境做 Android 开发的人、需要批量部署 CI 构建节点的运维、以及被公司网络策略卡住下载的移动端工程师。这个包不是可选项是刚需。2. 拆开 gradle-7.2-all.zip目录结构与版本选型逻辑2.1 为什么是 7.2 而不是 7.0 或 8.0Gradle 7.2 在 Android 构建生态里是一个比较稳的锚点。它对应 Android Gradle Plugin 7.0.x 到 7.2.x 的兼容区间再往上走 AGP 8.x 会强制要求 JDK 17很多老项目还在 JDK 11 上跑直接升 8.0 会触发Unsupported class file major version报错。7.2 对 JDK 11 的支持是完整的同时修复了 7.0 里configuration cache在 Android 多模块项目中的几个已知问题。选型时看三个东西AGP 版本、JDK 版本、Kotlin 插件版本。AGP 7.0.4 配 Gradle 7.2 是官方兼容表里明确列出的组合Kotlin 1.5.31 也能正常跑。如果你手里是 AGP 4.2 的老项目那 Gradle 7.2 可能偏高需要先升 AGP。2.2 all 和 bin 的实质差异-all包比-bin多出约 60MB多出来的部分是src目录下的源码和docs目录下的 DSL 参考。实际构建时两者行为完全一致但调试构建脚本时差别很大。比如你在build.gradle里写了一个自定义 Task运行时抛No such property用-bin只能靠猜用-all可以直接在 IDE 里点进 Gradle API 源码看属性定义。常见做法是CI 节点用-bin省空间开发机用-all方便排查。但内网环境往往只允许传一个包进去那就统一用-all多占点磁盘换排查效率。2.3 解压后的关键目录拿到 zip 之后先别急着配解压看一眼结构unzip gradle-7.2-all.zip -d /opt/gradle ls /opt/gradle/gradle-7.2/输出里会看到bin、lib、src、docs四个主要目录。bin下是gradle和gradle.bat启动脚本lib下是gradle-launcher-7.2.jar等核心 jarsrc是源码docs是 DSL 文档。init.d目录默认不存在需要手动创建后面会用到。参数上注意解压路径不要带空格和中文Gradle 启动脚本对路径里的空格处理在 Windows 上偶发问题Linux 下相对稳但统一用纯英文路径最省心。3. 把 gradle-7.2-all.zip 接进 Android Studio三种落地方式3.1 方式一修改 gradle-wrapper.properties 指向本地文件这是最直接的做法。打开项目根目录下的gradle/wrapper/gradle-wrapper.properties把distributionUrl改成file:///开头的本地路径# 指向本地已解压的 gradle-7.2 目录下的 zip 文件 distributionUrlfile\:///opt/gradle/gradle-7.2-all.zip distributionBaseGRADLE_USER_HOME distributionPathwrapper/dists zipStoreBaseGRADLE_USER_HOME zipStorePathwrapper/dists逻辑说明Gradle Wrapper 会先检查GRADLE_USER_HOME/wrapper/dists下有没有对应版本的解压结果没有才去distributionUrl拉。改成file://后它直接从本地读 zip不再走网络。参数上注意 Windows 路径写法是file\:///D\:/gradle/gradle-7.2-all.zip冒号和斜杠都要转义。这个方式的好处是项目级生效不影响其他项目坏处是每个项目都要改一遍项目多了容易漏。3.2 方式二预置到 GRADLE_USER_HOME 缓存目录更省事的做法是让 Wrapper 以为它已经下载过了。Gradle 的缓存路径规则是~/.gradle/wrapper/dists/gradle-7.2-all/hash/那个hash是根据 distributionUrl 算出来的不能随便编。正确操作是先让 Wrapper 尝试下载一次等它创建好目录结构后中断然后把 zip 丢进去。# 触发目录创建后立即 CtrlC 中断 ./gradlew --version # 找到刚创建的 hash 目录 ls ~/.gradle/wrapper/dists/gradle-7.2-all/ # 把本地 zip 复制进去并解压 cp /opt/gradle/gradle-7.2-all.zip ~/.gradle/wrapper/dists/gradle-7.2-all/hash/ cd ~/.gradle/wrapper/dists/gradle-7.2-all/hash/ unzip gradle-7.2-all.zip # 创建标记文件告诉 Gradle 解压完成 touch gradle-7.2-all.zip.ok逻辑说明hash目录名是 Gradle 内部根据 URL 生成的手动创建容易算错所以用「先触发再替换」的方式最稳。gradle-7.2-all.zip.ok这个空文件是 Gradle 判断解压是否完成的标记缺了它 Wrapper 会重新解压甚至重新下载。参数上注意GRADLE_USER_HOME默认是~/.gradle如果改过环境变量路径要跟着变。这个方式一次配置所有项目通用适合开发机。3.3 方式三Android Studio 全局 Gradle 设置Android Studio 自身有一个 Gradle 配置入口在Settings Build, Execution, Deployment Build Tools Gradle里可以把Gradle user home指到一个自定义目录然后把预置好的wrapper/dists放进去。这个方式适合团队统一环境把配置好的 Gradle home 打包新机器解压即用。但注意 Android Studio 版本不同这个设置项的位置和名称有差异较新版本里叫Gradle JDK和Gradle user home两个独立字段别改错。常见翻车点是改了Gradle user home但没同步迁移旧缓存导致所有依赖重新下载内网环境下直接卡死。4. 避坑与排查gradle-7.2-all.zip 落地时的五个血泪经验4.1 现象解压后执行 gradle 命令报 Permission denied原因zip 包在 Windows 上解压后再传到 Linux或者用某些解压工具时bin/gradle的可执行权限丢失。解决手动补权限。chmod x /opt/gradle/gradle-7.2/bin/gradle chmod x /opt/gradle/gradle-7.2/bin/gradle.bat4.2 现象Android Studio 同步时报 Could not install Gradle distribution原因distributionUrl指向的本地路径里有中文或空格或者file://协议写法不对。解决把 zip 移到纯英文无空格路径下Linux 用file:///opt/...Windows 用file\:///D\:/...注意转义。另外确认 zip 文件本身没损坏用unzip -t测一下。4.3 现象构建时提示 Gradle 版本与 AGP 不兼容原因项目里build.gradle声明的 AGP 版本超出了 Gradle 7.2 的支持范围。解决查兼容表AGP 7.0.x 到 7.2.x 对应 Gradle 7.2 是安全的AGP 7.3 以上需要 Gradle 7.4。改build.gradle里的com.android.tools.build:gradle版本号或者换 Gradle 包。这个坑的隐蔽性在于报错信息不会直接说版本不匹配而是抛一堆NoClassDefFoundError。4.4 现象离线模式下依赖仍然解析失败原因Gradle 7.2 本身离线了但项目依赖的第三方库没进本地 Maven 缓存。解决Gradle 离线只解决构建工具不解决依赖。需要提前把~/.gradle/caches/modules-2/files-2.1下的依赖缓存一起打包迁移或者在settings.gradle里配mavenLocal()并预置本地仓库。常见做法是搭一个内网 Maven 镜像但那是另一个话题了。4.5 现象多模块项目里某个子模块用了不同 Gradle 版本原因子模块的gradle/wrapper/gradle-wrapper.properties没跟着改或者根目录和子目录各有一份 wrapper。解决统一用根目录的 wrapper删掉子模块里多余的gradle目录。Gradle 多模块构建只认根项目的 wrapper子模块里那份是历史遗留留着只会造成版本混乱。5. 进阶技巧用 init 脚本统一管理 Gradle 7.2 的仓库与缓存5.1 为什么需要 init 脚本内网环境下每个项目的build.gradle都写一遍仓库地址很烦而且容易漏。Gradle 的init.d机制可以在所有构建开始前注入全局配置位置在GRADLE_USER_HOME/init.d/下文件名以.gradle结尾。Gradle 7.2 对这个机制的支持是稳定的优先级高于项目级配置。5.2 写一个内网仓库指向脚本// ~/.gradle/init.d/internal-repo.gradle // 全局替换仓库地址所有项目生效 allprojects { repositories { // 先清掉默认仓库避免走外网 all { ArtifactRepository repo - if (repo instanceof MavenArtifactRepository) { def url repo.url.toString() if (url.startsWith(https://repo1.maven.org) || url.startsWith(https://jcenter.bintray.com)) { remove repo } } } // 指向内网 Maven 镜像 maven { url http://internal-maven.example.com/repository/maven-public/ allowInsecureProtocol true } mavenLocal() } }逻辑说明allprojects块确保对所有模块生效all { }遍历现有仓库并移除公网地址然后追加内网镜像。allowInsecureProtocol true是 Gradle 7.x 的新要求HTTP 仓库不加这行会直接报错这是 7.0 之后的一个硬性变化很多人从 6.x 升上来会踩。参数上注意内网地址换成实际镜像地址mavenLocal()放最后作为兜底。5.3 验证 init 脚本是否生效# 打印生效的仓库列表 ./gradlew buildEnvironment --info | grep -A 5 Repositories # 或者直接跑一个依赖解析任务 ./gradlew :app:dependencies --configuration debugCompileClasspath如果输出里只看到内网地址和 mavenLocal说明脚本生效。如果还有repo1.maven.org检查init.d目录路径和文件后缀。Gradle 7.2 只认.gradle后缀.gradle.kts也支持但语法不同别混用。5.4 缓存迁移的完整流程内网机器没法在线拉依赖需要从有网机器迁移缓存。步骤是在有网机器上跑一次完整构建然后把~/.gradle/caches/modules-2整个目录打包拷到内网机器的GRADLE_USER_HOME/caches/下。注意modules-2里的文件路径带哈希不能手动改直接整目录搬。迁移后第一次构建加--offline参数验证./gradlew assembleDebug --offline --stacktrace如果报No cached version available for offline mode说明某个依赖没进缓存回有网机器补跑一次对应模块的构建。这个流程我走过好几次最深的教训是缓存迁移前一定要在有网机器上把所有变体的构建都跑一遍debug和release的依赖树不完全一样只跑debug到了内网跑release就翻车。从那以后我每次迁移缓存都强制走一遍assembleDebug加assembleRelease确认两个都过了再打包。希望帮到你。本文还有配套的精品资源点击获取