Как установить Apache Maven в Ubuntu 24.04 LTS

Apache Maven — мощный и широко используемый инструмент автоматизации сборки проектов Java. Он упрощает управление зависимостями, сборками и документацией, что делает его важным инструментом для разработчиков Java. Подход Maven, основанный на соглашениях над конфигурацией, упрощает процесс разработки, позволяя разработчикам сосредоточиться на написании кода, а не беспокоиться о конфигурациях сборки. В этой статье мы проведем вас через процесс установки Apache Maven в Ubuntu 24.04 LTS, предоставив пошаговые инструкции как для APT, так и для методов установки вручную. К концу этого руководства у вас будет полнофункциональная установка Maven, готовая улучшить рабочий процесс разработки Java.

Предварительные условия

Прежде чем приступить к установке Apache Maven, убедитесь, что ваша система соответствует следующим требованиям:

• Операционная система Ubuntu 24.04 LTS
• Привилегии Sudo для выполнения команд с правами администратора
• Комплект разработки Java (JDK), установленный в вашей системе.

Чтобы проверить вашу версию Ubuntu, откройте терминал и выполните следующую команду:

lsb_release -a

Убедитесь, что выходные данные подтверждают, что вы используете Ubuntu 24.04 LTS. Кроме того, проверьте, установлена ​​ли Java, выполнив:

java -version

Если Java не установлена, вы можете установить ее с помощью следующей команды:

sudo apt install default-jdk

Способ 1. Установка Apache Maven с помощью APT

Самый простой способ установить Apache Maven в Ubuntu 24.04 LTS — использовать менеджер пакетов APT. Выполните следующие действия, чтобы установить Maven с помощью APT:

Шаг 1. Обновите индекс пакета

Перед установкой каких-либо пакетов важно обновить индекс пакетов, чтобы обеспечить доступ к последним версиям. Откройте терминал и выполните следующую команду:

sudo apt update

Эта команда извлекает последнюю информацию о пакете из репозиториев, гарантируя, что вы установите самую последнюю версию Maven.

Шаг 2. Установите Maven с помощью APT.

После обновления индекса пакетов вы можете установить Maven с помощью менеджера пакетов APT. Выполните следующую команду:

sudo apt install maven

APT выполнит процесс установки, автоматически разрешая любые зависимости, необходимые Maven. Это делает процесс установки простым и беспроблемным.

Шаг 3. Проверьте установку.

После завершения установки убедитесь, что Maven установлен правильно, выполнив следующую команду:

mvn -version

Если установка прошла успешно, вы должны увидеть информацию о версии Maven, а также версию Java и другие соответствующие сведения.

Способ 2. Установка Apache Maven вручную

Если вы предпочитаете больше контроля над процессом установки или хотите установить определенную версию Maven, вы можете выбрать метод установки вручную. Выполните следующие действия, чтобы установить Maven вручную:

Шаг 1. Загрузите Maven с официального сайта.

Посещать официальная страница загрузки Apache Maven. Прокрутите вниз до раздела «Файлы» и скопируйте URL-адрес двоичного архива tar.gz нужной версии Maven.

Откройте терминал и используйте wget команда для загрузки архива Maven. Заменять <maven-url> с скопированным URL-адресом:

wget <maven-url>

Например:

wget https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

Шаг 2. Извлеките загруженный архив

После завершения загрузки извлеките архив Maven в папку /opt каталог, используя следующую команду:

sudo tar xf apache-maven-*.tar.gz -C /opt

/opt Каталог — это стандартное место для установки дополнительного или стороннего программного обеспечения в системах Linux.

Шаг 3. Настройте переменные среды

Чтобы сделать Maven доступным из любого места терминала, вам необходимо настроить необходимые переменные среды. Создайте новый файл с именем maven.sh в /etc/profile.d/ каталог:

sudo nano /etc/profile.d/maven.sh

Добавьте в файл следующие строки:

export JAVA_HOME=/usr/lib/jvm/default-java
export M2_HOME=/opt/apache-maven-3.9.9
export MAVEN_HOME=/opt/apache-maven-3.9.9
export PATH=${M2_HOME}/bin:${PATH}

Обязательно замените apache-maven-3.9.1 с фактическим именем каталога вашего извлеченного архива Maven.

Сохраните файл и выйдите из текстового редактора.

Шаг 4. Примените изменения и проверьте установку.

Чтобы применить изменения, внесенные в переменные среды, выполните следующую команду:

source /etc/profile.d/maven.sh

Эта команда загружает новые переменные среды в текущий сеанс оболочки.

Наконец, проверьте установку Maven, выполнив:

mvn -version

Вы должны увидеть информацию о версии Maven, подтверждающую, что установка вручную прошла успешно.

Настройка переменных среды

Настройка переменных среды имеет решающее значение для правильной работы Maven. Вот подробное объяснение каждой переменной:

• JAVA_HOME: эта переменная указывает на каталог, в котором установлен Java Development Kit (JDK). Maven требует JDK для компиляции и запуска проектов Java.
• M2_HOME и MAVEN_HOME: эти переменные указывают каталог, в котором установлен Maven. Они используются Maven для поиска файлов конфигурации и зависимостей.
• PATH: PATH переменная обновляется и включает в себя bin каталог Maven. Это позволяет запускать команды Maven из любого места терминала без указания полного пути.

Установив эти переменные среды, вы гарантируете, что Maven сможет найти необходимые библиотеки Java и свои собственные файлы конфигурации.

Проверка установки

После завершения процесса установки важно убедиться, что Maven настроен правильно. Запустите следующую команду в терминале:

mvn -version

Если установка прошла успешно, вы должны увидеть вывод, аналогичный следующему:

Apache Maven 3.9.9 (c27a7f5c3dgdt1a4c1a5f4e4b4f4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d)
Maven home: /opt/apache-maven-3.9.1
Java version: 17.0.7, vendor: Private Build, runtime: /usr/lib/jvm/java-17-openjdk-amd64
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.15.0-72-generic", arch: "amd64", family: "unix"

Эти выходные данные подтверждают, что Maven установлен правильно, и предоставляют информацию о версии Maven, версии Java и сведениях о системе.

Распространенные проблемы и устранение неполадок

Хотя установка Apache Maven в Ubuntu 24.04 LTS, как правило, проста, вы можете столкнуться с несколькими распространенными проблемами. Вот несколько советов по устранению неполадок, которые помогут вам их решить:

1. Проблемы с PATH: Если вы столкнулись с ошибками, связанными с mvn команда не найдена, еще раз проверьте, что PATH переменная правильно установлена ​​в maven.sh файл. Убедитесь, что Maven bin каталог добавляется в PATH.
2. Ошибки JDK: Для правильной работы Maven требуется совместимый комплект разработки Java (JDK). Если вы столкнулись с ошибками, связанными с JDK, убедитесь, что у вас установлен JDK и что JAVA_HOME переменная указывает на правильный каталог JDK.
3. Доступ запрещен: Если вы столкнулись с проблемами разрешений при выполнении команд Maven, убедитесь, что у вас есть необходимые разрешения для чтения и выполнения файлов Maven. Вы можете использовать sudo команда для запуска Maven с повышенными привилегиями.