Jump to: navigation, search

Difference between revisions of "Maven Tools 4 Eclipse"

(Added download link)
Line 11: Line 11:
 
A simple workflow:
 
A simple workflow:
  
# Create a folder to work. Download the tool and put it into this folder. '''TODO''' I've asked to upload the tool on an Eclipse site; I'll post the link here. For the time being, you can build the tool from sources (see below).
+
# Create a folder to work. [http://www.eclipse.org/downloads/download.php?file=/technology/dash/org.eclipse.dash.mt4e-0.9.0-SNAPSHOT-jar-with-dependencies.jar Download the tool] and put it into this folder.
 
# Download an Eclipse release from http://www.eclipse.org/downloads/ into a new folder <tt>downloads</tt> inside the work folder.
 
# Download an Eclipse release from http://www.eclipse.org/downloads/ into a new folder <tt>downloads</tt> inside the work folder.
 
# Download the sources for the Eclipse release and/or other archives which contain Eclipse products or OSGi bundles.
 
# Download the sources for the Eclipse release and/or other archives which contain Eclipse products or OSGi bundles.

Revision as of 15:52, 24 August 2011

Maven Tools 4 Eclipse (or m4e for short) is a set of tools to convert OSGi bundles into Maven artifacts.

You can find the source on http://git.eclipse.org/c/dash/org.eclipse.dash.m4e.tools.git/

This tool is used to create the Maven artifacts which you can find on Eclipse's Nexus server at http://maven.eclipse.org/nexus/index.html

How it works

Replace RUN below with java -jar org.eclipse.dash.mt4e-0.9.0-SNAPSHOT-jar-with-dependencies.jar

A simple workflow:

  1. Create a folder to work. Download the tool and put it into this folder.
  2. Download an Eclipse release from http://www.eclipse.org/downloads/ into a new folder downloads inside the work folder.
  3. Download the sources for the Eclipse release and/or other archives which contain Eclipse products or OSGi bundles.
  4. Import everything into a temporary Maven repo tmp/m2repo using RUN convert org.eclipse.dash:dependency-management:3.7.0 (you may want to tweak the version number)
  5. Check the report generated for any problems you may want to fix. Create a patch file (probably using the examples) to do that
  6. Repeat until you're happy with the results
  7. Upload the content of tmp/m2repo/ somewhere where Maven can find it (~/.m2/repository/ or your Maven proxy).

convert is actually a wrapper for these commands:

  1. Importing every archive in the folder downloads into a temporary Maven repo using RUN import archive
  2. Merge all repositories using RUN merge directories... tmp/m2repo
  3. The sources are in the wrong place. Fix that with RUN attach-sources tmp/m2repo
  4. Fix any know problems by applying the patches in the patches/ folder using the tool RUN apply-patches tmp/m2repo patches...
  5. Check the result with RUN analyze tmp/m2repo
  6. Create a POM with the version info to make sure your build picks the correct versions using the RUN dm tmp/m2repo groupId:artifactId:version
  7. If anything goes wrong, use RUN clean to clean up temporary files and start over.

Building From Source

  1. git clone git://git.eclipse.org/gitroot/dash/org.eclipse.dash.m4e.tools.git
  2. org.eclipse.dash.m4e.tools will be our work directory
  3. Download everything you will want and put it into the folder org.eclipse.dash.m4e.tools/downloads/
  4. Compile the code with Maven: mvn install
  5. See above how to use the tool

How do I import the result in a Nexus server?

It's very tedious to deploy the files one by one. Here is a recipe to mass-upload them:

  1. Create a "Hosted Repository" on Nexus
  2. Copy the files from tmp/m2repo/ into sonatype-work/nexus/storage/<name>/ where <name> is the name of the new repository.
  3. Open the Nexus UI in your web browser
  4. Login as admin
  5. Open the "Repositories" tab
  6. Right click on the hosted repository
  7. Select "Rebuild Metadata"

After that, Maven should be happy.

Support

Please file an issue for Project Dash, Component Maven.

Biggest Issues Right Now

  1. The name m4e sucks. Suggestions?
  2. Find the time to create a repo with Eclipse 3.7

Old Python Version

You can find the original Python project on Github: https://github.com/digulla/org.eclipse.dash.m4e.tools/

It needs Python 2.7 and lxml.