ServiceMix 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.
We have tested the build with Maven 2.0.6 and it works fine.
Previous / later versions of Maven may vary - if you hit problems on other versions please talk to us on the Mailing Lists.
Be sure to read the FAQ
Getting started
- Download and install Maven.
- Get the latest code from SVN
- Build the code with the following command
mvn -Dmaven.test.skip=true -Dprofile=step1 install mvn -Dmaven.test.skip=true -Dprofile=step2 install
Next time you build, you can just run
mvn -Dmaven.test.skip=true install
Building 3.1.1
If an out of memory error is encountered when building 3.1.1,
setting the following environmental variable may help
MAVEN_OPTS=-Xmx768m
Building 3.0-M1 and 3.0-M2
Note that this only works for versions from 3.0-M3.
To build previous versions, you need to run:
mvn -N install
cd tooling
mvn install -Dmaven.test.skip=true
cd ..
mvn install -Dmaven.test.skip=true
Code Conventions
Checkstyle and PMD rules are used to scour the ServiceMix source code when performing a build. If you are hacking code and it does not follow these conventions, the build will fail. To make things easier on folks who are using Eclipse, there is an Eclipse code convention profile that matches the Checkstyle conventions, making things a bit easier in this regard. Import this profile into Eclipse under Preferences->Java->Code Style->Formatter->Import.
Using an IDE
Using Eclipse
For Eclipse, a detailed description is given at Importing ServiceMix into Eclipse. In addition, this page also describes how to start ServiceMix inside Eclipse with all debugging possibilities.
Other IDEs
If you prefer to use another IDE then you can autogenerate the IDE's project files using maven plugins. e.g.
mvn idea:idea
etc.
Note that you may need to build the whole ServiceMix project once using maven.
Please refer to the plugin reference for more details on using them.