Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Maven и Gradle: как собрать Java-проект, подключить зависимости и запустить тесты

Maven и Gradle — системы сборки для Java и других языков JVM. Разработчик или автотестер описывает в файле проекта, какие библиотеки нужны и какой версии, а сборщик скачивает их из репозитория, компилирует исходники, запускает тесты и упаковывает программу в JAR-архив. Maven хранит описание в декларативном pom.xml, Gradle — в скрипте build.gradle.kts. Освоить нужно структуру проекта, объявление зависимостей, жизненный цикл сборки и чтение дерева зависимостей. Дальше — учебный пример, разница в выборе версий, типичные ошибки и место этих инструментов в программах обучения.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Maven и Gradle: как собрать Java-проект, подключить зависимости и запустить тесты

Обычно новичок впервые всерьёз сталкивается со сборщиком, когда проект, который исправно запускался зелёной кнопкой в IntelliJ IDEA, падает на сервере сборки или у коллеги. Среда разработки многое скрывает: сама подхватывает библиотеки и помнит настройки, которых нет в репозитории. Сборщик знает только файл проекта. Если mvn test или ./gradlew test проходит на чистом компьютере, проект собран правильно; если нет — где-то спрятана зависимость от конкретной машины.

Что происходит, когда вы запускаете сборку

По команде mvn test Maven читает pom.xml, ищет библиотеки в локальном репозитории ~/.m2/repository и докачивает недостающие из Maven Central — общего публичного хранилища Java-библиотек. Затем он проходит фазы жизненного цикла: компилирует код из src/main/java, тесты из src/test/java и запускает их через плагин Surefire. Отчёты появляются в target/surefire-reports, а при ошибке сборка завершается с ненулевым кодом — его и видит сервер непрерывной интеграции. Фазы идут строго по порядку, поэтому mvn package не соберёт JAR, пока не пройдут тесты.

У Gradle вместо фиксированного цикла граф задач: compileJava, test, jar, build и всё, что добавят плагины. Он запоминает входы и выходы задач и пропускает неизменившиеся, поэтому повторные сборки идут быстрее. Запускают его через обёртку gradlew: скрипт в корне проекта скачивает записанную в настройках версию Gradle, и у всей команды сборка идёт одинаково.

Maven или Gradle

Выбирать обычно не приходится: сборщик достаётся вместе с проектом. Но разницу в подходе стоит понимать, чтобы читать чужую сборку.

Maven Gradle
Файл проекта pom.xml, XML build.gradle.kts (Kotlin) или build.gradle (Groovy)
Модель фиксированные фазы и плагины расширяемый граф задач
Где встречается чаще корпоративные сервисы, автотесты Android, Kotlin, большие многомодульные проекты

Строгость Maven удобна в команде: папки и команды во всех проектах одинаковы. Гибкость Gradle выручает, когда сборка делает много нестандартного, но позволяет превратить скрипт в трудночитаемую программу. Для Android выбор сделан заранее: Android Studio собирает проекты через Gradle. А программу из одного файла сборщик не требует — её запускают командой java Main.java.

Учебный пример: утилита для показаний счётчиков

Ситуация учебная. Консольная утилита читает CSV-файл с показаниями счётчиков воды и считает расход по месяцам. Для разбора CSV нужна библиотека Apache Commons CSV, для проверок — JUnit 5; номера версий условные. В Maven:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-csv</artifactId>
  <version>1.12.0</version>
</dependency>
<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter</artifactId>
  <version>5.11.4</version>
  <scope>test</scope>
</dependency>

В Gradle то же самое плюс включение платформы JUnit, как в руководстве Gradle по тестированию:

dependencies {
    implementation("org.apache.commons:commons-csv:1.12.0")
    testImplementation("org.junit.jupiter:junit-jupiter:5.11.4")
}
tasks.test { useJUnitPlatform() }

Область test и конфигурация testImplementation означают, что JUnit нужен только тестам и не попадёт в программу. Тест ConsumptionCalculatorTest проверяет три случая: обычный месяц, замену счётчика (показание стало меньше) и пустой файл. После запуска смотрите на число выполненных тестов, а не на надпись об успешной сборке: только оно доказывает, что проверки действительно работали.

Почему два сборщика выбирают разные версии одной библиотеки

Каждая библиотека тянет свои зависимости, и в дереве легко оказываются две версии одного пакета. Сборщик выбирает одну, и правила у Maven и Gradle разные.

Maven, согласно описанию механизма зависимостей, берёт «ближайшее определение» — версию с самым коротким путём от вашего проекта; при равной глубине побеждает объявленная раньше. Пример из документации: цепочки A → B → C → D 2.0 и A → E → D 1.0. Maven соберёт проект с D 1.0, потому что второй путь короче. Gradle, как сказано в документации о разрешении графа (версия 9.8.1), рассматривает все запрошенные версии и по умолчанию берёт самую высокую — D 2.0.

Следствие неочевидно. Если команда переводит проект с Maven на Gradle и переписывает зависимости один к одному, состав библиотек может тихо измениться без единой правки в коде. В Maven достаточно переставить две зависимости в pom.xml, чтобы при равной глубине сменилась версия. Ошибка всплывёт не при компиляции, а при запуске, например как NoSuchMethodError: код собран под метод, которого в выбранной версии нет.

