lucene/dev-tools/maven
Steven Rowe ddf5806662 LUCENE-3545: Upgrade ASF parent POM, Maven Ant Tasks, and Maven plugins to the most recent versions
git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1195315 13f79535-47bb-0310-9956-ffa450edef68
2011-10-31 02:46:51 +00:00
..
lucene fix copy-paste-o in program name in appassembler-maven-plugin configuration 2011-10-25 21:22:25 +00:00
modules LUCENE-3261: Maven configuration: added facet module dependency to the benchmark module 2011-10-14 17:21:57 +00:00
solr SOLR-2588: added Maven configuration for the new Velocity contrib 2011-10-26 20:26:49 +00:00
README.maven - Added Ryan McKinley's example POM snippet to the section about using the Jenkins-published nightly Maven snapshots 2011-07-25 22:28:15 +00:00
pom.xml.template LUCENE-3545: Upgrade ASF parent POM, Maven Ant Tasks, and Maven plugins to the most recent versions 2011-10-31 02:46:51 +00:00

README.maven

====================================
Lucene/Solr Maven build instructions
====================================

Contents:

A. How to use nightly Jenkins-built Lucene/Solr Maven artifacts
B. How to generate Lucene Maven artifacts
C. How to generate Solr Maven artifacts
D. How to use Maven to build Lucene/Solr

-----

A. How to use nightly Jenkins-built Lucene/Solr Maven artifacts

   The most recently produced nightly Jenkins-built Lucene and Solr Maven
   artifacts are available in Maven repository layout here:
   
      <https://builds.apache.org/hudson/job/Lucene-Solr-Maven-trunk/lastSuccessfulBuild/artifact/maven_artifacts/>
      
   An example POM snippet:
   
     <project ...>
       ...
       <repositories>
         ...
         <repository>
           <id>lucene-solr-jenkins-trunk</id>
           <name>Lucene/Solr Jenkins trunk</name>
           <url>https://builds.apache.org/job/Lucene-Solr-Maven-trunk/lastSuccessfulBuild/artifact/maven_artifacts</url>
           <layout>default</layout>
           <snapshots>
             <enabled>true</enabled>
           </snapshots>
         </repository>


B. How to generate Lucene Maven artifacts

   1. Prerequisites: JDK 1.6+ and Ant 1.7.X

   2. Run the following command from the lucene/ directory:

         ant generate-maven-artifacts
	  
      The above command will create an internal Maven repository under
      lucene/dist/maven/, including POMs, binary .jars, source .jars,
      and javadoc .jars, for Lucene Core, for the Lucene test framework,
      for each contrib, and for each module under the top-level modules/
      directory.


C. How to generate Solr Maven artifacts

   1. Prerequisites: JDK 1.6+ and Ant 1.7.X 

   2. Run the following from the solr/ directory:

         ant generate-maven-artifacts
		 
      The above command will create an internal Maven repository under
      solr/package/maven/, including POMs, binary .jars, source .jars,
      and javadoc .jars, for Solr Core, for the Solr test framework,
      for each contrib, and for the Solr .war (for which there are no
      source or javadoc .jars).


D. How to use Maven to build Lucene/Solr

   In summary, to enable Maven builds, perform the following:

         svn update
         ant get-maven-poms
         mvn -N -Pbootstrap install

   The details, followed by some example Maven commands:

   1. Prerequisites: JDK 1.6+ and Maven 2.2.1 or 3.0.X

   2. Make sure your sources are up to date.  If you checked your sources out
      from the Apache Subversion repository, run "svn update" from the top
      level.

   3. Copy the Maven POM templates from under dev-tools/maven/ to where they
      they need to go in order to drive the Maven build, using the following
      command from the top-level directory:

         ant get-maven-poms

      Note that you will need to do this whenever changes to the POM
      templates are committed.  It's a good idea to follow every "svn update"
      with "ant get-maven-poms" for this reason.

      The above command copies all of the POM templates from dev-tools/maven/,
      filling in the project version with the default "X.X-SNAPSHOT".  If you
      want the POMs and the Maven-built artifacts to have a version other than
      the default, you can supply an alternate version on the command line
      with the above command, e.g.:

         ant -Dversion=4.0-my-special-version get-maven-poms

   4. Populate your local repository with .jars & POMs for dependencies that
      are not available from public Maven repositories (a.k.a. "non-mavenized
      dependencies"):

         mvn -N -Pbootstrap install

      Note that you will need to do this whenever changes to the non-Mavenized
      dependencies are committed.  It's a good idea to follow every
      "svn update" with "ant get-maven-poms" and "mvn -N -Pbootstrap install"
      for this reason.


   Some example Maven commands you can use after you perform the above
   preparatory steps:

   - Compile, package, and install all binary artifacts to your local
     repository:

         mvn install

     After compiling and packaging, but before installing each module's 
     artifact, the above command will also run all the module's tests.

   - Compile, package, and install all binary artifacts to your local
     repository, without running any tests:

         mvn -DskipTests install

   - Compile, package, and install all binary and source artifacts to your
     local repository, without running any tests:

         mvn -DskipTests source:jar-no-fork install

   - Run all tests:

         mvn test

   - Run all test methods defined in a test class:

         mvn -Dtest=TestClassName test