Getting stated is always hard. First of all if you only want to start using mmapps packages the best thing todo is not to read this page at all but read the site documentation and download the jars from the distributions. On the other hand if you want to help with mmapps you have to read this page and go throug the process of installing maven
Download maven
wget http://httpd.kookel.org/maven/binaries/maven-1.0.tar.gz tar zxvf maven-1.0.tar.gz ln -s maven-1.0 maven
MAVEN_HOME=/home/keesj/local/maven PATH=$PATH:$MAVEN_HOME/bin export MAVEN_HOME PATH
. ~/.bash_profile
__ __ | \/ |__ _Apache__ ___ | |\/| / _` \ V / -_) ' \ ~ intelligent projects ~ |_| |_\__,_|\_/\___|_||_| v. 1.0
Now you know everything about maven it's time to customize maven so it kowns about the mmapps repository. In the mmapps cvs repository we keep 2 files from wich every mmapps project make use. The first one is mmapps-project.xml and defines the location of the cvs and the default reports to create. The second one project.properties define the defaults for the most used maven plugins. If you want to override the plugin defaults edit ~/build.properties (one of the default locations to store global configurations) or to alter the mmapps-project.xml override the defaults in your project.xml file. The minimal configuration required in your ~/build.properties is the following.
maven.username=keesj maven.group=mmapps maven.remote.group=mmapps
Getting maven to run on windows machines might be a bit more difficult, if you want to deploy to a remote repository and are not running cygwin you a least need to add the following lines to you personal build.properties so that maven uses the putty scp copy programs. You also need to start the putty agent: pageant and load it with your sourceforge private key.
maven.scp.executable=pscp #maven.ssh.executable=plink maven.scp.args=-q -batch -1 -i c:\apps\putty\identity.ppk maven.ssh.args=-batch -1 -i c:\apps\putty\identity.ppk
maven site | Create the project site (result in target/docs) |
maven site:deploy | Publish the site on mmapps.sourceforge.net |
maven jar | Create a jar file containing the compiled code for you app |
maven jar:install | Install the jar on your local repository so that other modules can use it |
maven jar:deploy | Publish the jar to http://mmapps.sourceforge.net/distributions/ |
maven eclipse | Create a eclipse .project file |
maven uberjar | Create a jar file containing all the jars used by the project |
maven xdoc | generate the user documentation(ussefull when you are writing xdocs and maven site takes to long) |
maven jnlp | create a webstart application and sing the archieves |
maven multi:site deploy | this can be called to redeploy all the mmapps sites (to be called from the mmapps directory) |