Защищают две привычки. Первая — смотреть дерево: mvn dependency:tree в Maven, ./gradlew dependencies и dependencyInsight в Gradle. Вторая — фиксировать важные версии явно: документация Maven советует объявить нужную версию в своём POM, для групп библиотек используют dependencyManagement или BOM, в Gradle — ограничения версий.

С чего начать и в каком порядке осваивать

План идёт от ежедневных действий к редким. Сначала вы собираете и тестируете один модуль, затем разбираетесь, откуда берутся библиотеки, и только потом переходите к модулям и серверу сборки: без понимания дерева зависимостей ошибки на последних шагах выглядят случайными.

  1. Создайте проект через IntelliJ IDEA или gradle init и разберитесь в папках src/main/java и src/test/java.
  2. Подключите библиотеку и JUnit 5, добейтесь запуска трёх тестов из терминала.
  3. Соберите JAR и запустите его через java -jar на чистой машине или в контейнере.
  4. Распечатайте дерево зависимостей и зафиксируйте одну транзитивную версию явно.
  5. Разделите проект на два модуля — логику и консольный интерфейс.
  6. Подключите GitHub Actions или GitLab CI, чтобы тесты шли на каждый коммит.

Хорошее упражнение — повторить учебный проект на втором сборщике и сравнить деревья зависимостей. Другое — клонировать открытый проект с GitHub и собрать его по README: на чужой сборке быстрее учишься читать плагины и профили.

Типичные ошибки

Тест не запускается, а сборка зелёная. Surefire по умолчанию ищет тестовые классы по именам: начинающиеся на Test или оканчивающиеся на Test, Tests, TestCase — так в документации плагина. Класс LoginCheck Maven пропустит, и набор автотестов «пройдёт», не выполнив ни одной проверки.

Библиотеку подключают JAR-файлом из папки lib или через область system, которую документация Maven не рекомендует: такую зависимость сборщик не скачивает, и на другом компьютере проект не соберётся. Ещё одна частая путаница — в Git попадают папки target и build, а обёртка gradlew с папкой gradle/wrapper не попадает. Правильно наоборот. И наконец, ошибки лечат флагом -DskipTests или удалением кэша, не прочитав сообщение и дерево зависимостей.

Чему учат на курсах

Основы Maven и Gradle осваиваются по документации и учебным проектам. Онлайн-курс добавляет проверку кода и проекты, где сборку настраиваете вы. В программах школ сборщик обычно идёт коротким блоком после основ языка. Ни в одной из трёх программ ниже Gradle в учебном плане не назван — если вам нужен Android или Kotlin, уточните это у школы.

На онлайн-курсе Skillfactory «Профессия Java-разработчик» обучение длится около восьми месяцев. Maven, JUnit и Docker входят в третий модуль «Инструменты профессиональной разработки» на 50 часов, после двух модулей Java Core; дальше — веб-приложения и командный проект с проверкой кода наставником.

Открыть курс «Профессия Java-разработчик»

Сравнивая программы, смотрите не на строку «Maven» в списке технологий, а на то, используется ли сборщик дальше: хорошо, когда все проекты сдаются как Maven- или Gradle-проекты с тестами и проверяющий запускает их из терминала.

Короткий вариант — онлайн-курс Merion Academy «Java-разработчик с нуля»: четыре месяца при 2–5 часах в неделю, асинхронно. Maven — третий из десяти блоков, после Java Base и Git; юнит-тестирование — седьмой, итоговый проект — REST API на Spring с базой данных и тестами.

Открыть курс «Java-разработчик с нуля»

Автотестеру сборщик нужен, чтобы запускать набор на сервере и получать отчёт, поэтому в программе для тестировщиков ищите связку Maven с Git и CI.

Её называет курс Skillbox «Автоматизированное тестирование на Java»: два месяца для тестировщиков, которые уже проверяют API. В разделе «JUnit, Maven и CI/CD» — JUnit, Maven для зависимостей и сборки, Git и Jenkins или другой CI-сервис. Полный список из 30 модулей не приведён — уточните его у школы.

Открыть курс

Как навык влияет на доход

Отдельной надбавки за Maven или Gradle нет: в вакансиях Java-разработчиков и автоматизаторов это базовое требование. Открытых данных о зарплате именно по этому навыку найти не удалось. Влияние косвенное: без уверенной работы со сборкой трудно пройти тестовое задание, а умение разобрать конфликт версий и настроить CI делает вас тем, кому доверяют инфраструктуру проекта.

Для фона: по данным «Хабр Карьеры» за первое полугодие 2026 года медианная зарплата IT-специалистов в России — 191 тысяча рублей (выборка 45 226 зарплат), у разработчиков в Москве — 270 тысяч, зарплаты тестировщиков выросли на 5 %. Это фактические зарплаты по анкетам, а не предложения в вакансиях. Свою вилку смотрите в калькуляторе по специализации, региону и квалификации — медиану, а не среднее.

Как понять, что навык освоен

Вы клонируете проект на чистый компьютер, запускаете одну команду, и проходит ожидаемое число тестов. Вы объясняете по дереву, откуда взялась любая библиотека и почему выбрана её версия, и читаете чужой pom.xml или build.gradle.kts. О языке на сайте есть статья «Java», о фреймворке — «Spring», об инструментах автотестера — «Автотесты на Java», о профессии — «Java-разработчик».

Сравнить школы по цене, формату и практике поможет рейтинг онлайн-школ по обучению Java.