stringtranslate.com

Апач Мавен

Maven — это инструмент автоматизации сборки , используемый в основном для проектов Java . Maven также можно использовать для создания и управления проектами, написанными на C# , Ruby , Scala и других языках. Проект Maven поддерживается The Apache Software Foundation , где он ранее был частью проекта Jakarta .

Maven рассматривает два аспекта создания программного обеспечения: способ создания программного обеспечения и его зависимости. В отличие от более ранних инструментов, таких как Apache Ant , он использует соглашения для процедуры сборки. Необходимо указывать только исключения. XML - файл описывает собираемый программный проект, его зависимости от других внешних модулей и компонентов, порядок сборки, каталоги и необходимые плагины . Он поставляется с заранее определенными целями для выполнения определенных четко определенных задач, таких как компиляция кода и его упаковка. Maven динамически загружает библиотеки Java и подключаемые модули Maven из одного или нескольких репозиториев, таких как центральный репозиторий Maven 2, и сохраняет их в локальном кеше. [2] Этот локальный кэш загруженных артефактов также можно обновлять артефактами, созданными локальными проектами. Публичные репозитории также можно обновлять.

Maven построен с использованием архитектуры на основе плагинов, которая позволяет использовать любое приложение, управляемое через стандартный ввод. Для Maven 2 поддерживается собственный плагин C / C ++. [3]

Альтернативные технологии, такие как Gradle и sbt, в качестве инструментов сборки не полагаются на XML , но сохраняют ключевые концепции, представленные Maven. В Apache Ivy также был разработан специальный менеджер зависимостей, который также поддерживает репозитории Maven. [4]

Apache Maven поддерживает воспроизводимые сборки . [5] [6]

История

Количество артефактов в центральном репозитории Maven быстро росло.

Maven был создан Джейсоном ван Зилом в 2002 году и начинался как подпроект Apache Turbine . В 2003 году Maven был принят в качестве проекта Apache Software Foundation высшего уровня .

История версий:

Синтаксис

Проекты Maven настраиваются с использованием объектной модели проекта (POM) в pom.xmlфайле.

Пример файла:

<project> <!-- версия модели всегда равна 4.0.0 для POM Maven 2.x --> <modelVersion> 4.0.0 </modelVersion> <!-- координаты проекта, т. е. группа значений, которые однозначно идентифицируют этот проект --> <groupId> com.mycompany.app </groupId> <artifactId> my-app </artifactId> <version> 1.0 </version>        <!-- зависимости библиотеки --> <зависимости>  <!-- Координаты необходимой библиотеки.  Область действия — «тест», что указывает на то, что библиотека  используется только для запуска тестов. --> <dependent> <groupId> org.junit.jupiter </groupId> <artifactId> junit-jupiter-engine </artifactId> <version> 5.9.1 </version> <scope> test </scope> </ зависимость>       </зависимости> </проект>

Этот POM определяет уникальный идентификатор проекта ( координаты ) и единственную зависимость от библиотеки JUnit . Однако этого уже достаточно для сборки проекта и выполнения связанных с ним модульных тестов . Maven достигает этого, используя идею Соглашения над Конфигурацией , то есть Maven предоставляет значения по умолчанию для конфигурации проекта.

Структура каталогов обычного идиоматического проекта Maven имеет следующие записи каталогов:

Структура каталогов для проекта Java, автоматически созданная Maven.

Команда mvn packageскомпилирует все файлы Java, выполнит все тесты и упакует в него готовый код и ресурсы target/my-app-1.0.jar(при условии, что идентификатор артефакта — my-app, а версия — 1.0.)

Используя Maven, пользователь предоставляет только конфигурацию проекта, в то время как настраиваемые плагины выполняют фактическую работу по компиляции проекта, очистке целевых каталогов, запуску модульных тестов, созданию документации API и так далее. В общем, пользователям не придется писать плагины самостоятельно. Сравните это с Ant и make , в которых пишутся императивные процедуры для выполнения вышеупомянутых задач.

Дизайн

Объектная модель проекта

