Version 14 (modified by welberge, 6 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 7 through applications->techfak->RCINFO package selector, select jdk-1.7.
  • set up the ANT_OPTS variable (e.g. by editing .bashrc)
    export ANT_OPTS="-Xmx256M -XX:MaxPermSize=256M"

Ubuntu setup

  • 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
    sudo apt-get install libboost-program-options-dev libboost-signals-dev (possibly just ignore if
    packages do not exist)
  • Install java 7
  • Install ant > 1.8, setup the ANT_OPTS (e.g. in .bashrc):
    export ANT_OPTS="-Xmx256M -XX:MaxPermSize=256M"

Mac setup

  • Setup  homebrew as your package management system
  • Install  XQuartz
  • Add the following line to .bashrc:
    export PATH=/usr/local/bin:/usr/local/sbin:$PATH
  • (Sept. 2013) Downgrade to protobuf 2.4:
    cd `brew --prefix` 
    git checkout 544209f /usr/local/Library/Formula/protobuf.rb 
  • (Sept. 2013) Downgrade to a non-broken version of CMake-Default:
    git checkout 68c419b Library/Formula/cmake.rb 
  • Install python:
    brew install python 
  • Install the following packages:
    brew install pyqt freeimage libzzip boost libxml++ libxml2 wget git cmake protobuf sdl_mixer qt4 pygtk 
  • Install python-protobuf:
    pip install protobuf 
  • Install spread, download from
    cd ~/Downloads; tar xvzf spread-src-4.2.0-soa.tgz
    cd spread-src-4.2.0
    ./configure; make; sudo make install (Comment: Ignore any XCode errors while installing) 
  • In OS X 10.8, to allow pkg-config to resolve libxml2:
    sudo ln -s /usr/local/Cellar/libxml2/2.9.1/lib/pkgconfig/libxml-2.0.pc /usr/lib/pkgconfig 

Windows setup

  • Install java 7
  • 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
  • Add the following line to the top of the file ant/bin/ant.bat
    set ANT_OPTS=-Xmx256M -XX:MaxPermSize=256M

TODO: spread install instructions, ant.bat should be ant_presomething.bat.