Building EDuke32 on macOS - Revision history

Hendricks266 at 04:09, 22 December 2023

2023-12-22T04:09:19Z

@@ Line 1: / Line 1: @@
 {{Distribution intro}}
-EDuke32 supports <s>OS X</s> macOS 10.5 and newer.
+EDuke32 supports macOS.
-You can get help here: http://forums.duke4.net/topic/4242-building-eduke-on-mac-os-x/
+== Prerequisites ==
-== Getting source files ==
+Install the Xcode command line utilities and [http://brew.sh/ Homebrew].
 Run the following in a terminal window:
   brew install make sdl2 flac libvpx
 == Building ==
-Type <code>gmake</code> and hope for the best! For debug builds, run <code>gmake RELEASE=0</code>. If you want to use SDL 1.2 instead of SDL 2.0, you can append <code>SDL_TARGET=1</code> to the make invocation.
+Type <code>gmake -j4</code> and hope for the best! For debug builds, run <code>gmake RELEASE=0</code>.
 == 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:
+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>.
 == Play ==

Hendricks266 at 02:26, 5 December 2023

2023-12-05T02:26:36Z

@@ Line 25: / Line 25: @@
 Run the following in a terminal window:
-  brew install --universal sdl sdl2 libogg libvorbis flac libvpx luajit
+  brew install make sdl2 flac libvpx
 You're all set! You can continue to the [[#Building|Building]] section.
@@ Line 68: / Line 68: @@
 == Building ==
-Type <code>make</code> and hope for the best! For debug builds, run <code>make RELEASE=0</code>. If you want to use SDL 1.2 instead of SDL 2.0, you can append <code>SDL_TARGET=1</code> to the make invocation.
+Type <code>gmake</code> and hope for the best! For debug builds, run <code>gmake RELEASE=0</code>. If you want to use SDL 1.2 instead of SDL 2.0, you can append <code>SDL_TARGET=1</code> to the make invocation.
 == Game Data ==

Hendricks266: /* Prerequisite Libraries */

2020-03-29T21:11:07Z

Prerequisite Libraries

← Older revision		Revision as of 14:11, 29 March 2020
Line 25:		Line 25:
	Run the following in a terminal window:		Run the following in a terminal window:

	brew install --universal sdl ~~sdl_mixer~~ sdl2 ~~sdl2_mixer homebrew/dupes/zlib libpng~~ libogg libvorbis flac libvpx luajit		brew install --universal sdl sdl2 libogg libvorbis flac libvpx luajit

	You're all set! You can continue to the [[#Building\|Building]] section.		You're all set! You can continue to the [[#Building\|Building]] section.

Hendricks266 at 11:46, 1 January 2017

2017-01-01T11:46:48Z

← Older revision		Revision as of 04:46, 1 January 2017
Line 1:		Line 1:
	{{Distribution intro}}		{{Distribution intro}}

	EDuke32 supports OS X 10.5 and newer.		EDuke32 supports <s>OS X</s> macOS 10.5 and newer.

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

Hendricks266: Hendricks266 moved page Building EDuke32 on Mac OS X to Building EDuke32 on macOS

2017-01-01T11:45:57Z

Hendricks266 moved page Building EDuke32 on Mac OS X to Building EDuke32 on macOS

← Older revision		Revision as of 04:45, 1 January 2017
(No difference)

Hendricks266 at 17:08, 20 June 2016

2016-06-20T17:08:09Z

← Older revision		Revision as of 10:08, 20 June 2016
Line 106:		Line 106:

	Once everything is in place, you should be able to run the .app bundle. Enjoy!		Once everything is in place, you should be able to run the .app bundle. Enjoy!

	~~== External Links ==~~
	*http://www.spam-filter.de/osx/eduke32_on_os_x

	[[Category:Distribution documentation]]		[[Category:Distribution documentation]]

Hendricks266: /* Prerequisite Libraries */

2016-06-13T23:47:47Z

Prerequisite Libraries

← Older revision		Revision as of 16:47, 13 June 2016
Line 25:		Line 25:
	Run the following in a terminal window:		Run the following in a terminal window:

	brew install ~~pkgconfig~~ sdl sdl_mixer sdl2 sdl2_mixer homebrew/dupes/zlib libpng libogg libvorbis flac libvpx		brew install --universal sdl sdl_mixer sdl2 sdl2_mixer homebrew/dupes/zlib libpng libogg libvorbis flac libvpx luajit

	You're all set! You can continue to the [[#Building\|Building]] section.		You're all set! You can continue to the [[#Building\|Building]] section.

Hendricks266: /* Game Data */

2014-12-08T06:59:52Z

Game Data

← Older revision		Revision as of 23:59, 7 December 2014
Line 99:		Line 99:
	[[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:		[[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:

	*<code>/Library/Application Support/EDuke32/</code>
	*<code>~/Library/Application Support/EDuke32/</code>		*<code>~/Library/Application Support/EDuke32/</code>
	*~~in the same directory as the~~ .~~app bundle~~		*<code>~/.eduke32/</code>
	*~~in the same directory as the binary~~		*<code>EDuke32.app/Contents/Resources/</code>

	== Play ==		== Play ==

Hendricks266 at 03:13, 18 October 2014

2014-10-18T03:13:13Z

← Older revision		Revision as of 20:13, 17 October 2014
Line 25:		Line 25:
	Run the following in a terminal window:		Run the following in a terminal window:

	brew install pkgconfig sdl sdl_mixer sdl2 sdl2_mixer libpng libogg libvorbis flac libvpx		brew install pkgconfig sdl sdl_mixer sdl2 sdl2_mixer homebrew/dupes/zlib libpng libogg libvorbis flac libvpx

	You're all set! You can continue to the [[#Building\|Building]] section.		You're all set! You can continue to the [[#Building\|Building]] section.
Line 54:		Line 54:
	Finally, install the prerequisites themselves:		Finally, install the prerequisites themselves:

	sudo port install pkgconfig libsdl libsdl_mixer libsdl2 libsdl2_mixer libpng libogg libvorbis flac libvpx		sudo port install pkgconfig libsdl libsdl_mixer libsdl2 libsdl2_mixer zlib libpng libogg libvorbis flac libvpx

	Again, entering your password if prompted. If any of these packages fail to build, remove it from the command and try again to make sure everything that can build has built.		Again, entering your password if prompted. If any of these packages fail to build, remove it from the command and try again to make sure everything that can build has built.

Hendricks266 at 02:06, 18 October 2014

2014-10-18T02:06:33Z

← Older revision		Revision as of 19:06, 17 October 2014
Line 32:		Line 32:

	'''''This section has not been tested for a long time and is not necessary when building for your own personal use!'''''		'''''This section has not been tested for a long time and is not necessary when building for your own personal use!'''''

	~~==== Special notes for 10.5/Leopard users ====~~

	Users on 10.5 should follow the [[#PowerPC Macs\|PowerPC]] directions (including on how to set up MacPorts), even if they have an Intel Mac since the script assumes PowerPC support when run under Leopard. If you'd rather not build the PowerPC version then follow the [[#Intel Macs\|Intel]] directions, remembering to call the osxbuild.sh script with the noppc parameter to prevent the PowerPC version from being built. If your Mac has a 64-bit capable CPU (Core 2 Duo or later), you may also want to enable the 64-bit build as well using the directions that follow.

	The 64-bit build is also disabled on Leopard by default. If you wish to enable it and don't care about the PowerPC build then you have to call osxbuild.sh with the <code>--build64=1 --buildppc=0</code> command line parameters and follow the [[#Intel Macs\|Intel]] directions below. (64-bit here refers to x86_64, there's no equivalent 64-bit build for PowerPC so even if you have a 64-bit capable PowerPC processor, don't enable this unless you're trying to create a three-way universal binary as defined below).

	If, on the other hand, you want to compile a three-way universal binary containing the PowerPC, x86 and x86_64 versions, things get a little more complicated. You not only have to manually enable the 64-bit build as outlined above, but you also have to make sure all but one of the dependency ports are compiled three-way universal as well. The procedure here is much the same as the [[#PowerPC Macs\|PowerPC]] directions below, but with a few exceptions: To start with, you need ppc, i386 and x86_64 all in your macports.conf universal_archs line. Use that to install the pkgconfig, libsdl_framework and libsdl_mixer-framework ports, but after you've finished installing those go back into macports.conf and remove ppc from the universal_archs before installing the libvpx port. You can put ppc back afterward if you want, but it's essential to remove it in order to build libvpx.

	~~==== Common Setup ====~~

	First, install [http://www.macports.org/ MacPorts]. Make sure you have the correct version for your OS X version.		First, install [http://www.macports.org/ MacPorts]. Make sure you have the correct version for your OS X version.
Line 62:		Line 52:
	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 if you have an Intel Mac (Core Duo, Core 2 Duo, Core i* or Xeon) and that i386 and ppc are there if you have a PowerPC (G4, G5) Mac.		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 if you have an Intel Mac (Core Duo, Core 2 Duo, Core i* or Xeon) and that i386 and ppc are there if you have a PowerPC (G4, G5) Mac.

	~~All builds have~~ the ~~pkg-config port in common, so start by installing that~~:		Finally, install the prerequisites themselves:

	sudo port install pkgconfig libsdl libsdl_mixer libsdl2 libsdl2_mixer libpng libogg libvorbis flac libvpx		sudo port install pkgconfig libsdl libsdl_mixer libsdl2 libsdl2_mixer libpng libogg libvorbis flac libvpx

	Again, entering your password if prompted.		Again, entering your password if prompted. If any of these packages fail to build, remove it from the command and try again to make sure everything that can build has built.

			==== Special notes for 10.5/Leopard users ====

			osxbuild.sh assumes PowerPC support when run under Leopard. If you'd rather not build the PowerPC version, then call the script with the noppc parameter to prevent the PowerPC version from being built. If your Mac has a 64-bit capable CPU (Core 2 Duo or later), you may also want to enable the 64-bit build as well using the directions that follow.

			The 64-bit build is also disabled on Leopard by default. If you wish to enable it and don't care about the PowerPC build then you have to call osxbuild.sh with the <code>--build64=1 --buildppc=0</code> command line parameters and follow the [[#Intel Macs\|Intel]] directions below. (64-bit here refers to x86_64, there's no equivalent 64-bit build for PowerPC so even if you have a 64-bit capable PowerPC processor, don't enable this unless you're trying to create a three-way universal binary as defined below).

			If, on the other hand, you want to compile a three-way universal binary containing the PowerPC, x86 and x86_64 versions, things get a little more complicated. You not only have to manually enable the 64-bit build as outlined above, but you also have to make sure all but one of the dependency ports are compiled three-way universal as well. The procedure here is much the same as the directions above, but with a few exceptions: To start with, you need ppc, i386 and x86_64 all in your macports.conf universal_archs line. Use that to install everything but libvpx, and after you've finished installing those go back into macports.conf and remove ppc from the universal_archs before installing the libvpx port. You can put ppc back afterward if you want, but it's essential to remove it in order to build libvpx.

	== Building ==		== Building ==