Compiling with Xcode (OpenXcom) - Revision history

Hobbes: Undo revision 126426 by Hobbes (talk)

2026-03-10T14:57:36Z

Undo revision 126426 by Hobbes (talk)

← Older revision		Revision as of 14:57, 10 March 2026
Line 1:		Line 1:
	~~#REDIRECT~~ [[OpenXcom]]		To successfully build an OpenXcom OSX bundle you will need to ensure all the relevant dependencies installed in /usr/local/.


			== Dependencies ==

			To successfully build an OpenXcom OSX bundle you will need to ensure s all the relevant dependencies installed in /usr/local/.

			The dependencies you require are following:
			<ul>
			<li> cmake, version 3.12.0 or later </li>
			<li> SDL (libsdl1.2) </li>
			<li> SDL_mixer (libsdl-mixer1.2) </li>
			<li> SDL_gfx (libsdl-gfx1.2), version 2.0.22 or later </li>
			<li> SDL_image (libsdl-image1.2) </li>
			<li> yaml-cpp, version 0.5 or later </li>
			</ul>

			We recommend using [https://brew.sh Homebrew] to facilitate this. With a working brew utility installed, run the following:
			<pre>
			$ brew install cmake yaml-cpp sdl sdl_gfx sdl_image sdl_mixer
			</pre>
			This should install all of these necessary dependencies to their appropriate place under /usr/local.

			== Building ==

			<ol>
			<li>In the root of the repository, generate the Makefile with cmake (Release is also a valid build type):
			<pre>
			cmake . -DCMAKE_BUILD_TYPE="Debug" -G Xcode
			</pre>
			</li>

			<li>Open the <code>OpenXcom.xcodeproj</code> in Xcode. </li>
			<li>Copy your vanilla game assets (UFO/TFTD) into the <code>bin/</code> directory. </li>
			<li>Build with cmd-B. </li>
			<li>Your artifact will be named <code>openxcom.app</code> in the build target directory (Debug or Release) from the root of the repository. </li>
			</ol>
			== Additional Help ==

			Should you require any further assistance regarding the OSX build - feel free to ask around on the official forums - https://openxcom.org/forum/ or contact us directly on GitHub - [http://github.com/rcreasey @rcreasey]

			[[Category:OpenXcom]]

Hobbes: Protected "Compiling with Xcode (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2026-03-10T13:59:00Z

Protected "Compiling with Xcode (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 13:59, 10 March 2026
(No difference)

Hobbes: Redirected page to OpenXcom

2026-03-10T13:58:24Z

Redirected page to OpenXcom

← Older revision		Revision as of 13:58, 10 March 2026
Line 1:		Line 1:
	~~To successfully build an OpenXcom OSX bundle you will need to ensure all the relevant dependencies installed in /usr/local/.~~		#REDIRECT [[OpenXcom]]


	~~== Dependencies ==~~

	~~To successfully build an OpenXcom OSX bundle you will need to ensure s all the relevant dependencies installed in /usr/local/.~~

	~~The dependencies you require are following:~~
	~~<ul>~~
	~~<li> cmake, version 3.12.0 or later </li>~~
	~~<li> SDL (libsdl1.2) </li>~~
	~~<li> SDL_mixer (libsdl-mixer1.2) </li>~~
	~~<li> SDL_gfx (libsdl-gfx1.2), version 2.0.22 or later </li>~~
	~~<li> SDL_image (libsdl-image1.2) </li>~~
	~~<li> yaml-cpp, version 0.5 or later </li>~~
	~~</ul>~~

	~~We recommend using~~ [~~https://brew.sh Homebrew] to facilitate this. With a working brew utility installed, run the following:~~
	~~<pre>~~
	~~$ brew install cmake yaml-cpp sdl sdl_gfx sdl_image sdl_mixer~~
	~~</pre>~~
	~~This should install all of these necessary dependencies to their appropriate place under /usr/local.~~

	~~== Building ==~~

	~~<ol>~~
	~~<li>In the root of the repository, generate the Makefile with cmake (Release is also a valid build type):~~
	~~<pre>~~
	~~cmake . -DCMAKE_BUILD_TYPE="Debug" -G Xcode~~
	~~</pre>~~
	~~</li>~~

	~~<li>Open the <code>OpenXcom.xcodeproj</code> in Xcode. </li>~~
	~~<li>Copy your vanilla game assets (UFO/TFTD) into the <code>bin/</code> directory. </li>~~
	~~<li>Build with cmd-B. </li>~~
	~~<li>Your artifact will be named <code>openxcom.app</code> in the build target directory (Debug or Release) from the root of the repository. </li>~~
	~~</ol>~~
	~~== Additional Help ==~~

	~~Should you require any further assistance regarding the OSX build - feel free to ask around on the official forums - https://openxcom.org/forum/ or contact us directly on GitHub -~~ [~~http://github.com/rcreasey @rcreasey]~~

	~~[[Category:~~OpenXcom]]

Kolen: These compile options have been removed in yaml-cpp and sdl_mixer. It builds for me without them, and sdl_mixer is built with libmikmod, libogg, libvorbis. Not sure about flac, this option no longer works. Not thoroughly tested. Will update if not works.

2019-03-27T19:45:45Z

These compile options have been removed in yaml-cpp and sdl_mixer. It builds for me without them, and sdl_mixer is built with libmikmod, libogg, libvorbis. Not sure about flac, this option no longer works. Not thoroughly tested. Will update if not works.

← Older revision		Revision as of 19:45, 27 March 2019
Line 18:		Line 18:
	We recommend using [https://brew.sh Homebrew] to facilitate this. With a working brew utility installed, run the following:		We recommend using [https://brew.sh Homebrew] to facilitate this. With a working brew utility installed, run the following:
	<pre>		<pre>
	$ brew install cmake yaml-cpp ~~--with-static-lib~~ sdl sdl_gfx sdl_image sdl_mixer ~~--with-flac --with-libmikmod --with-libvorbis --with-static-lib~~		$ brew install cmake yaml-cpp sdl sdl_gfx sdl_image sdl_mixer
	</pre>		</pre>
	This should install all of these necessary dependencies to their appropriate place under /usr/local.		This should install all of these necessary dependencies to their appropriate place under /usr/local.

Rcreasey at 22:28, 28 July 2018

2018-07-28T22:28:21Z

← Older revision		Revision as of 22:28, 28 July 2018
Line 1:		Line 1:
	To successfully build an OpenXcom OSX bundle you will need to ensure s all the relevant dependencies installed in /usr/local/.		To successfully build an OpenXcom OSX bundle you will need to ensure all the relevant dependencies installed in /usr/local/.

Rcreasey at 21:54, 28 July 2018

2018-07-28T21:54:51Z

← Older revision		Revision as of 21:54, 28 July 2018
Line 1:		Line 1:
	To successfully build an OpenXcom OSX bundle you will need ~~the relevant Xcode project files provided in the ''xcode'' folder as well as~~ all the relevant dependencies installed in ''/usr/local/''.		To successfully build an OpenXcom OSX bundle you will need to ensure s all the relevant dependencies installed in /usr/local/.


	== Dependencies ==		== Dependencies ==

	The dependencies you require are ~~the~~ following:		To successfully build an OpenXcom OSX bundle you will need to ensure s all the relevant dependencies installed in /usr/local/.
	* SDL (libsdl1.2)
	* SDL_mixer (libsdl-mixer1.2)		The dependencies you require are following:
	* SDL_gfx (libsdl-gfx1.2), version 2.0.22 or later		<ul>
	* SDL_image (libsdl-image1.2)		<li> cmake, version 3.12.0 or later </li>
	* yaml-cpp, version 0.5 or later		<li> SDL (libsdl1.2) </li>
			<li> SDL_mixer (libsdl-mixer1.2) </li>
			<li> SDL_gfx (libsdl-gfx1.2), version 2.0.22 or later </li>
			<li> SDL_image (libsdl-image1.2) </li>
			<li> yaml-cpp, version 0.5 or later </li>
			</ul>

			We recommend using [https://brew.sh Homebrew] to facilitate this. With a working brew utility installed, run the following:
			<pre>
			$ brew install cmake yaml-cpp --with-static-lib sdl sdl_gfx sdl_image sdl_mixer --with-flac --with-libmikmod --with-libvorbis --with-static-lib
			</pre>
			This should install all of these necessary dependencies to their appropriate place under /usr/local.

	~~If you want to save yourself the trouble - don't do it manually, use [http://mxcl.github.com/homebrew/ Homebrew package manager] instead.~~		== Building ==

	=~~= Instructions ==~~		<ol>
			<li>In the root of the repository, generate the Makefile with cmake (Release is also a valid build type):
			<pre>
			cmake . -DCMAKE_BUILD_TYPE="Debug" -G Xcode
			</pre>
			</li>

	~~# This guide assumes you listened to the previous recommendation and had your dependencies installed with brew terminal command, like this:~~<~~br /~~><~~pre>$ brew install yaml-cpp sdl sdl_gfx sdl_image sdl_mixer --with-flac --with-libmikmod --with-libvorbis</pre~~>		<li>Open the <code>OpenXcom.xcodeproj</code> in Xcode. </li>
	~~# Now, open the ''~~OpenXcom.xcodeproj~~'' file and add the source folder to the project:~~<br />~~Right-Click on the OpenXcom project icon~~ in the left pane, select ''Add Files to "OpenXcom"'', traverse the folder tree up one level and select the ''src'' folder to be added. Just make sure you choose ''Create groups for any added folders'' option when adding this to your build target.		<li>Copy your vanilla game assets (UFO/TFTD) into the <code>bin/</code> directory. </li>
	~~# Click on the OpenXcom target in the middle pane and select the ''Build Phases'' tab. Look down at ''~~Copy ~~Bundle Resources'' container and delete all the files irrelevant to our build, namely:~~		<li>Build with cmd-B. </li>
	~~#* OpenXcom.2010.vcxproj~~		<li>Your artifact will be named <code>openxcom.app</code> in the build target directory (Debug or Release) from the root of the repository. </li>
	~~#* CMakeLists.txt~~		</ol>
	~~#* Makefile.simple~~		== Additional Help ==
	~~#* OpenXcom.rc~~
	~~#* OpenXcom.2010.sln~~
	~~#* OpenXcom.2010.vcxproj.user~~
	~~#* OpenXcom.2010.vcxproj.filters~~
	~~#* Makefile.gcc-pch~~
	~~# Push the ''Build'' button and cross~~ your ~~fingers ;~~)
	~~# Find your newly created bundle in ''.~~/~~DerivedData~~/~~OpenXcom~~/Build/~~Products~~/~~Release'' folder and copy it to some place you feel comfortable keeping your games~~ in.
	~~# Don't forget to copy~~ the ~~original game data files you possess into the ''UFO'' and/~~or ~~''TFTD'' folders within the bundle (see [[Installing (OpenXcom)\|Installing]]~~)~~, or otherwise~~ the ~~game won’t start. If asked by OSX what to do with~~ the ~~files and folders already present there, select ''Merge''~~.
	~~# Enjoy!~~

	Should you require any further assistance regarding the OSX build - feel free to ask around on the ~~[http~~://openxcom.org/forum/ ~~official forums]~~ or contact me directly on [http://github.com/~~luciderous GitHub~~].		Should you require any further assistance regarding the OSX build - feel free to ask around on the official forums - https://openxcom.org/forum/ or contact us directly on GitHub - [http://github.com/rcreasey @rcreasey]

	[[Category:OpenXcom]]		[[Category:OpenXcom]]

Myk002 at 03:27, 18 May 2015

2015-05-18T03:27:14Z

← Older revision		Revision as of 03:27, 18 May 2015
Line 27:		Line 27:
	# Push the ''Build'' button and cross your fingers ;)		# Push the ''Build'' button and cross your fingers ;)
	# Find your newly created bundle in ''./DerivedData/OpenXcom/Build/Products/Release'' folder and copy it to some place you feel comfortable keeping your games in.		# Find your newly created bundle in ''./DerivedData/OpenXcom/Build/Products/Release'' folder and copy it to some place you feel comfortable keeping your games in.
	# Don't forget to copy ~~all~~ the ~~relevant~~ original game data files you possess into the ~~relevant~~ ''~~data~~'' ~~folder~~ within the bundle (see [[Installing (OpenXcom)\|Installing]]), or otherwise the game won’t start. If asked by OSX what to do with the files and folders already present there, select ''Merge''.		# Don't forget to copy the original game data files you possess into the ''UFO'' and/or ''TFTD'' folders within the bundle (see [[Installing (OpenXcom)\|Installing]]), or otherwise the game won’t start. If asked by OSX what to do with the files and folders already present there, select ''Merge''.
	# Enjoy!		# Enjoy!

SupSuper at 20:00, 14 June 2014

2014-06-14T20:00:38Z

← Older revision		Revision as of 20:00, 14 June 2014
Line 14:		Line 14:
	== Instructions ==		== Instructions ==

	# This guide assumes you listened to the previous recommendation and had your dependencies installed with brew terminal command, like this:<br /><pre>$ brew install yaml-cpp sdl sdl_gfx sdl_mixer ~~sdl_image~~</pre>		# This guide assumes you listened to the previous recommendation and had your dependencies installed with brew terminal command, like this:<br /><pre>$ brew install yaml-cpp sdl sdl_gfx sdl_image sdl_mixer --with-flac --with-libmikmod --with-libvorbis</pre>
	# Now, open the ''OpenXcom.xcodeproj'' file and add the source folder to the project:<br />Right-Click on the OpenXcom project icon in the left pane, select ''Add Files to "OpenXcom"'', traverse the folder tree up one level and select the ''src'' folder to be added. Just make sure you choose ''Create groups for any added folders'' option when adding this to your build target.		# Now, open the ''OpenXcom.xcodeproj'' file and add the source folder to the project:<br />Right-Click on the OpenXcom project icon in the left pane, select ''Add Files to "OpenXcom"'', traverse the folder tree up one level and select the ''src'' folder to be added. Just make sure you choose ''Create groups for any added folders'' option when adding this to your build target.
	# Click on the OpenXcom target in the middle pane and select the ''Build Phases'' tab. Look down at ''Copy Bundle Resources'' container and delete all the files irrelevant to our build, namely:		# Click on the OpenXcom target in the middle pane and select the ''Build Phases'' tab. Look down at ''Copy Bundle Resources'' container and delete all the files irrelevant to our build, namely:

SupSuper: Created page with "To successfully build an OpenXcom OSX bundle you will need the relevant Xcode project files provided in the ''xcode'' folder as well as all the relevant dependencies installed..."

2014-05-30T03:17:35Z

Created page with "To successfully build an OpenXcom OSX bundle you will need the relevant Xcode project files provided in the ''xcode'' folder as well as all the relevant dependencies installed..."

New page

To successfully build an OpenXcom OSX bundle you will need the relevant Xcode project files provided in the ''xcode'' folder as well as all the relevant dependencies installed in ''/usr/local/''.

== Dependencies ==

The dependencies you require are the following:
* SDL (libsdl1.2)
* SDL_mixer (libsdl-mixer1.2)
* SDL_gfx (libsdl-gfx1.2), version 2.0.22 or later
* SDL_image (libsdl-image1.2)
* yaml-cpp, version 0.5 or later

If you want to save yourself the trouble - don't do it manually, use [http://mxcl.github.com/homebrew/ Homebrew package manager] instead.

== Instructions ==

# This guide assumes you listened to the previous recommendation and had your dependencies installed with brew terminal command, like this:<br /><pre>$ brew install yaml-cpp sdl sdl_gfx sdl_mixer sdl_image</pre>
# Now, open the ''OpenXcom.xcodeproj'' file and add the source folder to the project:<br />Right-Click on the OpenXcom project icon in the left pane, select ''Add Files to "OpenXcom"'', traverse the folder tree up one level and select the ''src'' folder to be added. Just make sure you choose ''Create groups for any added folders'' option when adding this to your build target.
# Click on the OpenXcom target in the middle pane and select the ''Build Phases'' tab. Look down at ''Copy Bundle Resources'' container and delete all the files irrelevant to our build, namely:
#* OpenXcom.2010.vcxproj
#* CMakeLists.txt
#* Makefile.simple
#* OpenXcom.rc
#* OpenXcom.2010.sln
#* OpenXcom.2010.vcxproj.user
#* OpenXcom.2010.vcxproj.filters
#* Makefile.gcc-pch
# Push the ''Build'' button and cross your fingers ;)
# Find your newly created bundle in ''./DerivedData/OpenXcom/Build/Products/Release'' folder and copy it to some place you feel comfortable keeping your games in.
# Don't forget to copy all the relevant original game data files you possess into the relevant ''data'' folder within the bundle (see [[Installing (OpenXcom)|Installing]]), or otherwise the game won’t start. If asked by OSX what to do with the files and folders already present there, select ''Merge''.
# Enjoy!

Should you require any further assistance regarding the OSX build - feel free to ask around on the [http://openxcom.org/forum/ official forums] or contact me directly on [http://github.com/luciderous GitHub].

[[Category:OpenXcom]]