统信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域名。
