Building Tuscany Source Code

This page provides information related to building Tuscany (SCA/SDO/DAS ) Source Code (Java/C++).

Building Tuscany Java SCA / SDO / DAS
If you are building the source for Tuscany Java SCA or Java SDO or Java DAS, then the procudure to be followed is the same for all three and is as follows:
1. Ensure that you have downloaded the relevant (Java SCA / SDO / DAS) source code from the Apache Tuscany Subversion Repository. Here are the links for the source in that repository: -
Source code for Tuscany Java SCA
Source code for Tuscany Java SDO
Source code for Tuscany Java DAS

Alternatively, you may download the source distribution from the releases for SCA / SDO / DAS. The release can be found at the following links: -
Tuscany SCA Downloads
Tuscany SDO Dowloads
Tuscany DAS Downloads
2. If you wish to download the source from the Subversion Repository then you must first install the Subversion client. Information related to Subversion - such as downloading, installing etc. can be found at http://subversion.tigris.org/. Ensure that you download a version that is greater or equal to 1.3.0

After installing the Subversion client you can download the source from the links mentioned in the previous point. For example here is the command that will download all of SCA, SDO and DAS into the present working directory.

"svn co http://svn.apache.org/repos/asf/incubator/tuscany/java/ ."

Subversion also provides clients that plug into popular IDEs such as Eclipse. The Subversion plugin for Eclipse is know as Subclipes and can be obtained from http://subclipse.tigris.org/. Using this plugin you may work with the Tuscany Subversion Repository from within your Eclipse IDE.


Alternatively, if you have downloaded on the source distributions from the releases, then extract the distribution to you local system.
3. To compile Tusacny Java SCA / SDO / DAS source you must ensure you have the appropriate level of JDK installed on your local system.
SCA JDK 5.0
SDO JDK 1.4
DAS JDK 5.0
4. Next, to build the source you need the build tool called Maven with a version greater than or equal to 2.0.4. Information about downloading, installing and setting up Maven can be found at http://maven.apache.org/

After installing and setting up Maven, go to the root of the source (downloaded using SVN or extracted from release) on your local system and simply issue the following command :

"mvn"

You can execute this command either from the sub-directory that contains all of SCA, SDO and DAS source code (if you have downloaded all of them) or inside one of the modules (or sub-directory within) - SCA or SDO or DAS.

Ensure that you are connected to the Internet when building since all dependencies required to build Tuscany SCA / SDO / DAS will be dynamically downloaded by Maven from various repositories on the Internet. Once you have successfully built, subsequent builds can be done offline (without connecting to the Internet) using the following command as long as no additional dependencies are added after the previous online build.

"mvn -o"
5. Now that Tuscany Source has be downloaed and built you can start any modifications or enhancements to the source. However, development is alwasy preferred to be done with the help of IDEs. In order to import the Tuscany Projects into various IDEs, you must have to first create the corresponding configuration (say project and classpath) information relevant to each IDE. This again is doen using the Maven tool specifying appropriate targets as follows: -

a) To import Tuscany projects into Eclipse IDE execute the following command

"mvn -Peclipse eclipse:eclipse"

This will create the necessary ".project" and ".classpath" files inside the Tuscany source directories on your local system. Then you may open the Eclipse IDE and exercise the "Import Projects' option, pointing to the Tuscany source directory for the location of the projects.


Building Tuscany C++ SCA / SDO
If you are building the source for Tuscany C++ SCA or C++ SDO then the procudure to be followed is the same for both and is as follows:
1. The main Tuscany project repository is located at https://svn.apache.org/repos/asf/incubator/tuscany. You can use SVN to check out the entire project, and you will get both the java and C++ repositories. Alternatively you can check out just the cpp directory at https://svn.apache.org/repos/asf/incubator/tuscany/cpp, to get the SCA and SDO implementations for C++.
2. You can find detailed instructions on how to configure the C++ runtime and tools for Linux and Windows
3. In order to run the Tuscany C++ runtimes there are some minimum system requirements:
Operating System
  • Windows XP SP2
  • Linux
Other components