上一篇
Linux如何安装Gradle?
- Linux
- 2025-06-10
- 2338
在Linux安装Gradle需:从官网下载二进制压缩包,解压到目标目录(如
/opt/gradle
),最后将
bin
子目录路径添加到系统的
PATH
环境变量中即可。
Gradle简介
Gradle是一款基于JVM的自动化构建工具,支持Java、Kotlin、Android等项目,以灵活性和高性能著称,在Linux系统中安装Gradle是开发环境配置的关键步骤,本文将提供三种主流安装方法,涵盖APT包管理、SDKMAN工具和手动安装,确保过程安全可靠。
方法1:通过SDKMAN安装(推荐)
适用场景:多版本管理、便捷升级
步骤:
- 安装SDKMAN
打开终端,执行:curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"
- 安装Gradle
sdk install gradle 8.5 # 安装指定版本(示例为8.5)
- 验证安装
gradle -v # 输出版本信息即成功
优势:自动配置环境变量,支持一键切换版本(
sdk use gradle <版本号>
)。
方法2:APT包管理器安装(Ubuntu/Debian)
适用场景:快速部署稳定版
步骤:
- 更新仓库并安装
sudo apt update sudo apt install gradle
- 验证安装
gradle -v # 检查版本
注意:APT仓库版本可能较旧,如需最新版请选其他方法。
方法3:手动安装(通用所有Linux发行版)
适用场景:自定义版本、控制安装路径
步骤:
- 下载Gradle二进制包
访问 Gradle官网Release页,复制所需版本的二进制包链接(如gradle-8.5-bin.zip
)。
终端执行:wget https://services.gradle.org/distributions/gradle-8.5-bin.zip
- 解压并移动
sudo unzip gradle-8.5-bin.zip -d /opt # 解压到/opt目录
- 配置环境变量
编辑用户配置文件:nano ~/.bashrc # 或 ~/.zshrc(Zsh用户)
在文件末尾添加:
export PATH=$PATH:/opt/gradle-8.5/bin
保存后激活配置:
source ~/.bashrc
- 验证安装
gradle -v # 显示版本号即成功
安全与最佳实践
- 校验文件完整性(手动安装时必做)
- 下载同版本的
.zip.sha256
校验文件 - 终端执行:
echo "$(cat gradle-8.5-bin.zip.sha256) gradle-8.5-bin.zip" | sha256sum --check
输出
OK
表示文件未被改动。
- 下载同版本的
- 权限管理
- 避免使用
root
运行Gradle任务,通过sudo chown -R $USER:$USER /opt/gradle-8.5
赋予用户权限。
- 避免使用
- 版本选择建议
- 生产环境选择LTS版本,开发环境可尝鲜最新版。
常见问题解决
gradle: command not found
检查环境变量路径是否正确,确保/opt/gradle-*/bin
已加入PATH
。- 构建速度慢
配置Gradle守护进程:在~/.gradle/gradle.properties
中添加org.gradle.daemon=true
。
引用说明
本文参考以下权威来源:
- Gradle官方安装指南:Gradle Installation Docs
- SDKMAN官方文档:SDKMAN Usage
- Linux基金会安全实践:Linux Security Basics
通过上述任一方法完成安装后,即可使用
gradle init
创建新项目,定期运行sdk update gradle
(SDKMAN用户)或手动下载新版覆盖旧目录,保持工具更新。