Difference between revisions of "Building EDuke32 on Mac OS X" - EDukeWiki

# Difference between revisions of "Building EDuke32 on Mac OS X"

From EDukeWiki

Revision as of 19:49, 7 March 2012 (view source) Hendricks266 (talk | contribs) ← Older edit | Revision as of 23:52, 13 March 2012 (view source) Hendricks266 (talk | contribs) Newer edit →
Line 12: | Line 12:
| #You need to define the root directory of your SDL installation. Edit the file ''build/Makefile.shared''. In most cases you only have to change SDLROOT to match your setup. For example: if you have [http://www.macports.org/ MacPorts] (aka DarwinPorts) installed then use ''/opt/local''. |  |
| #The necessary [[#Frameworks|Frameworks]] should be installed globally. |  |
− | #Run <code>./osxbuild.sh</code> and hope for the best! (If you are building on PowerPC, just type <code>make</code>.) | + | #Run <code>./osxbuild.sh</code> and hope for the best!
| + |
| + | == osxbuild.sh Documentation ==
| + |
| + | usage: osxbuild [onlyzip] [noppc] [no86] [no64] [tools] [--debug=<0|1>]
| + |
| + | *'''onlyzip''' will skip building the executable and simply package it into a zip file. Mostly for internal use.
| + | *'''noppc''', '''no86''', and '''no64''' disable PowerPC, x86, and x86_64 builds respectively.
| + | *'''tools''' builds and installs the Build tools in addition to the main executables.
| + | *'''--debug=''' takes either '''0''' or '''1''' as a parameter to disable or enable additional building of the debugging builds. Currently, it defaults to off.
| == Frameworks == |  | == Frameworks ==

## Revision as of 23:52, 13 March 2012

You can get help here: http://forums.duke4.net/topic/4242-building-eduke-on-mac-os-x/

## Getting source files

- Current version (You need to install the subversion program) :

    svn co https://eduke32.svn.sourceforge.net/svnroot/eduke32/polymer/eduke32

- Source tarballs (Lite subversion snapshots, it does not include metadata, Apple compiled libraries, third-party jaudiolib and Photoshop files).
- Old and Older versions.

## Compiler Setup

1. Install Xcode.
2. You need to define the root directory of your SDL installation. Edit the file build/Makefile.shared. In most cases you only have to change SDLROOT to match your setup. For example: if you have MacPorts (aka DarwinPorts) installed then use /opt/local.
3. The necessary Frameworks should be installed globally.
4. Run `./osxbuild.sh` and hope for the best!

## osxbuild.sh Documentation

    usage: osxbuild [onlyzip] [noppc] [no86] [no64] [tools] [--debug=<0|1>]

- onlyzip will skip building the executable and simply package it into a zip file. Mostly for internal use.
- noppc, no86, and no64 disable PowerPC, x86, and x86_64 builds respectively.
- tools builds and installs the Build tools in addition to the main executables.
- --debug= takes either 0 or 1 as a parameter to disable or enable additional building of the debugging builds. Currently, it defaults to off.

## Frameworks

EDuke32 requires the following frameworks to function:

- SDL.framework
  - (old versions)
- SDL_mixer.framework
  - (old versions)

The error message at the right will be displayed if these frameworks are not properly installed. You may install these at any or all of the following locations:

- Global: `/Library/Frameworks`
- Per-User: `~/Library/Frameworks`
- Per-App (Portable): `<app bundle>/Contents/Frameworks`

For more information see the relevant article on the Mac OS X Developer Library.

## Game Data

To play the game, the files you need are DUKE3D.GRP and DUKE.RTS. They, as well as any other data you have, such as the HRP, music packs, and mods, can be placed in the following locations, depending on the circumstances in which you want them to be used:

- `/Library/Application Support/EDuke32/`
- `~/Library/Application Support/EDuke32/`
- in the same directory as the .app bundle
- in the same directory as the binary

## External Links

- Deprecated guide: http://www.spam-filter.de/osx/eduke32_on_os_x

Retrieved from "http://wiki.eduke32.com/w/index.php?title=Building_EDuke32_on_Mac_OS_X&oldid=10370"