统信UOS上需安装Gradle:推荐APT一键安装(sudo apt install gradle)并验证gradle -v;若需高版本(如8.5+),可手动下载配置或用SDKMAN!管理;建议配置阿里云Maven镜像加速依赖拉取。

您在统信UOS上执行gradle命令时提示“command not found”,说明系统未安装Gradle构建工具,而Android项目、Kotlin多平台或Spring Boot工程均依赖它完成依赖解析、编译与打包流程。
通过APT仓库一键安装(推荐)
该方式适配统信UOS官方源,自动解决依赖,安装后即可直接使用gradle命令,无需额外配置环境变量。
打开终端,执行软件源更新:sudo apt update
安装Gradle主程序包:sudo apt install gradle
验证安装结果:运行gradle -v,输出应包含Gradle版本号(如8.4)、JVM路径及默认JDK版本;若提示“no such file”,请确认已安装OpenJDK 17并设为系统默认Java环境。
手动下载并配置指定版本Gradle
当项目强制要求Gradle 8.5+(如启用Java 21预览特性)或需规避APT源中旧版(如UOS默认仅提供7.4)时,必须手动安装。
方法一:使用curl从清华镜像站下载(国内加速)
执行命令:curl -L https://mirrors.tuna.tsinghua.edu.cn/gradle/gradle-8.5-bin.zip -o /tmp/gradle-8.5-bin.zip
解压至/opt目录:sudo unzip /tmp/gradle-8.5-bin.zip -d /opt/
配置全局环境变量:编辑/etc/profile,追加以下两行
export GRADLE_HOME=/opt/gradle-8.5
export PATH=$GRADLE_HOME/bin:$PATH
使配置立即生效:source /etc/profile
方法二:使用SDKMAN!(适合多版本共存场景)
先安装SDKMAN!:curl -s "https://get.sdkman.io" | bash,然后按提示执行source "$HOME/.sdkman/bin/sdkman-init.sh"
再安装Gradle:sdk install gradle 8.5
切换版本:sdk use gradle 8.5
配置阿里云Maven镜像加速Gradle依赖拉取
Gradle本身不内置镜像配置,但其构建过程大量依赖Maven中央仓库,国内直连极慢甚至超时。此步骤非安装必需,但不配置将导致build卡在“Resolving dependencies”数分钟。
创建Gradle初始化脚本:mkdir -p ~/.gradle/init.d
新建镜像配置文件:nano ~/.gradle/init.d/mirror.gradle
粘贴以下内容并保存:
allprojects {
repositories {
// 移除默认Maven Central
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/central' }
mavenLocal()
}
}
注意:该文件名必须以.gradle结尾,且位于init.d目录下,否则Gradle启动时不会加载。
验证镜像生效:进入任意含build.gradle的项目,执行gradle build --refresh-dependencies,观察日志中下载URL是否已变为aliyun.com域名。











