Compiling with Xcode (OpenXcom): Difference between revisions

Latest revision as of 14:57, 10 March 2026

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:

cmake, version 3.12.0 or later
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

We recommend using Homebrew to facilitate this. With a working brew utility installed, run the following:

$ brew install cmake yaml-cpp sdl sdl_gfx sdl_image sdl_mixer

This should install all of these necessary dependencies to their appropriate place under /usr/local.

Building

In the root of the repository, generate the Makefile with cmake (Release is also a valid build type):
```
cmake . -DCMAKE_BUILD_TYPE="Debug" -G Xcode
```
Open the OpenXcom.xcodeproj in Xcode.
Copy your vanilla game assets (UFO/TFTD) into the bin/ directory.
Build with cmd-B.
Your artifact will be named openxcom.app in the build target directory (Debug or Release) from the root of the repository.

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 - @rcreasey

@@ Line 18: / Line 18: @@
 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
+$ 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.