= MacOSX Build = Note, this page is being updated, in the interim please refer to [http://download.osgeo.org/ossim/docs/pdfs/OssimBuildInstructions_v1.4.pdf OSSIM Build Instructions V 1.4] == Binary Installer == The easiest way to get up and running is to install the latest binary installer. During initial development, a fairly recent version of the software will be available at http://download.osgeo.org/ossim/installers/mac/ Look for and download the dmg file which will should mount after download. Double click the package installer and the libararies and frameworks will be installed in [[standard locations]]: == Development == OSSIM Build Documentation for Mac OS X Dave Lucas - ossimdave@me.com If necessary, download and install CMake version 2.8.x http://www.cmake.org/cmake/resources/software.html 1. Open up a terminal, checkout the svn source tree into ossim-svn in your home directory. {{{ cd mkdir ossim-svn cd ossim-svn svn co http://svn.osgeo.org/ossim/trunk src mkdir release }}} 2. Download the OSSIM Dependencies http://download.osgeo.org/ossim/dependencies/mac/ossim_dependencies.tgz Move the downloaded file into /Users/Shared/Development {{{ mv ~/Downloads/ossim_dependencies.tgz /Users/Shared/Development }}} 3. Extract the ossim_dependencies.tgz using tar (double click in finder, or {{{ cd /Users/Shared/Development tar -xvf ossim_dependencies.tar }}} 4. Remove the ossim_dependencies.tgz (optional) {{{ rm ossim_dependencies.tgz }}} 5. Set up the Standard Environment Variables '''OSSIM_DEV_HOME''' will point to ~/ossim-svn/src '''OSSIM_INSTALL_PREFIX''' will point to ~/ossim-svn/release '''OSSIM_DEPENDENCIES''' will point to /Users/Shared/Development/ossim_dependencies Create an '''ossim-bashrc''' file under ossim-svn/ to hold these variables: {{{ export OSSIM_DEV_HOME=~/ossim-svn/src export OSSIM_INSTALL_PREFIX=~/ossim-svn/release export OSSIM_DEPENDENCIES=/Users/Shared/Development/ossim_dependencies export PATH=$OSSIM_INSTALL_PREFIX/bin:$PATH LD_LIBRARY_PATH=$OSSIM_INSTALL_PREFIX/lib:$OSSIM_DEPENDENCIES/lib:$LD_LIBRARY_PATH export LD_LIBRARY_PATH # For MAC’s add the following, DYLD_FRAMEWORK_PATH=$OSSIM_INSTALL_PREFIX/Frameworks:$OSSIM_DEPENDENCIES/Frameworks:$DYLD_FRAMEWORK_PATH DYLD_LIBRARY_PATH=$OSSIM_INSTALL_PREFIX/lib:$OSSIM_DEPENDENCIES/lib:$OSSIM_DEPENDENCIES/kakadu/bin:$WXMAC_HOME/lib:$PG_HOME/lib:$OSSIM_DEV_HOME/oms/joms:$DYLD_LIBRARY_PATH:/Developer/qt/lib export DYLD_FRAMEWORK_PATH export DYLD_LIBRARY_PATH }}} 6. Compiling the libraries (unix build) We have now started adding cmake script files for different platforms under: {{{ /ossim_package_support/cmake/build_scripts }}} We suggest making a copy of a build script that closely resembles your system and make any modifications to the build variables to satisfy your environment and place it in /ossim_package_support/cmake/configure.sh. Use the CMakeLists.txt found in the cmake directory to generate your desired make environment. We suggest that you do a complete “out-of-source” build so the main source tree does not get polluted with generated files - make files, object files, … etc. Follow these build steps. {{{ cd ~/ossim-svn/src/ossim_package_support/cmake }}} copy a file from build_scripts/….. to configure.sh {{{ cp build_scripts/mac/mac-basic.sh configure.sh mkdir build open configure.sh }}} (review settings) {{{ cd build ../configure.sh .. –G “Unix Makefiles” }}} (rm cmake cache .txt to clear out) or for xcode generation: ../configure.sh .. –G “Xcode” {{{ make make install }}} == Problems with the Build? == * Make sure you have downloaded the latest ossim_dependencies. The folder should be placed at /Users/Shared/Development/ossim_dependencies . * Get the latest from svn {{{ cd ~/ossim-svn/src svn update . }}} * Set the Configuration in xcode to the Release build * Do a clean all under build with the ossim project * open a terminal and rm -rf /var/tmp/ (forces rebuild of all of the qt gui widgets) * under xcode make sure the project is ossim, the target is All, the configuration is Release, Active executable ossimplanet == Package Building == Here are some quick notes on building and packaging. After building the All target, select the build_package_dir target and build. This target creates a package directory in the xcode build directory. Applications, tools, frameworks, support files and dependencies are then staged into the package directory. Next, in the Developer/Applications/Utilities folder open up PackageMaker and open the ossim package maker file that is located in the ossim_package_support directory. Note that the ossim_package_support directory is available as a module checkout at www.remotesensing.org:/cvs. It contains geoids and initial reference images for the packaging. Once you have opened the ossim packagemaker file, select build and an installer package will be generated. Optionally, you can use a utility such as DropDMG to create a dmg disk image for distribution. This is a universal installer for ossim applications and frameworks.