Maven и Gradle: сборка проекта

До сих пор каждая программа была одним файлом Main.java, который запускался командой java Main.java. В настоящем проекте — сотни классов, десятки внешних библиотек (JSON, драйвер базы данных, фреймворк для тестов) и несколько разработчиков. Скачивать каждый JAR-файл вручную и передавать javac длинный список -cp быстро становится кошмаром. Эту работу выполняют системы сборки (build tools): Maven и Gradle сами скачивают библиотеки, компилируют код, запускают тесты и упаковывают готовый JAR-файл.

Стандартная структура проекта

Maven следует принципу «соглашения важнее конфигурации» (convention over configuration): файлы всегда лежат в одних и тех же местах, поэтому не нужно объяснять инструменту, где их искать. Gradle использует ту же структуру. Основной код находится в src/main/java, тесты — в src/test/java, а файлы настроек и изображения — в src/main/resources. Имя пакета превращается в папки: пакет com.educora — это папка com/educora. Результат сборки попадает в target/ у Maven и в build/ у Gradle.

grade-book/
├── pom.xml                  ← Maven (Gradle: build.gradle.kts)
├── src/
│   ├── main/
│   │   ├── java/com/educora/App.java
│   │   └── resources/config.properties
│   └── test/
│       └── java/com/educora/AppTest.java
└── target/                  ← build output (Gradle: build/)

Maven и pom.xml

Сердце проекта Maven — файл **pom.xml (Project Object Model). В нём записаны координаты самого проекта, версия Java и список зависимостей. В файле ниже две зависимости: Gson для работы с JSON и JUnit для тестов. Библиотеки, которые нужны им самим, — транзитивные зависимости** — Maven скачивает автоматически.

<project xmlns="http://maven.apache.org/POM/4.0.0">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.educora</groupId>
  <artifactId>grade-book</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>

  <properties>
    <maven.compiler.release>21</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.11.0</version>
    </dependency>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
      <version>5.11.0</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

Обрати внимание на строку <scope>test</scope>: JUnit нужен только в тестах и не должен попасть в готовую программу. Область (scope) определяет, где можно использовать зависимость:

Жизненный цикл Maven

В Maven команды — это фазы жизненного цикла, которые идут в строгом порядке. Вызывая фазу, Maven выполняет и все фазы перед ней: mvn package сначала проверяет проект, компилирует его и запускает тесты, и только потом создаёт JAR. Если хоть один тест упал, сборка останавливается — код с ошибкой не упаковывается. clean — отдельная фаза: она удаляет старую папку target/.

mvn clean package

[INFO] Scanning for projects...
[INFO] Building grade-book 1.0.0
[INFO] --- compiler:3.13.0:compile (default-compile) @ grade-book ---
[INFO] --- surefire:3.2.5:test (default-test) @ grade-book ---
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
[INFO] --- jar:3.4.1:jar (default-jar) @ grade-book ---
[INFO] Building jar: C:\projects\grade-book\target\grade-book-1.0.0.jar
[INFO] BUILD SUCCESS

Gradle и build.gradle.kts

Gradle делает ту же работу, но вместо XML использует скрипт, похожий на программный код. В современных проектах скрипт пишут на Kotlin — build.gradle.kts (в старых проектах встретится и build.gradle на Groovy). Вместо фаз у Gradle задачи (tasks): compileJava, test, jar, build. Gradle не пересобирает то, что не изменилось, и кэширует результаты, поэтому в больших проектах он обычно быстрее Maven. Android-приложения тоже собираются с помощью Gradle.

plugins {
    application
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("com.google.code.gson:gson:2.11.0")
    testImplementation("org.junit.jupiter:junit-jupiter:5.11.0")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

application {
    mainClass = "com.educora.App"
}

tasks.test { useJUnitPlatform() }

Плагин application добавляет задачу ./gradlew run: она запускает класс из mainClass вместе со всеми библиотеками. Блок toolchain велит Gradle собирать проект именно на Java 21. Сравни ручную сборку и Gradle:

# download every JAR by hand into lib/, then:
javac -d out -cp lib/gson-2.11.0.jar src/com/educora/*.java
java -cp "out:lib/gson-2.11.0.jar" com.educora.App
# a new library? download it, fix both commands again...

# dependencies are listed once in build.gradle.kts
./gradlew build   # download, compile, test, package
./gradlew run     # start the app with all its libraries

Создай проект шаг за шагом

1. 1
   Проверь JDK

   Набери в терминале java -version: версия должна быть 21 или новее.

2. 2
   Создай проект

   В IntelliJ IDEA выбери File › New › Project: язык Java, Build system — Maven или Gradle, JDK 21. Впиши com.educora в поле GroupId и grade-book в поле ArtifactId. В терминале то же самое делает команда gradle init.

3. 3
   Добавь зависимость

   Найди координаты библиотеки на сайте Maven Central и впиши их в pom.xml или build.gradle.kts. Затем нажми Reload в панели Maven/Gradle в IDE, чтобы библиотека скачалась.

4. 4
   Собери и запусти

   mvn package или ./gradlew build запустит тесты и создаст JAR; в Gradle ./gradlew run сразу запускает программу. Готовый JAR окажется в target/ или build/libs/.