Rosetta 3.2 Release Manual

Build Rosetta

For most of the following build commands you need to be in the home directory of Rosetta source.

General Instruction

In order to build a release version of Rosetta executables, simply run scons:

Advanced Build Environment Setup

Automatic location of other compilers (assuming they are already in your path) such as Intel C/C++ may be enabled by uncommenting the "program_path" line in 'tools/build/user.settings'.

You can restrict compilation of the the devel and pilot_apps to build personal applications. On issuing the call

scons bin my
or
scons bin my_pilot_apps

SCons will read from src/devel.src.settings.my and src/pilot_apps.src.settings.my rather than src/devel.src.settings and src/pilot_apps.src.settings.all.

Common build calls that may be useful

Build Rosetta on Mac OS X System

Build Rosetta in Mac Terminals

The Rosetta installation on MacOS X system is the same as the installation on Linux system. You need to make sure that the Xcode is installed, which is also available free from Apple Developer Connection. http://en.wikipedia.org/wiki/Apple_Developer_Connection

Build Rosetta using the Rosetta Xcode Project

The Rosetta Xcode project is compatible with Xcode versions 2.4 and later. You can use it to build, run, debug, browse, and edit the source code. There are four build targets to select from:
Libraries: Rosetta libraries upon which apps are based
Test: Unit tests for components of Rosetta Libraries & Test: Both of the above
Libraries & Apps: Libraries and executable apps in rosetta-X.X/rosetta_source/bin
There are two primary configurations, Debug and Release. Each of those has two sub-configurations. The "static" mode builds static binaries, instead of those based on the shared libraries. This can be useful for copying and running the apps on other Mac OS X systems. The "graphics" mode enables OpenGL graphics for those apps that support it.

The Xcode build and clean commands tell scons to take the appropriate actions. Xcode will by default instruct scons to use 2 processors for compilation. To change that number, double click the "Rosetta" icon in the "Groups & Files" pane. Then switch to the "Build" tab and change the "NUM_PROCESSORS" setting to the desired number of processors.

To run/debug Rosetta from within Xcode, you will need to add an executable to the project. To do so, select "New Custom Executable..." from the "Project" menu. Xcode will not allow you to specify the symbolic links in the

 rosetta-X.X/rosetta_source/bin 
directory as the executable. Instead, you will have to reference the actual binaries deep inside the subdirectories of
 rosetta-X.X/rosetta_source/build 
. Please see the Xcode documentation for information about specifying the command line arguments and the working directory.

Build Rosetta on Windows System

If you want to set breakpoints from within Xcode for debugging, you have to tell the debugger to load all user libraries. To do so, go to the "Run->Show->Shared Libraries..." menu item. Change the "User Libraries:" popup from "Default (External)" to "All".


Generated on Wed Feb 16 16:04:26 2011 for Rosetta Projects by  doxygen 1.5.9

© Copyright Rosetta Commons Member Institutions. For more information, see http://www.rosettacommons.org.