Gradle下载与本地配置指南（Android开发环境搭建macOS/Windows通用）

Gradle下载与本地配置指南（Android开发环境搭建macOS/Windows通用）

在Android开发过程中，Gradle的自动下载速度往往让人抓狂。为了提高效率，手动下载Gradle包并在本地配置是每个开发者的必备技能。本文将详细介绍如何在Windows和macOS系统中通过本地方式使用Gradle。

第一步：下载 Gradle 发行版

首先，访问 Gradle 官网或可靠的镜像源，下载对应的 all 或 bin 版本。建议选择 all 版本，因为它包含了文档和源码，方便在 IDE 中查看。

第二步：解压并放置到合适目录

下载完成后，将压缩包解压。建议将其放置在一个不含中文和空格的路径下：

• Windows: 推荐路径如 D:\Android\gradle-x.x
• macOS: 推荐路径如 /Users/你的用户名/opt/gradle

第三步：配置环境变量

配置环境变量后，你可以在终端直接使用 gradle -v 命令。

1. Windows 系统

右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。在系统变量中新建 GRADLE_HOME，值为你的解压路径。然后在 Path 变量中添加 %GRADLE_HOME%\bin。

2. macOS 系统

打开终端，输入 vi ~/.zshrc（或 .bash_profile），添加：
export GRADLE_HOME=/你的路径/gradle-x.x
export PATH=$PATH:$GRADLE_HOME/bin
保存后执行 source ~/.zshrc。

第四步：在 Android Studio 中指定本地 Gradle

这是关键的一步，让你的项目不再去联网下载：

1. 打开 Android Studio，进入 Settings (macOS 为 Preferences)。
2. 依次找到 Build, Execution, Deployment -> Build Tools -> Gradle。
3. 在右侧找到 "Use Gradle from"，选择 'Specified location'。
4. 在下方选择你解压的 Gradle 根目录。
5. 点击 OK，重新同步项目即可。