Java编译Ubuntu如何使用Gradle

在动手使用 Gradle 之前，得先确认一件事：你的系统里是否已经装好了 Ja va 开发工具包（JDK）。毕竟 Gradle 本身就是跑在 JVM 上的，没有 JDK 一切都无从谈起。建议确保 JDK 8 或更高版本已经就绪，可以通过 ja va -version 和 ja vac -version 两条命令快速验证一下。如果还没安装，别担心，用 Ubuntu 的包管理器就能搞定。

sudo apt update
sudo apt install openjdk-11-jdk

第一步：在 Ubuntu 上安装 Gradle

安装 Gradle 有两条路可以走：用包管理器安装，省心省力；或者手动安装，适合想要掌控特定版本的朋友。两种方式都可以，看你的习惯和需求来选。

方式 A：通过 Ubuntu 包管理器安装（推荐）

这种方式最直接，几步就能搞定：

1. 先添加 Gradle 的官方仓库和 GPG 密钥：

sudo apt update
wget -qO - https://packages.gradle.org/gpg | sudo apt-key add -
sudo sh -c 'echo "deb https://packages.gradle.org/distributions/ gradle/$(curl -s https://packages.gradle.org/distributions/latest/release)" > /etc/apt/sources.list.d/gradle.list'
sudo apt update

2. 然后直接安装：

sudo apt install gradle

方式 B：手动安装（指定版本）

如果你对版本有特别的要求，或者想用最新的发布版，手动安装会更灵活一些：

1. 先去 Gradle 官网下载你需要的二进制包。
2. 解压到指定目录，比如 ~/gradle：

unzip gradle-x.y.z-bin.zip -d ~/gradle

3. 最后把 Gradle 添加到系统的 PATH 环境变量中：

echo "export PATH=$HOME/gradle/gradle-x.y.z/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

第二步：验证安装是否成功

装完之后，在终端里跑一下 gradle -v 命令。如果能顺利看到 Gradle 的版本号、JVM 的详细信息以及操作系统信息，那就说明安装已经稳稳当当地完成了。

第三步：创建或初始化一个 Ja va 项目

项目初始化有两条常见的路：手动搭建目录结构，或者直接用 Gradle 自带的 init 任务。

方式 A：手动搭建项目结构

这种方式适合对项目结构有清晰认知的朋友，自己动手，心里有数：

mkdir my-ja va-project
cd my-ja va-project
mkdir -p src/main/ja va src/test/ja va

方式 B：使用 Gradle Init 初始化

如果不想折腾目录结构，直接在空目录里执行 gradle init，然后根据提示选择即可。系统会让你选择项目类型，选“Ja va application”之后，它会自动生成 build.gradle 文件和必需的目录结构，省时省力。

mkdir my-ja va-project
cd my-ja va-project
gradle init

第四步：配置 build.gradle

无论是手动创建还是通过初始化生成，你都需要编辑 build.gradle 文件来定义项目的设置、依赖和任务。对于一个最基础的 Ja va 项目来说，以下三个要素是必不可少的：

• Ja va 插件：提供编译、打包等一系列核心任务。
• 仓库声明：比如 Ma ven Central，用来下载依赖的库。
• 主类声明：如果你想让项目能运行并生成可执行的 JAR 文件，这一项必须指定。

来看一个典型的 build.gradle 示例：

plugins {
    id 'ja va'          // 提供 Ja va 编译、测试、打包等任务
    id 'application'   // 提供运行和打包应用程序的任务
}

group = 'com.example'       // 项目组名（类似于包名）
version = '1.0-SNAPSHOT'    // 项目版本号

repositories {
    ma venCentral()          // 使用 Ma ven Central 仓库来解析依赖
}

dependencies {
    // 在这里声明你的项目依赖
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}

application {
    mainClass = 'com.example.Main'  // 主类的完整限定名
}

test {
    useJUnitPlatform()              // 使用 JUnit 5 进行测试
}

第五步：编译 Ja va 项目

一切配置就绪后，进入项目根目录，执行 gradle build 命令。这个命令会一气呵成地完成三件事：

1. 从配置的仓库中下载项目依赖（如果有的话）。
2. 编译 src/main/ja va 目录下的 Ja va 代码。
3. 运行 src/test/ja va 目录下的单元测试。
4. 将编译后的类文件打包成一个 JAR 文件，存放在 build/libs/ 目录下，文件名一般是 项目名-版本号.jar 的格式。

第六步：运行编译后的项目

运行项目有两种常见姿势。如果你在 build.gradle 中配置了 application 插件，直接用 gradle run 是最简单的办法。当然，你也可以直接使用 ja va -jar 命令来运行打包好的 JAR 文件：

# 方式一：使用 Gradle 的 run 任务（更简单）
gradle run

# 方式二：直接运行 JAR 文件
ja va -jar build/libs/my-ja va-project-1.0-SNAPSHOT.jar

额外建议：使用 Gradle Wrapper 保证可复现性

如果项目需要多人协作或者需要长期维护，强烈建议使用 Gradle Wrapper。它包含 gradlew（Linux/macOS）和 gradlew.bat（Windows）两个脚本，能确保所有人使用完全一致的 Gradle 版本，即使系统里没有安装 Gradle 也能正常工作。

在项目根目录执行以下命令即可生成：

gradle wrapper --gradle-version 8.5
# 将 8.5 替换为你想要的版本号

生成之后，直接用 ./gradlew 替代全局的 gradle 命令就行：

./gradlew build      # Linux/macOS
./gradlew.bat build  # Windows

这样一来，版本一致性问题就彻底解决了，项目的构建环境也变得更加可靠。