gradle的安装指南和基本使用

官网安装包 https://gradle.org/releases/

gradle的安装指南

在linux安装

先决条件

已安装 JDK/JRE（版本 7 或以上）,在命令行输入：

java -version  

可查询当前已安装的版本

下载安装包，解压，自定义安装目录

wget https://downloads.gradle.org/distributions/gradle-4.6-bin.zip

unzip -d /opt/gradle gradle-4.6-bin.zip 

配置环境

vim /etc/profile

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

#刷新环境变量
source /etc/profile

校验安装结果

gradle --version 

在windows安装

先决条件

已安装 JDK/JRE（版本 7 或以上），这里是 Win10 系统 在命令行输入：java -version 可查询当前电脑已安装的版本

下载

从 Gralde 官方网站下载 Gradle 的最新发行包。

解压，自定义安装目录

Gradle 发行包是一个 ZIP 文件。完整的发行包包括以下内容(官方发行包有 full 完整版，也有不带源码和文档的版本，可根据需求下载): ● Gradle 可执行文件 ● 用户手册 (有 PDF 和 HTML 两种版本) ● DSL 参考指南 ● API 手册(Javadoc 和 Groovydoc) ● 样例，包括用户手册中的例子，一些完整的构建样例和更加复杂的构建脚本 ● 源代码。仅供参考使用,如果你想要自己来编译 Gradle 你需要从源代码仓库中检出发行版本源码，具体请查看 Gradle 官方主页。 下载后，解压放到一个单独的文件夹

配置环境变量

运行 gradle 必须将 GRADLE_HOME/bin 加入到你的 PATH 环境变量中，GRADLE_HOME为gradle的安装目录。

GRADLE_HOME  //系统环境 gradle的安装根目录

%GRADLE_HOME%/bin  //path环境 

测试安装

运行如下命令来检查是否安装成功.该命令会显示当前的 JVM 版本和 Gradle 版本。

gradle -v

gradle的基本使用

创建新项目

gradle init 初始化新项目

你可以使用 gradle init 命令来初始化一个新的 Gradle 项目。这将引导你完成项目的初始化过程，并生成必要的文件和目录结构。

bash
gradle init --type java-application

这会创建一个简单的 Java 应用程序项目，包括以下内容：

• build.gradle：项目的主要构建脚本。
• settings.gradle：项目设置文件。
• src/main/java：源代码目录。
• src/test/java：测试代码目录。

编写 build.gradle 文件

在 build.gradle 文件中定义项目的依赖关系、插件和其他配置。以下是一个简单的示例：

groovy
plugins {
    id 'java'
    id 'application'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.slf4j:slf4j-api:1.7.30'
    testImplementation 'junit:junit:4.13'
}

application {
    mainClassName = 'com.example.Main'
}

• plugins：指定要使用的插件，例如 java 和 application 插件。
• repositories：指定依赖项的仓库位置，这里是 Maven Central。
• dependencies：列出项目所需的依赖项。
• application：配置应用程序的主类。

运行任务

Gradle 提供了许多内置任务，你可以通过以下命令查看所有可用的任务：

bash
gradle tasks

常用的任务包括：

• 构建项目：

bash
gradle build

这将编译源代码、运行测试并打包项目。

• 运行应用程序： 如果你使用了 application 插件，可以运行以下命令来启动应用程序：

bash
gradle run

• 清理构建输出：

bash
gradle clean

• 运行测试：

bash
gradle test

添加依赖项

在 build.gradle 文件中的 dependencies 块中添加依赖项。例如，添加 JUnit 测试框架：

groovy
dependencies {
    testImplementation 'junit:junit:4.13'
}

然后运行 gradle build 或 gradle test 来下载依赖项并执行相应的任务。

使用 Gradle Wrapper

Gradle Wrapper 是一个脚本，它可以确保在不同的开发环境中使用相同的 Gradle 版本。它通常包含在项目中，并且不需要开发者手动安装 Gradle。

初始化 Gradle Wrapper

如果你已经有一个 Gradle 项目，可以通过以下命令生成 Gradle Wrapper：

bash
gradle wrapper

这会在项目根目录下生成以下文件：

• gradlew：Unix shell 脚本。
• gradlew.bat：Windows 批处理脚本。
• gradle/wrapper/gradle-wrapper.jar：Wrapper 的 JAR 文件。
• gradle/wrapper/gradle-wrapper.properties：Wrapper 配置文件。

使用 Gradle Wrapper 构建项目

使用生成的 Wrapper 脚本来执行 Gradle 任务：

bash
./gradlew build

或者在 Windows 上：

bash
gradlew.bat build

gradle项目示例

假设我们创建了一个简单的 Java 应用程序项目，其结构如下：

my-app/
├── build.gradle
├── settings.gradle
└── src
    ├── main
    │   └── java
    │       └── com
    │           └── example
    │               └── Main.java
    └── test
        └── java
            └── com
                └── example
                    └── MainTest.java

build.gradle 文件内容：

groovy
plugins {
    id 'java'
    id 'application'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.slf4j:slf4j-api:1.7.30'
    testImplementation 'junit:junit:4.13'
}

application {
    mainClassName = 'com.example.Main'
}

Main.java 文件内容：

java
package com.example;

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

MainTest.java 文件内容：

java
package com.example;

import org.junit.Test;
import static org.junit.Assert.*;

public class MainTest {
    @Test
    public void testMain() {
        assertTrue(true);
    }
}

接下来，你可以使用以下命令构建和运行项目：

bash
./gradlew build
./gradlew run

这些是 Gradle 的一些基本使用方法。通过 Gradle，你可以更高效地管理和构建 Java 或 Kotlin 项目，同时利用其强大的依赖管理和任务系统。

参考资料
来自ai生成