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

Обычно новичок впервые всерьёз сталкивается со сборщиком, когда проект, который исправно запускался зелёной кнопкой в 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 — ограничения версий.
С чего начать и в каком порядке осваивать
План идёт от ежедневных действий к редким. Сначала вы собираете и тестируете один модуль, затем разбираетесь, откуда берутся библиотеки, и только потом переходите к модулям и серверу сборки: без понимания дерева зависимостей ошибки на последних шагах выглядят случайными.
- Создайте проект через IntelliJ IDEA или
gradle initи разберитесь в папкахsrc/main/javaиsrc/test/java. - Подключите библиотеку и JUnit 5, добейтесь запуска трёх тестов из терминала.
- Соберите JAR и запустите его через
java -jarна чистой машине или в контейнере. - Распечатайте дерево зависимостей и зафиксируйте одну транзитивную версию явно.
- Разделите проект на два модуля — логику и консольный интерфейс.
- Подключите 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; дальше — веб-приложения и командный проект с проверкой кода наставником.
Сравнивая программы, смотрите не на строку «Maven» в списке технологий, а на то, используется ли сборщик дальше: хорошо, когда все проекты сдаются как Maven- или Gradle-проекты с тестами и проверяющий запускает их из терминала.
Короткий вариант — онлайн-курс Merion Academy «Java-разработчик с нуля»: четыре месяца при 2–5 часах в неделю, асинхронно. Maven — третий из десяти блоков, после Java Base и Git; юнит-тестирование — седьмой, итоговый проект — REST API на Spring с базой данных и тестами.
Автотестеру сборщик нужен, чтобы запускать набор на сервере и получать отчёт, поэтому в программе для тестировщиков ищите связку 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.