Android Gradle本地使用全攻略（macOS与Windows通用教程）

二、配置环境变量

配置环境变量是Android开发工具本地化的关键。以下是macOS和Windows的通用步骤：

macOS Gradle设置

1. 打开终端，编辑bash配置文件。如果您使用bash，运行：nano ~/.bash_profile；如果使用zsh，运行：nano ~/.zshrc。2. 添加以下行，将路径替换为您的Gradle解压目录：export GRADLE_HOME=/Users/用户名/gradle/gradle-版本号export PATH=$PATH:$GRADLE_HOME/bin3. 保存文件（按Ctrl+O，然后Enter），退出编辑器（按Ctrl+X）。4. 使配置生效：运行source ~/.bash_profile或source ~/.zshrc。

Windows Gradle安装配置

1. 右键点击“此电脑”或“我的电脑”，选择“属性” > “高级系统设置” > “环境变量”。2. 在“系统变量”部分，点击“新建”，变量名输入GRADLE_HOME，变量值输入Gradle解压路径，例如C:\gradle\gradle-版本号。3. 找到“Path”变量，点击“编辑”，添加新条目：%GRADLE_HOME%�in。4. 点击“确定”保存所有更改。这实现了Windows Gradle安装的环境设置。

三、在Android项目中使用本地Gradle

打开Android Studio，进入您的项目。点击“File” > “Settings” (Windows) 或 “Android Studio” > “Preferences” (macOS)，导航到“Build, Execution, Deployment” > “Build Tools” > “Gradle”。在“Gradle user home”字段中，输入您的本地Gradle路径，或使用默认设置。然后，在项目级的gradle/wrapper/gradle-wrapper.properties文件中，将distributionUrl改为本地文件路径，例如：distributionUrl=file:///C:/gradle/gradle-版本号-bin.zip（Windows）或distributionUrl=file:///Users/用户名/gradle/gradle-版本号-bin.zip（macOS）。

四、验证配置

打开终端（macOS）或命令提示符（Windows），运行：gradle -v。如果显示Gradle版本信息，说明macOS Gradle设置和Windows Gradle安装成功。您还可以在Android Studio中构建项目，测试本地Gradle是否正常工作。

五、常见问题与解决

1. 如果命令未找到，请检查环境变量路径是否正确，并重启终端或计算机。2. 确保Gradle版本与Android项目兼容，避免构建错误。3. 在macOS中，如果使用zsh，确保配置文件已正确加载。4. 在Windows中，路径使用反斜杠，并在环境变量中避免空格。

通过本教程，您已学会在macOS和Windows上本地使用Gradle。这能加速Android开发流程，并提高构建稳定性。如有疑问，请参考Gradle官方文档或社区资源。祝您开发顺利！