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

From EDukeWiki
Jump to: navigation, search
Line 15: Line 15:
 
#You need to define the root directory of your SDL installation. Edit the file ''eduke32/Apple/Makefile.shared''. In most cases you only have to change the APPLE_TARGET to match your setup. For example: if you have [http://www.macports.org/ MacPorts] (aka DarwinPorts) installed then use ''/opt/local''.  
 
#You need to define the root directory of your SDL installation. Edit the file ''eduke32/Apple/Makefile.shared''. In most cases you only have to change the APPLE_TARGET to match your setup. For example: if you have [http://www.macports.org/ MacPorts] (aka DarwinPorts) installed then use ''/opt/local''.  
 
#Run ''./osxbuild.sh'' and hope for the best!
 
#Run ''./osxbuild.sh'' and hope for the best!
 +
 +
== Frameworks ==
 +
 +
[[File:macosx_frameworks_missing.png|right|This error will be displayed if EDuke32's required frameworks are not installed. You may click "ignore".]]
 +
 +
EDuke32 requires the following frameworks to function:
 +
 +
*[http://www.libsdl.org/download-1.2.php SDL.framework]
 +
*[http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer.framework]
 +
 +
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: <code>/Library/Frameworks</code>
 +
*Per-User: <code>~/Library/Frameworks</code>
 +
*Per-App (Portable): <code><app bundle>/Contents/Frameworks</code>
 +
 +
For more information see [https://developer.apple.com/library/mac/documentation/MacOSX/Conceptual/BPFrameworks/Tasks/InstallingFrameworks.html#//apple_ref/doc/uid/20002261-BBCCFBJA the relevant article on the Mac OS X Developer Library].

Revision as of 07:51, 24 February 2012

This page is a work-in-progress adaptation of http://www.spam-filter.de/osx/eduke32_on_os_x.

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. Copy SDLMain.m and SDLMain.h from the Apple/ directory into the root eduke32/.
  3. You need to define the root directory of your SDL installation. Edit the file eduke32/Apple/Makefile.shared. In most cases you only have to change the APPLE_TARGET to match your setup. For example: if you have MacPorts (aka DarwinPorts) installed then use /opt/local.
  4. Run ./osxbuild.sh and hope for the best!

Frameworks

This error will be displayed if EDuke32's required frameworks are not installed. You may click "ignore".

EDuke32 requires the following frameworks to function:

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.