|
|
| (18 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| You can get help here: http://forums.duke4.net/topic/4242-building-eduke-on-mac-os-x/
| | {{Distribution intro}} |
|
| |
|
| == Getting source files ==
| | EDuke32 supports macOS. |
| * 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].
| |
|
| |
|
| == Build Setup == | | == Prerequisites == |
|
| |
|
| === Compiler ===
| | Install the Xcode command line utilities and [http://brew.sh/ Homebrew]. |
|
| |
|
| #Install Xcode.
| | Run the following in a terminal window: |
| #Download and install the Xcode command line tools:
| |
| ##To get those you first need to have a Developer ID (go to the [https://developer.apple.com/devcenter/mac/index.action Mac Dev Center] and click 'Register' in the top right hand corner and follow the steps. If you already have an Apple ID then you can link your developer ID to that. Don't worry, basic dev accounts are free.
| |
| ##Open Xcode and go into its preferences dialog (Xcode -> Preferences in the menu bar or Command+,) and, in the 'Downloads' tab, click 'Install' next to 'Command Line Tools'. At this point you'll be prompted for the Developer ID you set up earlier. Enter it and your password and it should be on its way.
| |
|
| |
|
| === MacPorts ===
| | brew install make sdl2 flac libvpx |
|
| |
|
| First, install [http://www.macports.org/ MacPorts]. Make sure you have the correct version for your OS X version.
| | == Building == |
|
| |
|
| You then need to edit a couple of MacPorts' config files to make sure it builds what's needed correctly. At a terminal prompt, type:
| | Type <code>gmake -j4</code> and hope for the best! For debug builds, run <code>gmake RELEASE=0</code>. |
|
| |
|
| sudo nano /opt/local/etc/macports/variants.conf
| | == Game Data == |
| | |
| When prompted, enter your password and hit enter then add the following to the end of the file:
| |
| | |
| +universal
| |
| +no_x11
| |
| | |
| Then hold down Ctrl and press X to exit nano. You'll be asked if you want to save the file. Press 'Y'.
| |
| | |
| Now you have to make sure both i386 and x86_64 versions of things are being built by typing
| |
| | |
| sudo nano /opt/local/etc/macports/macports.conf
| |
| | |
| Enter your password again if prompted and then scroll down until you get to the "'''universal_archs'''" line and make sure both i386 and x86_64 are in there.
| |
| | |
| Finally you need to install the libvpx and pkg-config ports by typing:
| |
| | |
| sudo port install libvpx pkgconfig
| |
| | |
| again entering your password if prompted.
| |
|
| |
|
| === Final Steps ===
| | 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>. |
| | |
| #The necessary [[#Frameworks|Frameworks]] should be installed globally.
| |
| #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 ==
| |
| | |
| [[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/release/ (old versions)]
| |
| *[http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer.framework]
| |
| **[http://www.libsdl.org/projects/SDL_mixer/release/ (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: <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].
| |
| | |
| == Game Data ==
| |
|
| |
|
| [[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:
| | == Play == |
|
| |
|
| *<code>/Library/Application Support/EDuke32/</code>
| | Once everything is in place, you should be able to run the .app bundle. Enjoy! |
| *<code>~/Library/Application Support/EDuke32/</code>
| |
| *in the same directory as the .app bundle
| |
| *in the same directory as the binary
| |
|
| |
|
| == External Links ==
| | [[Category:Distribution documentation]] |
| *Deprecated guide: http://www.spam-filter.de/osx/eduke32_on_os_x
| |
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!