Building
Camel uses Maven as its build tool. If you don't fancy using Maven you can use your IDE directly or Download a distribution or JAR.
Prequisites
Required:
- Download and install Maven. (Currently Maven 2.0.9 is used to build the official releases, some components will not build with 2.1+)
- Get the latest Source
- Java 1.5
Optional:
- Prince should be in the executable PATH to generate the PDF documentation
Maven options
To build camel maven has to be configured to use more memory
set MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=128m
A normal build
mvn install
Doing a Quick Build
The following avoids running all the unit test cases, we just skip the test running phase and not the building part
mvn -DskipTests clean install
Using an IDE
If you prefer to use an IDE then you can auto-generate the IDE's project files using maven plugins. e.g.
mvn eclipse:eclipse
or
mvn idea:idea
Adding Camel Eclipse templates to your workspace
mvn -Psetup.eclipse -Declipse.workspace.dir=/path/to/your/workspace
You can also find some helpful notes on usage here.
Importing into Eclipse
If you have not already done so, you will need to make Eclipse aware of the Maven repository so that it can build everything. In the preferences, go to Java->Build Path->Classpath and define a new Classpath Variable named M2_REPO that points to your local Maven repository (i.e., ~/.m2/repository on Unix and c:\Documents and Settings\<user>\.m2\repository on Windows).
You can also get Maven to do this for you:
mvn eclipse:add-maven-repo -Declipse.workspace=/path/to/the/workspace/
Building with checkstyle
To enable source style checking with checkstyle, build Camel with the -Psourcecheck parameter
mvn -Psourcecheck clean install
Building source jars
If you want to build jar files with the source code, that for instance Eclipse can important so you can debug the Camel code as well. Then you can run this command from the camel root folder:
mvn clean source:jar install -Dtest=false
Building with Spring 3.0
Camel is shipped build with Spring 2.5.6. If you want Camel to be build against Spring 3.0 you have to build with the maven profile spring-3.x.
mvn clean install -Pspring-3.x
You may want to skip testing and do a fast build
mvn clean install -Pspring-3.x -Dtest=false
Working with features
If you change anything in the features.xml from platform/karaf you can run a validation step to ensure the generated features.xml file is correct. You can do this running the following maven goal from the platform directory.
mvn clean install -Pvalidate