Объектная модель проекта (POM) [7] предоставляет всю конфигурацию для одного проекта. Общая конфигурация охватывает имя проекта, его владельца и его зависимости от других проектов. Также можно настроить отдельные этапы процесса сборки, которые реализованы в виде плагинов . Например, можно настроить плагин-компилятор на использование Java версии 1.5 для компиляции или указать упаковку проекта, даже если некоторые модульные тесты не пройдены.

Более крупные проекты следует разделить на несколько модулей или подпроектов, каждый со своим POM. Затем можно написать корневой POM, с помощью которого можно скомпилировать все модули одной командой. POM также могут наследовать конфигурацию от других POM. По умолчанию все POM наследуются от Super POM [8] . Super POM предоставляет конфигурацию по умолчанию, такую ​​как исходные каталоги по умолчанию, плагины по умолчанию и т. д.

Плагины

Большая часть функциональности Maven находится в плагинах . Плагин предоставляет набор целей, которые можно выполнить с помощью команды mvn [plugin-name]:[goal-name]. Например, проект Java можно скомпилировать с целью компиляции плагина компилятора [9] , запустив mvn compiler:compile.

Существуют плагины Maven для сборки, тестирования, управления исходным кодом, запуска веб-сервера, создания файлов проекта Eclipse и многого другого. [10] Плагины представлены и настроены в разделе <plugins> файла pom.xml. Некоторые базовые плагины включены в каждый проект по умолчанию и имеют разумные настройки по умолчанию.

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

Концепция жизненного цикла Maven решает эту проблему.

Плагины — это основной способ расширения Maven. Разработку плагина Maven можно выполнить путем расширения класса org.apache.maven.plugin.AbstractMojo. Пример кода и объяснение плагина Maven для создания облачной виртуальной машины с сервером приложений приведены в статье Автоматизация разработки и управления облачными виртуальными машинами . [11]

Создание жизненных циклов

Жизненный цикл сборки представляет собой список именованных этапов , которые можно использовать для упорядочения выполнения цели. Одним из трех стандартных жизненных циклов Maven является жизненный цикл по умолчанию , который включает в себя следующие этапы, выполняемые в указанном порядке: [12]

Цели, предоставляемые плагинами, могут быть связаны с разными этапами жизненного цикла. Например, по умолчанию цель compiler:compileсвязана с compileфазой, а цель surefire:test— с testфазой. Когда mvn testкоманда выполняется, Maven выполняет все цели, связанные с каждой фазой, вплоть до фазы test. В таком случае Maven выполняет resources:resourcesцель, связанную с process-resourcesфазой, затем compiler:compileи так далее, пока наконец не достигнет surefire:testцели.

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

Стандартные жизненные циклы дают пользователям, впервые участвующим в проекте, возможность точно собирать, тестировать и устанавливать каждый проект Maven, введя одну команду mvn install. По умолчанию Maven упаковывает файл POM в сгенерированные файлы JAR и WAR. Такие инструменты, как Diet4j [13], могут использовать эту информацию для рекурсивного разрешения и запуска модулей Maven во время выполнения, не требуя «uber»-jar, содержащего весь код проекта.

Зависимости

Центральной функцией Maven является управление зависимостями . Механизм обработки зависимостей Maven организован вокруг системы координат, идентифицирующей отдельные артефакты, такие как программные библиотеки или модули. В приведенном выше примере POM координаты JUnit ссылаются на прямую зависимость проекта. Проект, которому нужна, скажем, библиотека Hibernate , просто должен объявить координаты проекта Hibernate в своем POM. Maven автоматически загрузит зависимость и те зависимости, которые нужны самому Hibernate (называемые транзитивными зависимостями ) и сохранит их в локальном репозитории пользователя. Центральный репозиторий Maven 2 [2] по умолчанию используется для поиска библиотек, но можно настроить используемые репозитории (например, частные репозитории компании) внутри POM.

