Да, документация не самая лучшая. Тем не менее, Maven спасает жизнь при попытке управлять средним и крупным проектом. Из-за этого факта my жизни добавление библиотеки с открытым исходным кодом, которая отсутствует на maven, является проблемой.
Преимущество maven заключается не только в автоматической загрузке зависимостей, но и в навязывании стандартной структуры каталогов, что означает, что я могу создавать сценарии для любой библиотеки, которую мы используем, внутренней или с открытым исходным кодом.
Самые большие минусы Maven:
- очень многословная командная строка.
- документация загадочна и разбросана
- нет универсальной справочной службы
Тем не менее, моим решением многих из этих проблем является пользовательский файл ant build.xml с моими стандартными целями mvn, определенными как более простые цели ant (что также позволяет мне добавлять свой собственный текст справки.)
Обновление:
Я действительно должен сказать, что документация загадочна. Большая часть моего опыта с типичным разработчиком Maven в отношении документации описывается этим обменом:
Я: «Я не понимаю, как это сделать, и код ведет себя очень плохо.»
Them: "Предлагаемый способ решения этой проблемы - загрузить рассматриваемый DTD и использовать преобразователь каталога. См. Свойство" catalogs "в http://mojo.codehaus.org/xml-maven-plugin/validation.html"
(Их предложение включает в себя несколько страниц без единого полного примера)
Я: Восхитительно. RTFM. Это сделало бы этот плагин более полезным для пользователей, у которых нет времени на расшифровку руководства, если бы был предоставлен хороший пример для этого очень распространенного варианта использования.
Их: Извините, но я не могу следовать за вами. В документации к «свойству каталога» (см. Ссылку выше) четко показано, как настроить использование файла каталога.
Я: Как мой друг, умный парень, работает в Google, сказал это:
«Да, в документации точно сказано, как это сделать, если вы знаете, как это сделать».