Короткий посібник з обгортки Maven

1. Огляд

Maven Wrapper - чудовий вибір для проектів, які потребують певної версії Maven (або для користувачів, які взагалі не хочуть встановлювати Maven). Замість того, щоб встановлювати багато його версій в операційну систему, ми можемо просто використовувати сценарій обгортки для конкретного проекту.

У цій короткій статті ми покажемо, як налаштувати Maven Wrapper для існуючого проекту Maven.

2. Налаштування обгортки Maven

Існує два способи його налаштування в проекті, де найпростіший - використовувати відповідний плагін для автоматизації або застосувати встановлення вручну.

2.1. Підключати

Давайте скористаємось цим плагіном Maven Wrapper для автоматичного встановлення у простому проекті Spring Boot.

Спочатку нам потрібно зайти в основну папку проекту і запустити цю команду:

mvn -N io.takari:maven:wrapper

Ми також можемо вказати версію Maven:

mvn -N io.takari:maven:wrapper -Dmaven=3.5.2

Параметр -N означає –нерекурсивний, так що обгортка буде застосована лише до основного проекту поточного каталогу, а не в будь-яких підмодулях.

Після виконання цілі у нас буде більше файлів та каталогів у проекті:

  • mvnw : це виконуваний скрипт оболонки Unix, який використовується замість повністю встановленого Maven
  • mvnw.cmd : це пакетна версія вищезазначеного сценарію
  • mvn : прихована папка, що містить бібліотеку Java Maven Wrapper та файл властивостей

2.2. Вручну

За допомогою ручного підходу ми можемо копіювати файли та папки, побачені вище, з іншого проекту в основну папку поточного проекту.

Потім нам потрібно вказати версію Maven для використання у файлі властивостей обгортки, що знаходиться у файлі .mvn / wrapper / maven-wrapper.properties .

Наприклад, наш файл властивостей має такий рядок:

distributionUrl=//repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.2/apache-maven-3.5.2-bin.zip

Отже, версія 3.5.2 буде завантажена та використана.

3. Використовуйте кейси

Обгортка повинна працювати з різними операційними системами, такими як:

  • Linux
  • OSX
  • Windows
  • Соляріс

Після цього ми можемо виконати наші цілі так для системи Unix:

./mvnw clean install

І наступна команда для Batch:

./mvnw.cmd clean install

Якщо у нас немає вказаного Maven у властивостях обгортки, він буде завантажений та встановлений у папці $ USER_HOME / .m2 / wrapper / dists системи.

Давайте запустимо наш проект Spring-Boot:

./mvnw spring-boot:run

Результат роботи такий же, як і для повністю встановленого Maven:

Примітка: ми використовуємо виконуваний файл mvnw замість mvn, який зараз є програмою командного рядка Maven.

4. Висновок

У цьому посібнику ми побачили, як налаштувати та використовувати Maven Wrapper у проекті Maven.

Як завжди, вихідний код цієї статті можна знайти на GitHub.