В данной статье вы найдёте инструкцию по установке 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 в любой директории,
для этого вам не будет требоваться среда разработки.
🎉 Поздравляю с успешной установкой!
Все способы:
- Шаг 1: Установка JRE
- Шаг 2: Скачивание и распаковка Maven
- Шаг 3: Добавление переменной среды
- Шаг 4: Проверка доступности Maven
- Вопросы и ответы: 2
Шаг 1: Установка JRE
Фреймворк управления сборками пакетов Maven относится к Java, поэтому возможность его работы в Windows 10 обеспечена JRE. Перед инсталляцией основного пакета нужно скачать последнюю версию Java, установить ее на компьютер, а также добавить переменную среды. Только после этого можно переходить к следующим этапам, поэтому если ранее вы не инсталлировали JDK или JRE, начните с данной инструкции.
Скачать JRE с официального сайта
- Откройте ссылку выше и выберите офлайн-инсталлятор JRE в соответствии со своей разрядностью Windows 10.
- Сразу же начнется скачивание исполняемого файла, а вам нужно дождаться завершения этого процесса и запустить установщик.
- В нем не меняйте путь инсталляции и другие параметры, просто нажмите кнопку «Install».
- Ожидайте окончания установки или обновления всех компонентов, после чего просто закройте данное окно.
- Откройте «Проводник» в любом удобном месте и перейдите по пути установки Java. Обычно для этого нужно выбрать каталог «Program Files (x86)» в системном разделе накопителя. Этот путь нужно полностью скопировать, включая саму папку с версией JRE, поскольку далее он понадобится при добавлении переменной среды.
- В этот раз мы пропишем переменную среды при помощи «PowerShell», чтобы вы понимали, как в будущем можно использовать инструмент. Однако мы еще обратимся к этой настройке через графический интерфейс, и вы всегда сможете выбирать один из двух методов, отталкиваясь от своих предпочтений. Нажмите правой кнопкой мыши по «Пуску» и из появившегося контекстного меню выберите пункт «Windows PowerShell (администратор)».
- Введите команду
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Java\jre-1.8", "Machine")
, заменив при этом в ней путь до своей версии JRE. Эта команда автоматически регистрирует новую переменную окружения среды, указывая для нее название и путь. - После активации вы должны просто получить пустую строку нового ввода, что означает успешное завершение предыдущей операции без ошибок.
- Для проверки успешности добавления переменной среды можете открыть «Командную строку» любым удобным для вас методом и использовать команду
echo %JAVA_HOME%
. - Вы должны получить в выводе путь к вашей JRE, что означает успешную работу переменной.
Точно также вы можете использовать команду "%JAVA_HOME%"\bin\java -version
для проверки Java-приложения. Это актуально в тех случаях, когда осуществляется первичная проверка работы всех компонентов. Вывод такой команды должен иметь примерно следующий вид:
java version "1.8.0_251"
Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)
И еще отдельно можно проверить Java-приложение без обращения к переменной среды. В этом случае команда имеет простой вид и наверняка известная многим — java -version
. Ее вывод, если все работает корректно, будет примерно таким же, каким вы видите его ниже с отличием в версии установленных компонентов.
java version "1.8.0_251"
Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)
Шаг 2: Скачивание и распаковка Maven
Maven скачивается в Windows 10 в виде репозитория, то есть не имеет установщика через EXE-файл. Полученный архив необходимо будет просто распаковать в подходящее для него место на компьютере, которое далее будет использоваться для работы с бинарными файлами проекта. Если вы пока еще только проводите знакомство с фреймворком и его основными функциями, можете прочитать все основные сведения на официальном сайте. После этого приступайте непосредственно к скачиванию и распаковке необходимых файлов.
Скачать Maven с официального сайта
- Перейдите по ссылке выше, чтобы попасть в хранилище файлов. В нем скачайте бинарный ZIP-архив, кликнув по ссылке с соответствующим названием. Учитывайте, что TAR.GZ в вашем случае не подходят, поскольку это архивы для Linux, а Source предназначается для других целей.
- После загрузки архива создайте новую папку, желательно в системном разделе диска, куда в дальнейшем будете помещать все связанные с Maven каталоги.
- Как раз в такую папку и переместите содержимое полученного архива. Дальнейшая установка не требуется, поэтому можно сразу перейти к регистрации переменных среды.
Шаг 3: Добавление переменной среды
Для дальнейшей корректной работы Maven в Windows 10 понадобится добавить переменную среды. Если вы хорошо управляетесь консолью и в первом шаге без проблем разобрались с командой для работы с переменными, можете использовать ее же, заменив необходимую информацию. Однако в большинстве случаев проще открыть графическое меню и в несколько нажатий изменить основную переменную среды, добавив в нее всего один путь.
- Для этого откройте «Пуск» и на панели слева нажмите по значку с шестеренкой, чтобы перейти в «Параметры».
- Щелкните по плитке с названием «Система».
- Прокрутите список категорий слева вниз, выберите «О программе», затем перейдите по ссылке «Дополнительные параметры системы», отыскав ее в блоке «Сопутствующие параметры».
- Отобразится новое окно — «Свойства системы». В нем вы сразу окажетесь на вкладке «Дополнительно», поэтому можете щелкнуть по «Переменные среды» для перехода к работе с этими компонентами.
- Отдельно откройте папку «bin» в созданном каталоге с Maven и скопируйте полный путь.
- В списке «Системные переменные» дважды нажмите по «Path» для перехода к редактированию этой переменной.
- Кликните по «Создать».
- Внизу появится новая строка ввода, куда вставьте скопированный ранее путь. На этом создание завершено, можете сразу переходить к проверке доступности Maven или сначала перезагрузить компьютер, если сомневаетесь, что изменения сразу вступят в силу.
Шаг 4: Проверка доступности Maven
Конечно, если вы уверены в правильности выполнения всех действий, можете прямо сейчас переходить к работе с фреймворком, однако лучше перестраховаться и заранее проверить успешность его установки. Проверяется она через основную команду фреймворка, которая выводит информацию об установленной версии.
- Для ее использования запустите «Командную строку».
- Введите
mvn --version
и нажмите Enter. - Вывод должен быть примерно таким:
Apache Maven 3.9.4 (r01de14724cdef164cd33c7c8c2fe155faf9602da; 2023-02-19 15:51:28+0200)
Maven home: T:\apache-maven-3.9.4\bin\..
Java version: 1.8.0_65, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_65\jre
Default locale: ru_RU, platform encoding: Cp1251
OS name: "windows 10", version: "10.0", arch: "x86", family: "windows"
Следующие этапы уже связаны непосредственно с конфигурацией Maven под собственные цели. Сюда относятся: создание основного каталога хранение создаваемых файлов, дополнительные переменные среды и еще некоторые папки. Обо всем этом лучше прочитать в официальной документации, отталкиваясь от того, чем именно вы собираетесь заниматься с использованием Maven.
Официальная документация по настройке Maven
Наша группа в TelegramПолезные советы и помощь
Apache Maven is a software project management and comprehension tool. It’s not pre-installed software with any Operating System, explicitly we need to download and install it. In this article, we are going to download Maven for Windows and install Maven on Windows 10 (64-bit) operating system.
Table of Contents
Software Dependency
- Apache Maven 3.6.3
- JDK 1.8
- Windows 10
Steps to install Maven in Windows 10:
- Install JDK
- Download Apache Maven
- Configure JAVA_HOME and M2_HOME in the environment variable
- Set the maven path in the environment variable
- Check Maven Installation
Install JDK (Java Development Kit)
In order to install Maven software, it required Java. So make sure that your system already has JDK installed. If it’s not installed, then you have to install JDK first. Visit another article for this: JDK installation on Windows 10 operating system.
For Example: jdk1.8.0_144 is installed at ‘C:\Program Files\Java\jdk1.8.0_144’
Download Maven for Windows
To install apache maven on Windows, you need to download Maven for Windows. You can download it from its official website: Download Apache Maven. For example, here we have downloaded the apache-maven-3.6.3-bin.zip as shown in the below image:
Now extract the downloaded zip files into some folder. The extracted file looks like the below image:
Set maven path in an environment variable in Windows 10
We have to configure two environment variables JAVA_HOME and M2_HOME in Windows. JAVA_HOME is used by many Java-based applications to define the place of Java Runtime Environment (JRE) installation. And M2_HOME is used by Maven, and again it tells the program where to find Maven installation. These configurations need to be added to System Environment Variables.
System Environment Variables path:
Right click on MyComputer -> properties -> Advanced System Settings -> Environment variables
Now click on the Environment Variables button > add JAVA_HOME & M2_HOME one by one like the below images:
Set maven path in Windows 10
The Path variable is used to find applications (executables, and scripts) and DLLs on Windows. If the Path variable is already there then click on Edit to add a Maven path like the below image:
How to check whether Maven is installed or not?
To verify whether Maven is installed or not, open the command prompt by pressing Window Key+R, type “cmd” and then press Enter Key.
After opening a command prompt type the maven command “mvn -version” then press Enter and see the below output:
This is how you can find out which version of Maven is installed in your system now.
Conclusion
In this article, you have seen how you download apache maven and install it on the Windows 10 operating system.
FAQ
mvn is not recognized as an internal or external command
C:\Windows\System32>mvn -version'mvn' is not recognized as an internal or external command, operable program or batch file.
This means that the installation of maven is not done properly, make sure %M2_HOME%\bin is prepended to the PATH variable the right way.
JAVA_HOME environment variable is not defined correctly
C:\Windows\System32>mvn -versionThe JAVA_HOME environment variable is not defined correctly This environment variable is needed to run this program NB: JAVA_HOME should point to a JDK not a JRE
This simply means that JDK is not installed and the JAVA_HOME variable is not properly configured.
Related Article:
- JDK 8 Installation on Windows 10 Operating System
- How to Download and Install JDK 11 on Windows 10?
- JDK 17 Installation on Windows 10 [step-by-step]
- Install MySQL Server 8.0.27 [zip Archive] on Windows 10
- Install MySQL Workbench 8.0.27 on Windows 10[step-by-step]
You may also like:
- Creating a Spring Boot Project with Eclipse and Maven
- File Upload in Java Servlet Example
- How to write Excel files in Java using Apache POI?
- How to create password-protected Excel in Java?
Last Updated :
17 Sep, 2024
Apache Maven is a comprehensive build automation tool widely used for managing and building Java projects. It simplifies the process of managing project dependencies and building projects through a standardized approach. This article provides step-by-step instructions to install Apache Maven on Windows, macOS, and Linux.
What is Maven?
Maven is a build automation tool that focuses on two main areas:
- Building Software: Maven uses a plugin-based architecture to manage the build process of software projects.
- Handling Dependencies: Maven automatically manages and downloads Java libraries needed for the project.
If you would like to install Apache Maven in operating systems such as Windows, macOS, or Linux, please take a look at the steps mentioned below.
Install Apache Maven on macOS
We need to follow the steps mentioned below to install apache maven in the macOS.
Step 1: Open Maven Website
First step is to open the maven website, simply type apache maven download in search engine and open the first website which will look similar to image below.
Step 2: Download the latest binary zip archive
Once you open the website, scroll and select the following file for downloading, this is the file that contains the apache maven for macOS.
Step 3: Extract the Zip File
Locate the downloaded zip file and double-click it to extract. It will create a new folder with the same name as the zip file.
Step 4: Open Environmental Path
Next step is to open the environmental path and for configuring the environment variable. We will have to open it in the terminal. For this, simply launch a terminal in macOS and type the following command to open the environmental path:
vi .zshenv
Step 5: Configure Environment Variable
Once we have opened the environmental path, we will have to configure it by adding the path where the maven folder is stored and update the BIN location (path and folder name can vary in your case).
Here is my location and path for example:
export M2_HOME="$PATH:/Users/prashantrana/Documents/Dev/JavaSpring/apache-maven-3.6.3"
export PATH=$PATH:$M2_HOME/bin
Once you save this location of the environmental path, maven is ready to be used in your macOS operating system.
After this, you can verify the installation by using the below command:
mvn -version
This will display the Maven version installed on your system. This is how apache maven can be installed and configured in macOS system.
Install Apache Maven on Windows
For installing apache maven on the Windows operating system, we already have a dedicated article that you can follow, it involves several steps for installing Apache Maven on Windows.
How to Install Apache Maven on Windows?
Install Apache Maven on Linux
For installing apache maven on Linux, we will have to follow the below steps one by one.
Step 1: Verify JDK Installation
First step is to verify whether JDK is installed or not. For this, simply open a terminal and type the following command:
java --version
After typing this command you can see output similar to image below, if it is not installed properly then it will show an error message that command was not found.
If you need to install JDK in Linux you can read this article: How to Install JDK in Linux?
Once it is verified that JDK is installed, go to the next step.
Step 2: Update Package Index
Next step is to update the library. This step is also important because we need to make sure we can run the command for installing maven and for that directory list needs to have maven in it.
Type the following command in your terminal and wait until the list is downloaded:
sudo apt update
Step 3: Install Maven
Next step is to install maven. For this, simply type the following command and it will install maven in the Linux system.
sudo apt install maven
As you can see in the image below as well:
Step 4: Verify Maven Installation
Once the installation is completed, we can check whether maven is installed successfully or not. For checking this, we will have to enter the following command in the linux terminal.
mvn -version
This will show us the maven version which is installed in the system, also seen in the image below as well.
This will display the Maven version installed on your system. This is how we can install maven in different operating systems.
Conclusion
Apache Maven is a robust tool for managing project builds and dependencies. Installing Maven varies by operating system, but the process is straightforward. Follow the steps outlined above for Windows, macOS, or Linux to get Maven up and running on your system.
The Apache Group created the well-liked open-source build tool Maven to build, publish, and deploy multiple projects simultaneously for improved project management. The lifecycle framework can be built and documented using the provided tool.
Maven is built in Java and is used to create projects in C#, Scala, Ruby, and other languages. This tool, which is based on the Project Object Model (POM), has made the life of Java developers simpler when producing reports, checking builds, and testing automated settings.
The objective of Maven:
The goal of Maven is to enable developers with:
- A project model that is comprehensive, maintainable, reusable, and easy.
- A collection of tools and plug-ins for interacting with the declarative model.
Feature Of Java:
Maven has plenty of essential and useful characteristics, which helps to explain why it is attractive. Here are some of Maven’s most notable features:
- A vast, constantly increasing archive of user libraries
- The ability to simply build up projects making use of best practices
- Management of dependencies with automated update
- Compatibility with prior versions.
- Reporting with high accuracy and honesty
- Uniform use across all projects
Install Maven on Windows:
First, we need to install JDK (Java development kit) on our PC, followed by Maven on Windows.
In Order to download Java. Land https://www.oracle.com/in/java/technologies/downloads/#jdk20-windows on that page, you may locate the JDK for many platforms and operating systems.
While Java is being installed, let’s get started on installing Maven on Windows:
- Navigate to Browser
- Enter Maven Download and navigate to https://maven.apache.org/download.cgi
- Use the Apache zip archive link to download.
- After downloading both JDK and Apache Maven, we’ll navigate to the directory containing the Java executables.
- Install the whole JDK.
- Immediately after the installation of the JDK, we must navigate to the Maven directory and extract the files.
- After Downloading Java and Maven we need to set its path into system properties
- In Order to set Path search for Environment Variable in your PC and open it.
- After then go to the Java bin path in your local directory and set Java Path
- Now Open CMD and type the command java –version.
- After that Set New Environment Variable for Maven
- Open Environment Variable in the same way described above and under the system, variable enter Maven Home.
- Now set the M2 variable for Maven again.
- Then Edit the path and set Maven Bin Path
- Now click OK.
- Maven has been installed. Return to the command prompt window to confirm that Maven is installed.
- Open CMD and enter the MVN version
- We can see that JDK and Maven are both installed on our machine.
Install Maven On Ubuntu:
- Launch the terminal.
- To install packages, use the root id.
- After completing the preceding steps, execute the app update command.
- Install the most recent Java package next.
While Java is being installed, let’s get started on installing Maven:
- Navigate to Browser
- Enter Maven Download and navigate to https://maven.apache.org/download.cgi
- Navigate to the Binary tar.gz archive.
- Copy the Binary tar.gz archive link.
- Once the Java installation is complete, use a new terminal to install Maven.
- Navigate to the opt directory by entering the command i.e. “cd /opt”
- Then execute the wget command along with the link copied above i.e.” wget *link of tar.gz archive*”
- After downloading the Maven tar file, extract it.
- We can see the Apache Maven directory when the extraction is complete.
- Let’s go to the Maven directory now by entering the command i.e. “cd maven/”
- Return to terminal 1 and check the Java version by entering the command i.e. “java -version”
- Navigate back to terminal 2 and enter the command i.e. “cd/ etc/ profile.d/”
- All of the path variables are visible here.
- To add more options, use the echo command to copy the path variables by entering the command i.e.” echo *path copied* /opt/maven/bin >>maven.sh”
- Now, export MVN_HOME to this directory by entering the command i.e.” echo “export MVN HOME=/opt/maven” >>maven.sh”
- Finally, we’ll grant this file executable permissions by entering the command i.e.” source /etc/profile.d/maven.sh”
- Following this, we can execute the Maven version command i.e. “mvn -version”
Conclusion:
After completing these steps, you should have a working copy of Maven on your Windows machine as well as on Ubuntu.