|
|
| (27 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| This page is a work-in-progress adaptation of [http://www.spam-filter.de/osx/eduke32_on_os_x http://www.spam-filter.de/osx/eduke32_on_os_x].
| | {{Distribution intro}} |
|
| |
|
| You can get help at [http://forums.duke4.net/topic/4242-building-eduke-on-mac-os-x/ http://forums.duke4.net/topic/4242-building-eduke-on-mac-os-x/].
| | EDuke32 supports macOS. |
|
| |
|
| == Getting source files == | | == Prerequisites == |
| * Current version (You need to install the ''subversion'' program) :
| |
| <pre>svn co https://eduke32.svn.sourceforge.net/svnroot/eduke32/polymer/eduke32</pre>
| |
| * [http://dukeworld.duke4.net/eduke32/synthesis Source tarballs] (Lite subversion snapshots, it does not include metadata, Apple compiled libraries, third-party jaudiolib and Photoshop files).
| |
| * [http://dukeworld.duke4.net/eduke32/synthesis/old/ Old] and [http://dukeworld.duke4.net/eduke32/old_versions/source_code/ Older versions].
| |
|
| |
|
| == Compiler Setup ==
| | Install the Xcode command line utilities and [http://brew.sh/ Homebrew]. |
|
| |
|
| #Install Xcode.
| | Run the following in a terminal window: |
| #Copy SDLMain.m and SDLMain.h from the Apple/ directory into the root eduke32/.
| |
| #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''.
| |
| #The necessary [[#Frameworks|Frameworks]] should be installed globally.
| |
| #Run <code>./osxbuild.sh</code> and hope for the best!
| |
|
| |
|
| == Frameworks ==
| | brew install make sdl2 flac libvpx |
|
| |
|
| [[File:macosx_frameworks_missing.png|right|This error will be displayed if EDuke32's required frameworks are not installed. You may click "ignore".]]
| | == Building == |
|
| |
|
| EDuke32 requires the following frameworks to function:
| | Type <code>gmake -j4</code> and hope for the best! For debug builds, run <code>gmake RELEASE=0</code>. |
|
| |
|
| *[http://www.libsdl.org/download-1.2.php SDL.framework]
| | == Game Data == |
| *[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].
| | If you own a digital copy of the game with native support for macOS, EDuke32 will automatically detect its default install location and use any game data it finds! Otherwise, [[Installation and configuration|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 music packs and mods, can be placed in <code>~/Library/Application Support/EDuke32/</code>. |
|
| |
|
| == Game Data == | | == Play == |
|
| |
|
| [[Installation and configuration|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:
| | Once everything is in place, you should be able to run the .app bundle. Enjoy! |
|
| |
|
| *<code>/Library/Application Support/EDuke32/</code>
| | [[Category:Distribution documentation]] |
| *<code>~/Library/Application Support/EDuke32/</code>
| |
| *in the same directory as the .app bundle
| |
| *in the same directory as the binary
| |
EDuke32 supports macOS.
Prerequisites
Install the Xcode command line utilities and Homebrew.
Run the following in a terminal window:
brew install make sdl2 flac libvpx
Building
Type gmake -j4 and hope for the best! For debug builds, run gmake RELEASE=0.
Game Data
If you own a digital copy of the game with native support for macOS, EDuke32 will automatically detect its default install location and use any game data it finds! Otherwise, 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 music packs and mods, can be placed in ~/Library/Application Support/EDuke32/.
Play
Once everything is in place, you should be able to run the .app bundle. Enjoy!