QConnector

h1. Build components from sources

This section describes how to compile and build component from source files.

Most of the projects are built and maintained using Maven and versioning using SVN. Therefore, you should be familiar with the tools below:

* Maven http://maven.apache.org/

* SVN http://subversion.apache.org/

* *nix shell commands

*Requires the following software to be installed in the build environment:*

* Maven http://maven.apache.org/

* SVN http://subversion.apache.org/

Before continue, please prepare the following information:

* module or component name, e.g. _ecwyadaptor_

* module or component version, e.g. _1.0-SNAPSHOT_

* the SVN URL, e.g. http://192.168.2.13:50000/svn/qconnector/tags/{module_name}_{module_version}/{module_name}

For demonstrate purpose, we will build the following module:

* *module name:* soap-adaptor

* *module version:* 0.5.2-SNAPSHOT

* *SVN URL:* http://192.168.2.13:50000/svn/qconnector/tags/soap-adaptor_0_5_2_SNAPSHOT/soap-adaptor

** dot(.) is not allowed in tag name so replace the dot with underscore(_)

*Steps:*

# checkout the project from SVN

<pre>

$ svn co http://192.168.2.13:50000/svn/qconnector/tags/soap-adaptor_0_5_2_SNAPSHOT/soap-adaptor

</pre>

# <code>cd</code> to the checkout-ed folder, <code>soap-adaptor</code>

<pre>

$ cd soap-adaptor

</pre>

# execute the maven command to compile and build the module:

<pre>

$ mvn clean package

</pre>

## You could skip the unit tests but *strongly* not recommended:

<pre>

$ mvn -Dmaven.test.skip=true clean package

</pre>

# if no error, the binary file of the module can be found in *target/{module name}-{module version}.jar*, e.g. _soapadaptor-0.5.2-SNAPSHOT.jar_

# done