Include only local subsections into TOC. This prevent duplication of
TOC when build single page HTML document. Also this make unnecessary CSS hack
to hide document title as top level section.
.. -*- coding: utf-8; -*-
.. include:: HEADER.rst
========
Maven.
========
.. contents::
:local:
Maven tutorial.
===============
* http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html
* http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html
Maven FAQ.
==========
* http://maven.apache.org/general.html
Maven plugins.
==============
* http://maven.apache.org/plugins/
Maven config location.
======================
``~/.m2/settings.xml``.
Generate simple project.
========================
::
$ mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
Debug Maven build.
==================
Run build with ``-X`` option for verbose logging.
Project directory layout.
=========================
http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html
Introduction to the Standard Directory Layout.
Search for maven artifact by Java package or class name.
========================================================
* https://repository.sonatype.org/
* http://search.maven.org/
Get help on Maven plug-in.
==========================
::
$ mvn help:describe -DartifactId=maven-war-plugin -DgroupId=org.apache.maven.plugins
$ mvn help:describe -Dcmd=dependency:resolve -Ddetail
$ mvn dependency:tree
$ mvn dependency:list
$ mvn dependency:resolve
$ mvn dependency:resolve-plugins
$ mvn -X ...
Reason for inclusion or omitting dependencies::
$ mvn dependency:tree -Dverbose=true
What actual code processed by Maven (dump Maven config)::
$ mvn help:effective-settings
$ mvn help:effective-pom
Force update of dependencies.
=============================
You can try redownload snapshots by::
$ mvn -U compile
You can fix damaged local ``~/.m2`` with::
$ mvn dependency:purge-local-repository
In order to perform really clean download::
$ mvn -Dmaven.repo.local=$HOME/.my/other/repository clean install
Find newer library and plugin versions.
=======================================
Check commands from ``versions-maven-plugin``::
$ mvn versions:display-dependency-updates
$ mvn versions:display-plugin-updates
Run Java main from Maven.
=========================
::
mvn exec:java -Dexec.mainClass="com.vineetmanohar.module.Main" -Dexec.args="arg0 arg1 arg2"
How to run single unit test?
============================
``test`` property substituded to ``**/${test}.java`` pattern and override any
include/exclude patterns::
$ mvn test -Dtest=SeriousComponentTest
or mostly same::
$ mvn test-compile surefire:test -Dtest=RunMe
How do I skip the tests during the default lifecycle?
=====================================================
::
$ mvn -DskipTests package
$ mvn -Dmaven.test.skip=true package
Download all external dependencies sources and javadocs.
========================================================
::
mvn dependency:resolve -Dclassifier=javadoc
mvn dependency:resolve -Dclassifier=sources
Deploy parent pom without building children.
============================================
::
$ mvn -N deploy
Run Ant from Maven.
===================
* https://support.sonatype.com/entries/20736282-executing-an-external-ant-script-in-a-maven-build
* https://support.sonatype.com/entries/20723081-running-an-inline-ant-script-in-a-maven-build
* https://support.sonatype.com/entries/20744068-writing-a-maven-plugin-with-ant