Фундаментальное различие между Maven и Ant заключается в том, что дизайн Maven рассматривает все проекты как имеющие определенную структуру и набор поддерживаемых рабочих процессов задач (например, получение ресурсов из системы контроля версий, компиляция проекта, модульное тестирование и т. д.). Хотя большинство программных проектов фактически поддерживают эти операции и фактически имеют четко определенную структуру, Maven требует, чтобы эта структура и детали реализации операции были определены в файле POM. Таким образом, Maven опирается на соглашение о том, как определять проекты и на список рабочих процессов, которые обычно поддерживаются во всех проектах. [14]

Существуют поисковые системы, такие как The Central Repository Search Engine, [15] , которые можно использовать для поиска координат различных библиотек и фреймворков с открытым исходным кодом.

Проекты, разработанные на одной машине, могут зависеть друг от друга через локальный репозиторий. Локальный репозиторий представляет собой простую структуру папок, которая действует как кэш для загруженных зависимостей и как централизованное место хранения локально созданных артефактов. Команда Maven mvn installсоздает проект и помещает его двоичные файлы в локальный репозиторий. Затем другие проекты смогут использовать этот проект, указав его координаты в своих POM.

Совместимость

Существуют надстройки к нескольким популярным интегрированным средам разработки (IDE), ориентированным на язык программирования Java, которые обеспечивают интеграцию Maven с механизмом сборки IDE и инструментами редактирования исходного кода, позволяя Maven компилировать проекты из IDE, а также устанавливать путь к классам для завершение кода, выделение ошибок компилятора и т. д.

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

Эти надстройки также предоставляют возможность редактировать POM или использовать POM для определения полного набора зависимостей проекта непосредственно в IDE.

Некоторые встроенные функции IDE теряют силу, когда IDE больше не выполняет компиляцию. Например, JDT Eclipse имеет возможность перекомпилировать один исходный файл Java после его редактирования. Многие IDE работают с плоским набором проектов вместо иерархии папок, предпочитаемой Maven. Это усложняет использование систем SCM в IDE при использовании Maven. [16] [17] [18]

Смотрите также

Рекомендации

  1. ^ «Примечания к выпуску – Maven 3.9.6» .
  2. ^ ab "Индекс /maven2/". Архивировано из оригинала 17 сентября 2018 г. Проверено 15 апреля 2009 г.
  3. ^ Лаугстол, Трюгве. «Нативный плагин MojoHaus Maven».
  4. ^ "IBiblio Resolver | Apache Ivy™" .
  5. ^ «Воспроизводимые/проверяемые сборки - Apache Maven - Apache Software Foundation» . cwiki.apache.org .
  6. ^ «Воспроизводимые сборки на Java - DZone Java» . dzone.com .
  7. ^ Справочник ПОМ
  8. ^ Супер ПОМ
  9. ^ Пунзалан, Эдвин. «Плагин компилятора Apache Maven – Введение».
  10. ^ Марбез, Бретт Портер Джейсон ван Зил Деннис Лундберг Оливье Лами Бенсон Маргулис Карл-Хайнц. «Maven – Доступные плагины».
  11. ^ Эмис, Алекс; Цзоу ПХ; Ван И С (29 октября 2011 г.). «Автоматизация разработки и управления облачными виртуальными машинами». IBM DeveloperWorks . ИБМ.
  12. ^ Портер, Бретт. «Maven – Введение в жизненный цикл сборки».
  13. ^ «diet4j — поставьте Java JAR на диету и загружайте модули maven по мере необходимости» .
  14. ^ «Maven: Полный справочник» . Сонатип. Архивировано из оригинала 21 апреля 2013 года . Проверено 11 апреля 2013 г.
  15. ^ Поисковая система центрального репозитория
  16. ^ "maven.apache.org/eclipse-plugin.html". Архивировано из оригинала 7 мая 2015 года.
  17. ^ «IntelliJ IDEA :: Возможности» . Архивировано из оригинала 24 мая 2015 г. Проверено 2 сентября 2009 г.
  18. ^ «MavenBestPractices — NetBeans Wiki» .

дальнейшее чтение

Внешние ссылки