[Mobies-commit] [commit] r4304 - in UDM/trunk: . bin

Mon Jun 9 05:30:30 CDT 2014

Author: endre
Date: Mon Jun  9 05:30:30 2014
New Revision: 4304

Log:
Finalized MAC OSX Build instructions and 3rdParty archive with all the necessary 3rdParty tools to build UDM on Mac OS X

Added:
   UDM/trunk/bin/udm_macosx_devtools-1.00.tar.gz
Modified:
   UDM/trunk/MACOS_build.txt

Modified: UDM/trunk/MACOS_build.txt
==============================================================================

--- UDM/trunk/MACOS_build.txt	Mon Jun  9 05:16:47 2014	(r4303)
+++ UDM/trunk/MACOS_build.txt	Mon Jun  9 05:30:30 2014	(r4304)
@@ -1,25 +1,25 @@
 
 
-General notice:
-===============
+1. General notice:
+==================
 
 - Only 32 bit version of UDM can be compiled on MAC OS X because there is no Xerces 64bit binary available for this platform and the source will not compile with 64bit arhictecture 
 - Autoconf/automake are not used; Makefile.OSX will build UDM on MAC OS X platforms after updating the paths in 'section to be configured by the user' in Makefile.OSX.incl. This is a more straightforward approach. 
 - XCODE, including the command line tools has to be downloaded from the AppStore, it is freely available.
 - The build procedure was tested on: 
 		
-	OS X 10.9.1
+	OS X 10.9.3
 
 	uname: 
-	3.0.0 Darwin Kernel Version 13.0.0: Thu Sep 19 22:22:27 PDT 2013; root:xnu-2422.1.72~6/RELEASE_X86_64 x86_64
-
+	Darwin Kernel Version 13.2.0: Thu Apr 17 23:03:13 PDT 2014; root:xnu-2422.100.13~1/RELEASE_X86_64 x86_64
+	
 	CC --version:
-	Apple LLVM version 5.0 (clang-500.2.79) (based on LLVM 3.3svn)
-	Target: x86_64-apple-darwin13.0.0
+	Apple LLVM version 5.1 (clang-503.0.40) (based on LLVM 3.4svn)
+	Target: x86_64-apple-darwin13.2.0
 	Thread model: posix
 
-JAVA 6
-======
+2. JAVA 6:
+==========
 
 OS X 10.9.1 comes with Java 1.7.0-45, which can not run a 32 bit JVM
 Therefore, Java 1.6.0 for MAC OS has to be downloaded from here:
@@ -31,6 +31,37 @@
 
 Check and if necessary edit the value of JVMD32 in Makefile.OSX.incl located in the top directory of UDM
 
+
+3. 3rd Party software needed to compile UDM on a Macintosh OSX
+==============================================================
+
+There are a bunch of 3rd Party software tools needed to compile UDM. 
+There are two ways of getting these
+
+	- obtain from ISIS an archive containing all the necessary software to compile UDM: udm_macosx_devtools-1.00.tar.gz
+ 	In this archive there are already compiled binaries of the necessary 3rdParty software, set up to work on Mac OSx for compiling UDM. Untar it to a directory (like ~/devtools). 
+	- obtain&compile each necessary software item, as described below in chapter 5.
+
+4. compiling and testing UDM 	 
+============================
+
+Once the 3rdParty tools are all available, compiling UDM is very easy
+
+ 	- check Makefile.OSX.incl in the top directory, the section marked to be configured by the user. If you obtained the archive from ISIS with the 3rdParty tools for MAC OS and if you untar-ed it to ~/devtools then no change is necessary
+	- compile the project with the command:
+		make -f Makefile.OSX
+	- run the tests with 
+		make -f Makefile.OSX test
+
+
+
+
+
+
+
+5. Setting up environment by downloading and compiling each item.
+=================================================================
+
 ANT
 ===
 
@@ -143,3 +174,48 @@
 SWIG
 ====
 
+SWIG is needed to generate the UDM Java wrapper. 
+
+
+1. Download swig-2.0.11.tar.gz from http://sourceforge.net/projects/swig/files/swig/swig-2.0.11/swig-2.0.11.tar.gz/download
+2. untar to a directory where developer tools are (like ~/devtools/swig-2.0.11)
+3. set/export PCRE_LIBS to .libs/ of the compiled PCRE subdir (like ~/devtools/pcre-8.33/.libs), configure and compile the project with the below steps:
+	
+	cd swig-2.0.11
+	export PCRE_LIBS=~/devtools/pcre-8.33/.libs/libpcre.dylib
+	export CFLAGS="-g -O2 -I ~/devtools/pcre-8.33"
+	./configure
+	make
+4. set/change the value of SWIGDIR to the directory of Swig in Makefile.OSX.incl located in top directory of UDM (example: ~/devtools/swig-2.0.11)
+
+
+XERCES
+======
+
+Xerces is needed by the UdmDom backend to read-write UML documents
+We use a binary prepared by Apache as I was unable to compile Xerces for MAC OS X platform. Unfortunatelly, only a 32bit binary is available:
+
+1. Download the binary release of Xerces C++ 2.8.0 from: http://mirrors.hostingromania.ro/apache.org//xerces/c/2/binaries/xerces-c_2_8_0-x86-macosx-gcc_4_0.tar.gz (or from any other hosting site)
+2. untar it to a directory where developer tools are (like ~/devtools/xerces-c_2_8_0-x86-macosx-gcc_4_0)
+3. set/change the value of XERCESCROOT in Makefile.OSX.incl located in top directory of UDM (example =~/devtools/xerces-c_2_8_0-x86-macosx-gcc_4_0)
+
+XALAN
+=====
+
+Xalan is needed to convert UML diagrams to XMI files 
+
+1. Download the source release xalan_c-1.11-src.tar from http://www.apache.org/dyn/mirrors/mirrors.cgi/xalan/xalan-c/sources
+2. untar it ro a directory where developer tools are (like ~/devtools/xalan-c-1.11)
+3. Configure and compile the project, using the following commands
+	cd xalan-c-1.11
+	export XALANCROOT=~/devtools/xalan-c-1.11/c/
+	export XERCESCROOT=~/devtools/xerces-c_2_8_0-x86-macosx-gcc_4_0
+	export CFLAGS="-arch i386"
+	export CXXFLAGS="-arch i386"
+	export LDFLAGS="-arch i386"
+	./runConfigure -p macosx -b 32
+	make
+4. set/change the value of XALANCROOT in Makefile.OSX.incl located in top directory of UDM (example =~/devtools/xalan-c-1.11/c)
+
+	
+	

Added: UDM/trunk/bin/udm_macosx_devtools-1.00.tar.gz
==============================================================================
Binary files /dev/null	00:00:00 1970	(empty, because file is newly added) and UDM/trunk/bin/udm_macosx_devtools-1.00.tar.gz	Mon Jun  9 05:30:30 2014	(r4304) differ
