必须手动安装最新gradle（如8.15），因apt源版本过旧导致android项目报错；需下载bin.zip、解压至/opt/gradle/、配置gradle_home与path、设置腾讯镜像wrapper及阿里云插件/依赖源。

直接用 apt 装的 Gradle 不能用，版本太旧（Ubuntu 22.04 源里还是 7.4，24.04 也只到 8.2），Android 项目或新插件会报 Unsupported gradle version 错误。必须手动安装最新稳定版。

下载解压到 /opt/gradle

选 bin.zip（不是 src.zip 或 all.zip），解压后目录结构要干净：比如 /opt/gradle/gradle-8.15 下直接有 bin/、lib/ 等子目录，不要多套一层文件夹。

• 用腾讯镜像加速下载：wget https://mirrors.cloud.tencent.com/gradle/gradle-8.15-bin.zip
• 解压到统一位置：sudo unzip gradle-8.15-bin.zip -d /opt/gradle/
• 确认权限：sudo chown -R $USER:$USER /opt/gradle/gradle-8.15（避免后续构建时因权限被拒绝）

配置 GRADLE_HOME 和 PATH

改的是当前用户环境变量，别去动 /etc/profile —— 那样会影响所有用户，且 Android Studio 启动时不一定加载它。

Ubuntu 26.04

Ubuntu 26.04 LTS（代号“Resolute Raccoon”）是Canonical于2026年4月23日发布的下一代长期支持版操作系统，提供长达10年的技术支持。它搭载Linux 7.0内核与GNOME 50桌面环境，全面转向Wayland协议，并引入Rust重写的核心工具以增强安全性。官方提供适用于AMD64和ARM64架构的桌面及服务器ISO镜像，是追求前沿技术与极致稳定的开发者

下载

• 编辑 ~/.bashrc 或 ~/.zshrc（看你终端用哪个 shell）
• 末尾加两行：

  export GRADLE_HOME=/opt/gradle/gradle-8.15
  export PATH=$PATH:$GRADLE_HOME/bin

• 立即生效：source ~/.bashrc（或 source ~/.zshrc）

验证并配国内镜像（关键一步）

只跑 gradle -v 成功不代表能用——没镜像的话，首次构建会卡在下载 gradle-wrapper.jar 或依赖上，超时失败。

• 验证基础安装：gradle -v 应输出带 Build time 的完整信息
• 为 wrapper 配镜像：编辑项目根目录下的 gradle/wrapper/gradle-wrapper.properties，把 distributionUrl 改成：

  distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.15-bin.zip

• 为构建配镜像：在项目根目录的 settings.gradle 里，确保 pluginManagement 和 dependencyResolutionManagement 块都用了阿里云源：

  pluginManagement {
      repositories {
          maven { setUrl("https://maven.aliyun.com/repository/public") }
          mavenCentral()
      }
  }
  dependencyResolutionManagement {
      repositories {
          maven { setUrl("https://maven.aliyun.com/repository/public") }
          mavenCentral()
      }
  }

最容易被忽略的是 settings.gradle 中 pluginManagement 必须放在最顶部，否则插件仓库不生效，IDEA 导入时直接报 Could not resolve plugin；另外，如果之前用过旧 Gradle，记得删掉项目下的 .gradle 缓存目录再重试。