Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

Changes between Version 28 and Version 29 of dev/MacOSX


Ignore:
Timestamp:
Nov 7, 2010, 4:13:28 PM (13 years ago)
Author:
youngk
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • dev/MacOSX

    v28 v29  
    1 [[OutdatedPage]]
    2 = MacOSX =
     1= Mac OS X =
    32
    4 == Installing the Utilities ==
    5   1. '''GCC, the GNU Compiler''':[[br]] Read about installation of the [http://www.tech-recipes.com/mac_system_administration_tips726.html MacOSX coding env] or just download the [http://developer.apple.com/tools/xcode/ XCode Tools] from the [https://connect.apple.com Apple development center], where you have to create an account if you don't have one already.
    6   2. '''Fink''':[[br]] On the [http://fink.sourceforge.net/ fink] website you will find fink, which you will need to install the libraries. Go to the download area there and get the binary (.dmg) version of fink.
    7   3. '''Fink Commander''': Now you can download the fink commander, which is a GUI for fink, that makes it much easier to work with. You can get it from [http://finkcommander.sourceforge.net/ sourceforge].
     3Here's how to get Orxonox up and running on Steve Jobs' operating system. We support anything from 10.5 (Leopard) upwards, while keeping in mind that Orxonox currently only runs in 32-bit mode. The following procedure was tested on Mac OS X 10.6.4 (Snow Leopard).
    84
    9 '''Fink Utilities'''
    10 These utilities must be install with fink. Either you do it with the finkcommander or you write:
    11 {{{
    12 $ fink list [package-part-name]        // choose the one you like and
    13 $ fink install [package-name]          // fill in the name of the actual package here
    14 }}}
     5== Current Status (as of November 7th, 2010) ==
    156
    16 You need the following packages:
    17   1. '''Autoconf''' [[br]]
    18 {{{
    19 $ fink install autoconf
    20 }}}
    21   2. '''Subversion with SSL'''[[br]]
    22 {{{
    23 $ fink install svn-client-ssl
    24 }}}
    25 package.
     7Orxonox builds fine with either Xcode or Makefiles. The game starts up, but crashes midway in the set-up process due to badly linked libraries. That's also why we haven't uploaded a dependency package yet. Please be patient.
    268
     9== Nice To Know ==
    2710
    28 === Installing the Libraries ===
    29   1. X-code must be installed.
    30   2. You can find a collection of all Tools and Libraries you need [http://svn.orxonox.net/webdev/develop/osX here]
    31   2. Install the SDL framework and read the documentation on the [http://www.libsdl.org SDL] download section
     11So far Orxonox ran only on Windows and Linux systems. Apple, as the third major OS player, opens yet another universe of possible problems for setting up, compiling and running Orxonox. Having a Unix kernel at its core, development isn't too different from Linux. However its structure and organization enforce much more strict adherence to rules than in any other operating system. Application structure and behavior are well-defined and the entire development framework on Apple builds on ease-of-use for the end-user, not the developer.
    3212
    33 Use the fink commander to install
    34  * '''glew'''
    35  * '''sdl'''
    36  * '''sdl-image'''
     13== Prerequisites ==
    3714
     15Lets assume you have a more recent installation of OS X (i.e. whatever we support: >= 10.5). To get you started, we first need to set up your development environment:
     16 * Xcode (Download the latest version from: [http://developer.apple.com/technologies/xcode.html "Apple Developer Connection"]. You need to set up an account with them first.)
     17 * Cmake (Get the prebuilt dmg-Image for Mac OS X: [http://www.cmake.org/cmake/resources/software.html Cmake])
    3818
    39 Unfortunately SDL_ttf is not installable with Fink Commander, so download the source directly from [http://www.libsdl.org/projects/SDL_ttf] and compile it yourself.
    40 Before installing SDL_ttf make sure you have freetype2.0 or later installed on your Mac. You can also get freetype2.0 with finkcommander:
    41  * freetype2.0
    42 To install SDL_ttf to the fink directory use the following configure command:
    43 {{{
    44 wraith user # ./configure --prefix=/sw/
    45 }}}
    46 Then compile and install by revoking. You have to change to superuser to install the libraries:
    47 {{{
    48 wraith user # sudo passwd root
    49 }}}
    50 this will set the password for the root account if you havnt done this before.
    51 {{{
    52 wraith user # ./autogen.sh
    53 wraith user # ./configure
    54 .
    55 wraith user # make
    56 .
    57 wraith user # sudo make install
    58 }}}
     19For Xcode you need to make absolutely sure to select the "MacOSX10.4u.sdk" for installation, while running the Xcode installer. It's needed for compatibility reasons.
    5920
     21=== Source Files ===
    6022
    61 == Compiling ==
    62 Switch to the [wiki:LinuxGentoo Gentoo Linux] guide and continue with the compiling sections.
     23Once that's done, you need to check out the source files and the dependency package. There are two possibilities to get the source files, either via Xcode or by using subversion in the terminal (/Applications/Utilities/Terminal). To get the files via subversion in the terminal, follow these directions: [http://www.orxonox.net/wiki/SVN Subversion]
     24
     25To get the files with Xcode, you first need to open Xcode (I'd recommend you drag the app from /Developer/Applications/Xcode to your dock). Navigate to the menu item "SCM" up top on the menu bar:
     26{{{SCM -> Configure SCM repositories…}}}.
     27Add a new repository by pressing the "+" sign on the left-bottom of the pop-up. Enter all information according to [http://www.orxonox.net/wiki/SVN Subversion]. Click "OK" and you're set. Next, navigate to
     28{{{SCM -> Repositories}}}.
     29Do a "Checkout" of code/trunk and data/trunk. That's it, you can quit Xcode once the downloads are done.
     30
     31=== Dependencies ===
     32
     33Orxonox has a pretty impressive list of dependencies and very few of them are pre-installed on our Apples. That's why we put together a package with precompiled dependencies for ease-of-use. Download it [http://www.orxonox.net/error here] , extract it and place it into the directory where you have the data_extern and the trunk folders.
     34
     35For the suicidal ones, here's the dependency list, if you want to compile them yourself (files are preferentially dynamically linked):
     36
     37|| Library name                     || Minimum Version || Recommended Version || Notes ||
     38|| OGRE 3D Graphics Engine          || 1.4 || 1.7.2 ||  ||
     39|| CEGUI (Crazy Eddie's GUI System) || 0.5 || 0.6.2 ||  ||
     40|| Boost libraries                  || 1.35 || 1.44 ||  ||
     41|| ENet (Network library)           || 1.1 || - || included in orxonox ||
     42|| Lua (scripting language)         || 5.0 or 5.1 || 5.1.4 ||  ||
     43|| Tcl (shell script language)      || 8.4 or 8.5 || - || Use Apple system version ||
     44|| OpenAL (audio)                   || (not yet specified) || - || Use Apple system version ||
     45|| ALUT (audio)                     || (not yet specified) || - || Can't be compiled on Apple. Use dummy package included in dependency package ||
     46|| LibOgg                           || (not yet specified) || 1.2.1 ||  ||
     47|| LibVorbis                        || (not yet specified) || 1.3.2 ||  ||
     48|| LibVorbisFile                    || (not yet specified) || 1.3.2 || Comes with LibVorbis ||
     49|| ZLib (compression)               || (not yet specified) || - || Use Apple system version ||
     50
     51Apple Mac OS X uses the following library paths:
     52 * /usr
     53 * /usr/local
     54 * /opt/local (MacPorts source distribution: [http://www.macports.org/ MacPorts])
     55 * /sw (Fink binary distribution: [http://www.finkproject.org/ Fink])
     56 * /Library/Frameworks (for Apple frameworks; dynamically linked and self-contained structures. See [http://developer.apple.com/library/mac/#documentation/CoreFoundation/Conceptual/CFBundles/ CFBundles] for information.)
     57 * ~/Library/Frameworks
     58 * /System/Library/Frameworks
     59 * /Developer/Library/Frameworks
     60
     61== Building Orxonox ==
     62
     63Once you have everything in place, fire up Cmake. Choose your source and build directories and click "Configure". Choose either Xcode or Makefiles as build mode, whichever suits your preferences. Check the correct locations of the dependencies and make sure you're using the right Apple SDK (MacOSX10.5.sdk or MacOSX10.6.sdk) and then click "Generate". In case you're using Makefiles as build mode, you can just follow the normal steps to compile Orxonox: [http://www.orxonox.net/wiki/Buildsystem Buildsystem].
     64Otherwise switch to Xcode, open up the "Orxonox.xcodeproj" file inside your build directory and hit "Build". Let it simmer, while stirring the soup from time to time, and you're set to play the game.