Wiki

Version 3 (Ahmadi Hadi, May 25, 2011 11:29) → Version 4/14 (Ahmadi Hadi, May 25, 2011 12:01)

h1. Development Environment

This page serves as a guide for developers to set up the dev env required for participating in AgroBank RIB project. It's maintained as a wiki so that everyone be able to improve it by contributing his/her experiences throughout the process of configuring and building the project.

h2. Source Code Repository

https://hub.penril.net/hg/agrobank/agro_rib/ (A _Mercurial_ Repository)

h2. Build Tools

The project definition, its dependencies and other build configs are defined in a file in its root folder named *@pom.xml@*. This file is used by "_Apache Maven_":http://maven.apache.org/ *_Apache Maven_* (http://maven.apache.org/) to build the project. Apache Maven is de facto Java buid management tools that decouple your project structure from IDEs. On the other hand, it's so popular that all Java IDEs have developed plugins to integrate and interpret Maven projects into their expected structures. Another benefit of build tools like Maven is that the project can be build automatically using Continuous Integration servers, like _Jenkins/Hudson_ in our case.

In order to run @mvn@ (Maven command) outside your Eclipse environment you need to download install Maven binaries from "here":http://maven.apache.org/download.html#Maven_2.2.1 and install it following these "instructions":http://maven.apache.org/download.html#Installation . the follow link: http://maven.apache.org/download.html#Maven_2.2.1

Make sure you select *Maven 2.2.1* as this is the version used in this project.

h3. Configuring Maven to point to Penril's Maven repo

To speed up downloading of _artifacts_ required by Maven, a cache proxy is configured at http://219.95.244.226:8080/nexus/ . All you need to force Maven to use this mirror is to put @settings.xml@ file (attached to this wiki) in your @${user.home}/.m2@ directory (For the default value of @user.home@ for your system refer to this "table":http://en.wikipedia.org/w/index.php?title=Home_directory&oldid=429870583#Default_Home_Directory_per_Operating_System ).

h2. Eclipse Plugin for Maven2

*_m2eclipse_* is the recommended plugin to import Maven projects into Eclipse workspace. You can find the installation guide on http://m2eclipse.sonatype.org/installing-m2eclipse.html. Make sure you install both:
* _Maven Integration for Eclipse (Required)_ from *m2eclipse Core*
* _Maven Integration for WTP_ from *m2eclipse Extras*

<pre>

</pre>