简介Gradle 8.6 完整发行包面向 Java、Android 与 JVM 生态的开发者、构建工程师及插件作者解决快速获取官方二进制文件并安全升级构建环境的需求。包内含 CLI、Wrapper 脚本、核心库与文档解压后即可体验自定义加密密钥配置缓存、构建初始化脚手架改进、构建创作 API 扩展等关键更新有助于团队在敏感数据保护和合规要求下维持高效构建。资源共 2000 个文件其中 Java 文件 1962 个主要对应 Gradle 源码与类库另有 34 个 properties 配置、3 个 txt 与 1 个 pdf涵盖构建设置与官方说明整体压缩包约 209.99MB。已有 1665 人学习下载适合需要快速搭建最新构建环境、研究 8.6 内部实现或优化现有脚本的开发者可直接用于本地开发、CI 集成及插件扩展等场景。压缩包结构完整、目录清晰便于按模块检索是升级构建工具链的可靠选择。 去年年底我把某个 Android 工程从 Gradle 8.2 升到 8.6为了腾空间顺手清掉了本地的 wrapper 缓存。再次同步时Android Studio 的下载进度又稳稳卡在 gradle-8.6-all.zip 这个文件上十几分钟后直接抛了java.net.SocketTimeoutException。群里几个人同时卡这个包整个上午都在等。后来我把手动下载、镜像替换、本地放置这条链路完整走了一遍问题才算真正解决。这篇文章就是围绕 gradle-8.6-all.zip 的快速下载来写的。如果你正在被 wrapper 下载超时、离线环境装 Gradle、或者每次新建项目都要重新拉发行包这些问题困扰那这篇内容值得看完。我会把下载渠道、放包位置、校验方式以及一些只有踩过坑才懂的经验一次说清楚。1. 为什么 gradle-8.6-all.zip 会成为下载瓶颈1.1 wrapper 自动下载机制是怎么工作的Gradle Wrapper 是 Gradle 官方推荐的项目级构建方式。每个项目里都有gradle/wrapper/gradle-wrapper.properties这个文件里面有一行决定命运的关键配置distributionUrlhttps\://services.gradle.org/distributions/gradle-8.6-all.zipwrapper 在执行时会先检查本地的 Gradle 发行包是否已经存在。判断依据是文件所在目录~/.gradle/wrapper/dists/。如果这个目录下没有对应的 gradle-8.6-all 版本wrapper 就会根据distributionUrl去下载。这个机制本身很成熟坏就坏在distributionUrl默认指向的是官方源而官方源在国内的访问速度向来不太稳定。很多人以为 Gradle 下载慢是依赖下载慢其实完全两码事。依赖走的是 Maven 仓库发行包走的是 services.gradle.org。前者可以配阿里云镜像解决后者需要单独想办法。先把这一层搞清楚后面的问题才有讨论基础。1.2 开发者最常见的三种卡死现场我见过的 wrapper 下载失败基本集中在下面三种情况下载进度条不动0KB/s 持续十几分钟最后超时报SocketTimeoutException。下载到一半中断wrapper 会把未完成的临时文件删除下次同步重新下载反复折腾。下载完整但校验不通过Gradle 认为 zip 文件损坏又删掉重来。这种情况在弱网环境尤其常见。这些问题的根源是wrapper 只认distributionUrl它没有断点续传也没有从本地已有安装包自动导入的能力。也就是说只要官方源那台服务器让你觉得“慢”整个构建流程就卡死在下载这一步。理解了这一点就会明白手动下载 zip 再喂给 wrapper才是目前最可靠的绕行方案。2. 快速拿到 gradle-8.6-all.zip 的三条通路2.1 官方直链链路权威但速度看缘分官方下载地址是这个https://services.gradle.org/distributions/gradle-8.6-all.zip网络环境好的时候用官方源直连是没问题的而且官方 CDN 稳定性最好不会出现文件被缓存成旧版本的问题。但如果你所在网络访问境外资源速度不理想这个链接就派不上用场。我的建议是不把官方源作为国内环境的首选但可以把它当作校验来源配合.sha256文件来验证从其他渠道下载的包是否完整。distributionUrl后面的.sha256文件同样在官方服务器上例如https://services.gradle.org/distributions/gradle-8.6-all.zip.sha256拿到这个文件内容就能对比本地 zip 的哈希值防止从镜像或网盘下载到被篡改或损坏的文件。2.2 国内镜像腾讯 Gradle 镜像的用法与更新节奏国内开发者最常用的做法是改用国内镜像源腾讯云的 Gradle 镜像就是其中比较稳定的一家。镜像目录结构跟官方一致直接拼路径就能得到对应文件https://mirrors.cloud.tencent.com/gradle/gradle-8.6-all.zip使用方式有两种。一种是用浏览器或下载工具手动下载这个 zip另一种是直接改gradle-wrapper.properties把distributionUrl替换成镜像地址distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-8.6-all.zip这样 wrapper 就会直接从腾讯镜像拉包速度通常能跑满带宽。需要注意一点镜像站的版本同步通常比官方晚几天。如果你要的版本太新镜像目录里可能还没有这时可以看看其他云厂商的镜像站有没有同步或者退回到离线包方案。2.3 离线包接力同事、旧缓存、网盘团队内部最省事的方案其实是“离线包接力”。只要有一个人已经成功下载过 gradle-8.6-all.zip整个团队都能跟着受益。具体来说找到那台机器上的这个目录Windows%USERPROFILE%\.gradle\wrapper\dists\gradle-8.6-all\hash\macOS / Linux~/.gradle/wrapper/dists/gradle-8.6-all/hash/把整个目录打包传到共享网盘或者企业内网文件服务器其他人直接下载覆盖到同样的位置。这种方式不依赖公网速度稳定性最高。而且因为 gradle-8.6-all 的 hash 目录是由 distributionUrl 计算出来的同一份配置在不同机器上目录名是一样的所以整目录拷贝后基本开箱即用。3. 把 zip 正确送进 wrapper目录 hash 与放置技巧3.1 dists 目录结构与 hash 命名的来历很多人下载完 gradle-8.6-all.zip随手放在桌面然后跑来问“为什么 Gradle 还是重新下载”。原因很简单wrapper 只认~/.gradle/wrapper/dists/这个缓存目录它不会全局搜索你电脑上的 zip 文件。dists目录的结构长这样~/.gradle/wrapper/dists/gradle-8.6-all/hash/ ├── gradle-8.6-all.zip ├── gradle-8.6-all/ # 解压后的目录 └── gradle-8.6-all.zip.ok # 下载完成标记文件hash这个目录名是 wrapper 根据distributionUrl算出来的不同的 URL 对应不同的目录名。所以千万不要把 gradle-8.6-bin.zip 的内容硬塞到 gradle-8.6-all 的目录里也不要修改 zip 文件名否则 wrapper 依然会认为“缓存不存在”老老实实重新下载。3.2 手动放置 zip 的实操步骤最稳妥的手动放置流程是这样的先正常执行一次./gradlew --version或直接在 Android Studio 里同步让 wrapper 开始下载它会自动创建出gradle-8.6-all/hash目录结构。看到目录出现后立刻取消同步任务或者直接断网让下载失败。把提前下载好的gradle-8.6-all.zip复制到该目录下注意保持文件名完全一致。重新执行./gradlew --versionwrapper 会发现 zip 已经存在跳过下载直接解压。这里有个细节值得说不要自己新建 hash 目录往里放 zip因为一旦 hash 名算错一切都是白费。让 wrapper 自己先建目录是最省心的方法。解压完成后gradle-8.6-all.zip.ok文件会由 Gradle 自动生成不需要手动创建。3.3 用 file:// 指定本地 zip 的替代方案如果不想跟 hash 目录较劲还有一条更直接的路把distributionUrl指向本地文件。在 Windows 上可以写成distributionUrlfile\:///D:/gradle/gradle-8.6-all.zipmacOS / Linux 上写成distributionUrlfile\:///Users/me/gradle/gradle-8.6-all.zip这样 wrapper 会直接从本地 zip 安装完全不经过网络。这个方案在单机环境非常实用但有一个明显的坑一旦这个 zip 文件被移动或删除构建立刻失效。如果项目是多人协作gradle-wrapper.properties通常要提交到 Git写死个人路径会影响其他人。所以我的建议是file://适合个人机器或离线环境团队项目还是统一用国内镜像 URL 更稳妥。4. 实战验证镜像加速方案的 Windows / macOS 操作记录4.1 Windows 下手动下载与放置记录我在 Windows 上的操作步骤基本固定。先用 curl 从腾讯镜像把包拉下来curl -L -o gradle-8.6-all.zip https://mirrors.cloud.tencent.com/gradle/gradle-8.6-all.zip下载完成后先运行一次gradlew.bat --version让它创建好 wrapper 目录然后打开目录explorer %USERPROFILE%\.gradle\wrapper\dists\gradle-8.6-all把刚下载的 zip 复制到对应 hash 目录里。再跑一次gradlew.bat --version观察输出正常情况下会直接显示 Gradle 8.6 的版本信息。整个过程下来速度取决于镜像带宽比官方源动辄几分钟超时强太多了。一个小经验Windows 下解压后会有路径过长的问题。如果项目路径本身很深加上.gradle缓存目录很容易触发路径长度限制。建议把 Gradle 用户目录改到短路径下比如D:\gradle-cache办法是在gradle.properties里设置gradle.user.homeD:/gradle-cache。4.2 macOS / Linux 下的差异点macOS 和 Linux 上流程基本一致只是命令稍有不同。下载cd ~/Downloads curl -L -O https://mirrors.cloud.tencent.com/gradle/gradle-8.6-all.zip然后让 wrapper 先建目录cd /path/to/your/project ./gradlew --version等待目录出现后把 zip 放进~/.gradle/wrapper/dists/gradle-8.6-all/hash/。macOS 用户要留意一个问题如果是从别人那里拷贝过来的缓存目录解压后的gradle-8.6-all/bin/gradle可能没有执行权限需要手动加上chmod x ~/.gradle/wrapper/dists/gradle-8.6-all/*/gradle-8.6-all/bin/gradle这个问题在 Windows 上不存在但在 Linux 和 macOS 下非常常见尤其是用网盘或压缩包接力分发时。4.3 构建是否真正离线通过的判断方法如何确认这次构建真的没有走网络下载看两点就够了第一执行./gradlew --version时输出速度应当很快没有长时间的“Downloading”日志。第二观察dists/gradle-8.6-all/hash/目录下gradle-8.6-all.zip.ok文件是否已生成。如果你改了distributionUrl走本地file://注意 Gradle 8.6 的日志里会显示类似 “Using local distribution” 的信息。如果没看到这行却也没卡那多半是走了缓存目录效果是一样的。判断标准只有一个有没有真的构建通过。5. 配套校验和版本匹配SHA256、AGP 8.4 与镜像误区5.1 SHA256 校验不是可选项手动下载 Gradle 发行包最怕下到半截文件损坏的包。官方提供了.sha256文件校验起来并不麻烦。Linux / macOS 上这样校验shasum -a 256 gradle-8.6-all.zipWindows 上这样校验certutil -hashfile gradle-8.6-all.zip SHA256然后对比官方.sha256文件的内容。如果完全一致就放心放入 wrapper 目录。有人觉得多此一举但 Gradle 发行包体积不小在弱网条件下下载很容易出现字节不对齐的情况。而 wrapper 解压一个损坏的 zip 时报错信息往往很含糊排查成本远高于提前校验的几秒钟。5.2 Gradle 8.6 与 AGP、JDK 的版本关系Gradle 8.6 是 2024 年初的版本和 Android 生态配套关系是这样的AGP 8.4 的最低 Gradle 版本要求正是 8.6。如果你的项目用的是 AGP 8.4 及更高版本wrapper 里的distributionUrl配置成 gradle-8.6-all.zip 是正确选择。在 JDK 方面Gradle 8.6 支持运行在 Java 8 到 Java 21 之间。这里的“支持”指的是 Gradle 自己可以跑在这些 JVM 上但如果你的项目设置了较高的 toolchain比如 Java 21那构建时仍会去下载对应的 JDK。Android Studio 项目通常用内置 JBR问题不大但纯 Java 项目就要注意 toolchain 配置和本地 JDK 是否匹配。5.3 发行包镜像和依赖仓库镜像是两回事最后必须强调一个容易被搞混的概念Gradle 发行包镜像 ≠ Maven 依赖镜像。很多人给项目配置了阿里云 Maven 仓库依赖下载确实快了但 wrapper 下载发行包时依然很慢于是会觉得“镜像没生效”。其实两个是不同层级的东西Gradle 发行包 zip由 wrapper 从distributionUrl下载需要配置腾讯云、华为云等提供 Gradle 目录的镜像。项目依赖 jar 包由依赖仓库下载需要配置 Maven Central、Google 等仓库的国内镜像比如阿里云 Maven。缺了前者Gradle 本身装不上缺了后者项目依赖拉不下来。很多从零开始的报错比如“Could not install Gradle distribution from ...”本质都是前者没配置好。把这两层分开想定位问题会快很多。以我现在的习惯新项目一律把gradle-wrapper.properties里的distributionUrl换成腾讯镜像地址同时在本地备份一份常用版本的 gradle-8.6-all.zip无论是断网、换机器还是同事求助都能在两三分钟内恢复环境。以后如果再看到有人被 Gradle 发行包下载卡住先别急着怀疑 Gradle 本身检查一下它到底是从哪个源下答案往往就在那一行 URL 里。本文还有配套的精品资源点击获取
