Mac OS X

Install the Prerequisites

• Java Developers Package: 10.6 is the only one we support. You can find this at http://connect.apple.com/ under Java downloads. You do not have to pay for a developers account. There's a link at the bottom that will let you register for free resources.
• Note: If you get an error with "jni.h", visit the following page to see how to resolve it.
• XCode: XCode is the Mac OS development environment under which you'll build Soar. It is free with the latest version of MacOS. If you don't already have it, you can download it here.
• Python: Soar uses the SCons build system (scons.org), which requires Python. This should already be installed on OSX. Just make sure you're running an appropriate version. 2.7.2 is recommended, but anything from 2.5 onward should work. The Python 3.x series WILL NOT WORK. To check your version, type python --version

Build Soar

Go into the SoarSuite folder and run:

python scons/scons.py all

All of your resulting binaries will be in the /out folder.

For more detailed information about the Scons script, see the SCons Script Documentation page. See the FAQ for common solutions to errors.

Set Up Environment Variables

While you don't need any environment variables to build Soar, you may need a few set when running or developing for Soar. To make these changes permanent, edit the .bashrc file in your home diretory and put them at the bottom.

Soar binaries are, by default, installed to a prefix SoarSuite/out. Java-based Soar application may need to be able to load relevant dynamic libraries on the fly, so you need to make sure that it can find the libraries it needs. Java will look DYLD_LIBRARY_PATH, so you can use that to tell it where to look.

# The exact path here will depend on your system settings.
export DYLD_LIBRARY_PATH=/home/$USER/soar/SoarSuite/out/

Certain functions in the kernel may also use the SOAR_HOME environment variable to find binaries. For example, SpawnDebugger uses it to find the SoarDebugger.jar.

# The exact path here will depend on your system settings.
export SOAR_HOME=/home/$USER/soar/SoarSuite/out/

For more detailed information about library search paths, see our wiki page on how library search paths work.