В данной статье вы найдёте инструкцию по установке Maven из архива, настройке переменных окружения для возможности запуска команд Maven в командной строке операционной системы Windows.

Требования #

Предварительно у вас должен быть установлен JDK версии не ниже 8 и настроена переменная окружения $JAVA_HOME. Проверьте в PowerShell командами java --version и echo $env:JAVA_HOME. На скриншоте пример вывода, который удовлетворяет дальнейшим действиям.

Если у вас ошибки и команда java не найдена, а JAVA_HOME ничего не выводит, скачайте и установите JDK. На странице необходимо выбрать операционную систему, скачать файл MSI и запустить. Это обычный установщик, в котором достаточно будет нажать «Далее».

После установки закройте все окна PowerShell и откройте заново, попробуйте выполнить команды. Перезагрузку тоже можете попробовать 🙂

⏬ Скачивание архива #

Перейдите на официальный сайт проекта Maven и скачайте архив Downloading Apache Maven На странице найдите секцию Files и скачайте Binary Zip Archive.

📤 Распаковка архива #

Найдите файл со скачанным архивом. Нажмите на него правой клавишей мыши и выберите «Извлечь всё…» (Extract All…).

В предложенном окне установите путь, куда будет распакован архив. Вы можете распаковать в удобное для вас место. При этом в пути не должно быть пробелов, кириллицы или специальных символов.

В примере будем устанавливать в корень диска C:\, можете вписать или выбрать через кнопку «Обзор…» (Browse…).

Нажмите кнопку «Распаковать» (Extract).

☑️ Проверка запуска #

Содержимое архива представляет собой набор библиотек и исполняемых файлов. Мы можем попробовать его запустить. Для этого откройте командную строку (Windows PowerShell) и перейдите в директорию, в которую распаковали архив. Если распаковали в C:, то команда будет cd C:\

Далее посмотрите список файлов и найдите директорию apache-maven-3.x.x. У вас версия может отличаться, так как Maven активно обновляется. В примере это директория apache-maven-3.8.6.

Перейдите в директорию apache-maven-3.8.6 и далее в директорию bin. Это можно сделать одной командой:

cd C:\apache-maven-3.8.6\bin

Выполните команду ./mvn -version. Если переменная окружения JAVA_HOME ведёт на JDK, то вы увидите версию Maven:

Если у вас выводится версия, значит, Maven готов к работе. Если нет, то убедитесь, что находитесь в директории bin, там есть файл mvn и выполнены требования перед установкой.

🏗️ Настройка PATH #

Конечно, на данном этапе уже можно пользоваться Maven, но придётся постоянно писать полный путь до файла mvn, и это неудобно. Для того чтобы команда работала в любой директории, необходимо добавить папку C:\apache-maven-3.8.6\bin в системную переменную PATH. Это важная переменная, в ней перечислены директории, в которых Windows ищет исполняемые файлы, когда мы набираем в консоли имя файла. Чтобы посмотреть её содержание, выполните команду в PowerShell:

echo $env:PATH

В результате будет выведена строка с директориями, разделёнными точкой с запятой.

Как это работает?

Например, если мы в терминале наберём команду calc, откроется приложение «Калькулятор». Так как операционная система прошлась по очереди по всем папкам и нашла в одной из них приложение calc.exe, его и запустила. Операционная система всегда запускает первый попавшийся подходящий исполняемый файл, даже если их несколько в разных директориях. Таким же образом директории проходятся по очереди записи в строке PATH.

Это значит, что нам надо добавить в этот список и папку с исполняемым файлом mvn.

Сделайте это из консоли. Только на всякий случай сохраните в текстовый файл все директории, которые получили командой echo $env:PATH. Если вы ошибётесь в команде и удалите данные, то сможете восстановить их из файла. Чтобы сохранить сразу в файл, используйте команду $env:PATH >> path.txt. Значение сохранится в папке, в которой вы находитесь.

Команда для добавления директории bin:

setx PATH "$env:PATH;C:\apache-maven-3.8.6\bin"

❗ Не ставьте в конце пути \ (обратный слеш), так как это будет экранировать кавычку, и кавычка станет частью строки.

Эта команда записывает в PATH cамо значение PATH и добавляет нашу строку. Важно на забыть поставить разделитель ; в начале нашего пути до bin.

По сути, мы склеиваем текущее значение с нашей директорией и записываем в эту же переменную.

После выполнения команды закройте все терминалы и откройте заново. Проверьте, что сохранилось в PATH echo $env:PATH.

Если путь до Maven есть в списке — время проверить работу команды mvn.

Теперь вы можете запускать mvn в любой директории, для этого вам не будет требоваться среда разработки.

🎉 Поздравляю с успешной установкой!