Version 32 (modified by welberge, 4 years ago) (diff)


Recommended System Setup

Asap is developed jointly on Ubuntu 12.04 LTS 64 bit and Mac (10.7 Lion, 10.8 Mountain Lion). We recommend using these operating systems. Most Asap components are OS-neutral and also function on other Linux distributions and on Windows. A notable exception is the Ogreviewer used for the Billie character. We regularly use AsapRealizer and related components in Windows 7, 64 bit (with 64-bit Java).

Techfak setup

  • Install Java 8 through applications->techfak->RCINFO package selector, select java8.
  • Recommended: install SoaScript

Ubuntu setup (for non-techfak machines)

  • Install the following packages:
    sudo apt-get install wget git cmake ant libboost-dev libboost-regex-dev libboost-system-dev libboost-filesystem-dev libfreeimage-dev libogre-dev libqt4-dev libprotobuf-dev libsdl-mixer1.2-dev libxml++2.6-dev uuid-dev libzzip-dev python-gtk2-dev python-qt4 python-protobuf python-setuptools libtinyxml-dev protobuf-compiler
    sudo apt-get install libboost-program-options-dev libboost-signals-dev (possibly just ignore if packages do not exist)

On newer Ubuntu versions (tested for 13.10), you should install Ogre 1.8 instead of the default ogre version (package libogre-1.8-dev instead of libogre-dev). TODO: other requirements of ogre 1.8, e.g. run billie with ./go.billie.ogre1.8.

  • Install java 8
    sudo apt-get install openjdk-8-jdk

If java 6/7 was already installed, setup java 7 as default compiler and jre

sudo update-alternatives --config java
sudo update-alternatives --config javac

TODO: install instructions when openjdk-8 is not available on your distribution

  • Install ant > 1.8
    sudo apt-get install ant

Mac setup

Currently supported: Yosemite, Mavericks (10.10, 10.9); legacy: 10.7 Lion, 10.8 Mountain Lion

  1. Install Homebrew
  1. Add this to .bashrc:

export PATH=/usr/local/bin:/usr/local/sbin:$PATH

  1. Install XQuartz
  1. Get the pre-packaged Ogre 1.9 installation from

unpack it:

cd /Library/Frameworks; sudo tar xvpzf ogre-1.9.0-mac-soa.tar.gz
  1. The protobuf library must currently not be newer than 2.5.x. Prepare homebrew to use a 2.5 version:
        cd `brew --prefix`
        git checkout 6de7a23 Library/Formula/protobuf.rb
  2. Install the following packages using homebrew. The first command installs homebrew's python. Make sure it is used after installation (hash -r; which python should print /usr/local/bin/python).
        brew install python
        brew install ant pyqt freeimage libzzip boost libxml++ libxml2 wget git cmake protobuf sdl_mixer qt4 pygtk tinyxml
  3. Install python packages:
        pip install protobuf
  4. Install spread (soa version):


    cd ~/Downloads; tar xvzf spread-src-4.2.0-soa.tgz
    cd spread-src-4.2.0; ./configure; make; sudo make install
  1. IF there is a problem with finding QtOpenGL later, link Qt to /Library/Frameworks:

cd `brew --prefix`/Cellar/qt/4.8.6/Frameworks
sudo ln -s /usr/local/Cellar/qt/4.8.6/Frameworks/*.framework /Library/Frameworks

Windows setup

  • Install java 8
  • Install  Python 2.7.x and make sure the python binary is on your path
  • Obtain a recent version (>= 1.8.2) of  apache ant, put the ant bin directory on your PATH
  • Get spread binaries from and unzip them
  • Add a spread.conf file to the directory in which you unzipped the spread binaries, it should contain
    Spread_Segment {
  • Download the protoc 2.4.1 binaries (newer ones currently don't work with Asap) from, unzip them and add them to your path
  • create an rsb.conf file in a .config subdirectory of your home, containing
    enabled = 1
    host = localhost
    port = 4803
    enabled = 0 
  • Install setuptools from