统信UOS中需手动安装Gradle 7.5并配置系统级环境变量：下载解压至/opt/gradle/gradle，设置GRADLE_HOME、PATH和GRADLE_USER_HOME，source /etc/profile后执行gradle -v验证；APT安装版本过旧，不推荐用于Android项目。

如果您在统信UOS系统中需要构建Java或Android项目，但终端提示 gradle: command not found，则说明Gradle尚未安装或环境变量未正确配置。以下是针对统信UOS系统的Gradle安装与配置步骤：

一、下载并解压Gradle二进制包

Gradle官方提供预编译的All Distribution压缩包，包含全部文档与示例，适用于离线环境与完整开发需求。必须使用Linux兼容的.tar.gz或.zip格式，不可使用Windows专用安装器。

1、打开终端，创建统一安装目录：
sudo mkdir -p /opt/gradle

2、进入该目录：
cd /opt/gradle

3、下载Gradle 7.5完整版（稳定兼容UOS及Android Gradle Plugin 7.x–8.x）：
sudo wget https://downloads.gradle-dn.com/distributions/gradle-7.5-all.zip

4、解压并重命名为gradle：
sudo unzip gradle-7.5-all.zip
sudo mv gradle-7.5-all gradle

二、配置系统级环境变量

为所有用户（包括后续新建用户）启用Gradle命令，需修改全局shell配置文件。UOS默认使用bash，且推荐采用系统级配置以避免普通用户手动重复设置。

1、编辑全局profile文件：
sudo vim /etc/profile

2、在文件末尾追加以下三行（注意路径与权限一致性）：
export GRADLE_HOME=/opt/gradle/gradle
export PATH=$PATH:$GRADLE_HOME/bin
export GRADLE_USER_HOME=/opt/gradle/.gradle

3、使配置立即生效：
source /etc/profile

三、验证安装结果

环境变量生效后，终端可直接调用gradle命令；版本输出将确认JVM兼容性、Gradle内核版本及Groovy运行时信息，是判断安装成功的唯一权威依据。

1、执行版本检查：
gradle -v

2、确认输出中包含以下关键字段：
Gradle 7.5
Kotlin: 1.6.10
Groovy: 3.0.10
Ant: Apache Ant(TM) version 1.10.11
JVM: 11.0.21 (Ubuntu)

四、替代方案：通过APT源安装（仅限基础功能）

UOS社区仓库提供gradle包，但版本陈旧（通常为6.x），不支持Android Studio Flamingo及以上所需AGP 8.0+，仅适用于纯Java库构建或教学演示场景。

1、更新软件源索引：
sudo apt update

2、安装开源打包版Gradle：
sudo apt install gradle

3、检查安装路径与版本：
which gradle
gradle --version

4、注意：该方式安装的Gradle无GRADLE_HOME环境变量，且gradle wrapper生成的wrapper.jar可能因版本不匹配而失败，不建议用于Android项目。

五、权限与路径安全加固

UOS默认启用严格文件权限策略。若后续执行gradle build出现Permission denied或Could not create service of type ScriptPluginFactory错误，需确保Gradle主目录归属root且具备可执行权限。

1、修正/opt/gradle目录所有权：
sudo chown -R root:root /opt/gradle

2、设置gradle主目录为755权限：
sudo chmod 755 /opt/gradle/gradle

3、确保bin子目录及其可执行文件具备x权限：
sudo chmod 755 /opt/gradle/gradle/bin/gradle
sudo chmod 755 /opt/gradle/gradle/bin/gradle.bat