Note, this page is being updated, in the interim please refer to OSSIM Build Instructions V 1.4
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:
OSSIM Build Documentation for Mac OS X Dave Lucas - ossimdave@…
If necessary, download and install CMake version 2.8.x http://www.cmake.org/cmake/resources/software.html
- 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
- Download the OSSIM Dependencies
Move the downloaded file into /Users/Shared/Development
mv ~/Downloads/ossim_dependencies.tgz /Users/Shared/Development
- Extract the ossim_dependencies.tgz using tar (double click in finder, or
cd /Users/Shared/Development tar -xvf ossim_dependencies.tar
- Remove the ossim_dependencies.tgz (optional)
- 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
- Compiling the libraries (unix build)
We have now started adding cmake script files for different platforms under:
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_DEV_HOME>/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.
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
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.