统信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










