summaryrefslogtreecommitdiffstats
path: root/tags/java/sdo/1.0-incubator-M3/sdo/BUILDING.txt
blob: 992710f730b62ae696746848766d11666e3f25b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Building SDO Releases
=====================
The SDO specification source distribution and the SDO implementation source distribution
together with a computer with a live internet connection, maven 2.0.4 installed and java 1.4.2
or above installed are all you need to build
1) the SDO binary distribution
2) the SDO samples source distribution 

Building the SDO Java Implementation Project Binary Release from the source distribution 
========================================================================================
(note,  these instructions are for building the SDO binary release from
source, not for establishing a development environment.  If you wish to
participate in sdo development, follow the instructions at 
http://cwiki.apache.org/confluence/display/TUSCANY/Developing+SDO+Java

Building
--------
In these instructions <archive-root> refers to the common root folder contained in all distribution archives for a particular release, for example "tuscany-sdo-1.0-incubating-M3"

1) Download the corresponding SDO specification source distribution from http://cwiki.apache.org/TUSCANY/sdo-java-download.html
2) Execute the instructions in that archive for building the SDO specification component
Note: following this step you will have maven installed, and a Java JDK at level 1.4.2 or above installed.
3) If you have chosen to install a JDK at level 5 then all will be fine,  but there is one value add component in the
   Tuscany SDO implementation which relies on new JDK 5.0 features.  If you do not wish to use JDK 5 for the following
   build step, then you will need to delete the file
   <archive-root>/sdo/tools/src/main/java/org/apache/tuscany/sdo/generate/Interface2JavaGenerator.java before proceding
4) Change to the top level directory of the Tuscany SDO Java Implementation project (<archive-root>/sdo) of this source distribution.
6) Execute: mvn
   This will install the sdo implementation and tools jars in your local maven repository
5) Execute: mvn package javadoc:javadoc assembly:assembly
   This will build the Tuscany SDO for Java binary distribution artefacts in the sdo/distribution/target
   directory.

Note: Depending on the load being experienced by remote Maven 2.0 repositories you may have to execute mvn several
    times until required dependencies are all located in your local maven repository.  After you have completed a
    full successful build you can use "mvn -o" which builds without trying to access updated build dependencies (offline mode) and is much faster.

6) Currently, due to maven configuration issues, the distribution artefacts at this point contain 2 spurious items, junit-3.8.1.jar and asm-2.2.jar.  In order for the distribution archives to be consistent with the contained license information, these jar files must be manually removed from the archives.  This step will become unnecessary once the issues with maven have been overcome/fixed.

7) To run the sample programs, change directory to the <archive-root>/sdo/sample directory, and run the command "mvn".  Then look in the <archive-root>/sdo/sample/target/site/apidocs/index.html file for javadoc that describes how to run the samples.


Building the SDO Samples Source distribution
============================================

To build the SDO Samples source distribution
1) Build the SDO binary distribution as instructed above
2) From the top level directory of your SDO implementation build tree change directory to the <archive-root>/sdo/sample directory and execute the command mvn javadoc:javadoc to create javadoc for the samples in the <archive-root>/sdo/sample/target/site/apidocs directory
3) copy the <archive-root>/sdo/sample directory from the SDO implementation source distribution to a temporary location with the path <archive-root>/sample below the temporary directory location
4) copy the site/apidocs folder created in step 2 to the temporary directory created for step 3, so that it exists at path <archive-root>/sample/javadoc
5) create .zip and .tar.gz archives containing the sample source and javadoc using the naming convention
apache-<archive-root>-sample.<archive-extension>, such that the archives each contain a single root folder <archive-root>