diff options
Diffstat (limited to 'site/branches/site-20070701-mvnbased/site-author/building_source.xml')
| -rw-r--r-- | site/branches/site-20070701-mvnbased/site-author/building_source.xml | 212 |
1 files changed, 212 insertions, 0 deletions
diff --git a/site/branches/site-20070701-mvnbased/site-author/building_source.xml b/site/branches/site-20070701-mvnbased/site-author/building_source.xml new file mode 100644 index 0000000000..3897068442 --- /dev/null +++ b/site/branches/site-20070701-mvnbased/site-author/building_source.xml @@ -0,0 +1,212 @@ +<?xml version="1.0" encoding="UTF-8"?>
+<document>
+ <properties>
+ <title>Building Tuscany Source Code</title>
+ <bannertitle>Building Tuscany Source Code</bannertitle>
+ </properties>
+ <body>
+ <section name="Building Tuscany Source Code">
+
+ <p>This page provides information related to building Tuscany (SCA/SDO/DAS ) Source Code (Java/C++).</p><table border="0" bgcolor="white" width="100%">
+ <tbody>
+ <tr bgcolor="#e0e0c2">
+ <td><b><font color="#004566">Building Tuscany Java SCA / SDO / DAS</font></b></td>
+ </tr>
+ <tr bgcolor="white">
+ <td bgcolor="white" valign="top">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: <table border="0" width="100%">
+ <tbody>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">1.</td>
+ <td width="605" valign="top">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: -<table border="0" width="100%">
+ <tbody>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><a
+ href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/">Source
+ code for Tuscany Java SCA</a></td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><a
+ href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sdo/">Source
+ code for Tuscany Java SDO</a></td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><a
+ href="http://svn.apache.org/repos/asf/incubator/tuscany/java/das/">Source
+ code for Tuscany Java DAS</a></td>
+ </tr>
+ </tbody>
+ </table>
+ <br />Alternatively, you may download the source distribution from the releases for SCA / SDO / DAS. The release can be found at the following links: -<a
+ href="http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/"></a><table border="0" width="100%">
+ <tbody>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><a
+ href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V095.pdf?version=4">
+ <span class="nobr"><a
+ href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V096.pdf?version=1"
+ title="SCA_AssemblyModel_V096.pdf attached to Service Component Architecture Specifications"></a></span></a><a
+ href="sca_downloads.html">Tuscany SCA Downloads</a><a
+ href="http://www.osoa.org/download/attachments/35/SCA_AssemblyModel_V095.pdf?version=4"></a></td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><a href="sdo_downloads.html">Tuscany
+ SDO Dowloads</a></td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td width="567" bgcolor="#fffff4"><span class="nobr"><a
+ href="http://www.osoa.org/download/attachments/287/Next-Gen-Data-Programming-Whitepaper.pdf?version=1"
+ title="Next-Gen-Data-Programming-Whitepaper.pdf attached to SDO Resources"></a></span><a
+ href="das_downloads.html">Tuscany DAS Downloads</a></td>
+ </tr>
+ </tbody>
+ </table></td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">2.</td>
+ <td width="605" valign="top">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 <a
+ href="http://subversion.tigris.org/">http://subversion.tigris.org/</a>. Ensure that you download a version that is greater or equal to 1.3.0<br />
+ <br />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.<br />
+ <br />
+ <i><font face="Courier New">"svn co
+ http://svn.apache.org/repos/asf/incubator/tuscany/java/ ."</font></i><br />
+ <br />
+ 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 <a
+ href="http://subclipse.tigris.org/">http://subclipse.tigris.org/</a>. Using this plugin you may work with the Tuscany Subversion Repository from within your Eclipse IDE.<br />
+ <br />
+ <br />Alternatively, if you have downloaded on the source distributions from the releases, then extract the distribution to you local system.</td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">3.</td>
+ <td width="605" valign="top">To compile Tusacny Java SCA / SDO / DAS source you must ensure you have the appropriate level of JDK installed on your local system.<br />
+ <table border="0">
+ <tbody>
+ <tr>
+ <td width="10"></td>
+ <td bgcolor="#fffff4" width="75">SCA </td>
+ <td bgcolor="#fffff4" width="226">JDK 5.0 </td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td bgcolor="#fffff4" width="75">SDO </td>
+ <td bgcolor="#fffff4" width="226">JDK 1.4</td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td bgcolor="#fffff4" width="75">DAS </td>
+ <td bgcolor="#fffff4" width="226">JDK 5.0</td>
+ </tr>
+ </tbody>
+ </table></td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">4.</td>
+ <td width="605" valign="top">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 <a
+ href="http://maven.apache.org/">http://maven.apache.org/</a><br />
+ <br />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 :<br />
+ <br />
+ <i><font face="Courier New">"mvn"<br />
+ <br /></font></i>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.<br />
+ <br />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.<br />
+ <br />
+ <i><font face="Courier New">"mvn -o"</font></i></td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">5.</td>
+ <td width="605" valign="top">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: -<br />
+ <br />
+ <u>a) To import Tuscany projects into Eclipse IDE</u> execute the following command<br />
+ <br />
+ <i><i><font face="Courier New">"mvn -Peclipse eclipse:eclipse"</font></i></i>
+ <br />
+ <br />This will create the necessary ".<i>project" and ".classpath" </i>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.</td>
+ </tr>
+ </tbody>
+ </table>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<br />
+<br />
+<table border="0" bgcolor="white" width="100%">
+ <tbody>
+ <tr bgcolor="#e0e0c2">
+ <td><b><font color="#004566">Building Tuscany C++ SCA / SDO </font></b></td>
+ </tr>
+ <tr bgcolor="white">
+ <td bgcolor="white" valign="top">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:
+ <br /><table border="0" width="100%">
+ <tbody>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">1.</td>
+ <td width="605" valign="top">
+ The main Tuscany project repository is located at <a href="https://svn.apache.org/repos/asf/incubator/tuscany">
+ https://svn.apache.org/repos/asf/incubator/tuscany</a>.
+ 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 <a href="https://svn.apache.org/repos/asf/incubator/tuscany/cpp">
+ https://svn.apache.org/repos/asf/incubator/tuscany/cpp</a>, to get the SCA and SDO implementations for C++.</td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">2.</td>
+ <td width="605" valign="top">
+ You can find detailed instructions on how to configure the C++ runtime and tools for <a href="./cpp_setup_linux.html">Linux</a>
+ and <a href="./cpp_setup_win.html">Windows</a>
+ </td>
+ </tr>
+ <tr bgcolor="#f8f8fb">
+ <td width="17" align="center" valign="top">3.</td>
+ <td width="605" valign="top">
+ In order to run the Tuscany C++ runtimes there are some minimum system requirements:
+ <table border="0">
+ <tbody>
+ <tr>
+ <td width="10"></td>
+ <td bgcolor="#fffff4" width="134">Operating System</td>
+ <td bgcolor="#fffff4" width="324">
+ <ul>
+ <li>Windows XP SP2</li>
+ <li>Linux</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td width="10"></td>
+ <td bgcolor="#fffff4" width="134">Other components</td>
+ <td bgcolor="#fffff4" width="324">
+ <ul>
+ <li><a href="http://ws.apache.org/axis2/c/"> Apache Axis2/C
+ verion 0.92 </a></li>
+ <li><a href="http://xmlsoft.org/downloads.html"> Libxml2
+ Parser version 2.6.20 </a></li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+ </table></td>
+ </tr>
+ </tbody>
+ </table>
+ </td>
+ </tr>
+ </tbody>
+</table>
+<p></p>
+
+</section>
+
+ </body>
+</document>
+
+
+
+
|