Compiling with Make (OpenXcom): Difference between revisions

Latest revision as of 14:58, 10 March 2026

Although using CMake is recommended to generate more robust Makefiles, OpenXcom also provides a basic Makefile for compilation. It tends to work well on Linux, but you may have to pass some custom flags to get things working on other operating systems.

Required packages

git (git)
SDL (libsdl1.2-dev)
SDL_mixer (libsdl-mixer1.2-dev)
SDL_image (libsdl-image1.2-dev)
SDL_gfx (libsdl-gfx1.2-dev), version 2.0.22 or later
yaml-cpp (libyaml-cpp-dev), version 0.5 or later
boost (libboost-dev), required as dependency for yaml-cpp 0.5.

Check the library websites if you can't find them with your distribution's package manager.

Don't forget to copy the X-Com resources to your bin folder as shown in Installing.

Commands

 git clone https://github.com/OpenXcom/OpenXcom.git
 cd OpenXcom/src
 make -f Makefile.simple

On OSX, that last command (for me, at least) is:

 PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig CXX=/usr/bin/clang++ CXXFLAGS="-O2 -I/usr/local/Cellar/boost/1.57.0/include" make -f Makefile.simple -j10

You can now run the game from OpenXcom/bin/openxcom

@@ Line 1: / Line 1: @@
+Although using CMake is recommended to generate more robust Makefiles, OpenXcom also provides a basic Makefile for compilation.  It tends to work well on Linux, but you may have to pass some custom flags to get things working on other operating systems.
 == Required packages ==
 * [http://git-scm.com/ git] (git)
@@ Line 5: / Line 7: @@
 * [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2-dev)
 * [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx] (libsdl-gfx1.2-dev), version 2.0.22 or later
-* [http://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp-dev), version 0.2.6 or later
+* [http://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp-dev), version '''0.5 or later'''
+* [http://www.boost.org boost] (libboost-dev), required as dependency for yaml-cpp 0.5.
-Check the library websites if you can't find them on your distribution's package manager.
+Check the library websites if you can't find them with your distribution's package manager.
+'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''
 == Commands ==
-# Open up a terminal.
+  git clone https://github.com/OpenXcom/OpenXcom.git
-# Type '''git clone <repository url>''' (the official one or your own fork) to get the latest code.
+  cd OpenXcom/src
-# Go into the '''src/''' folder inside the repository you just pulled and rename '''Makefile.simple''' to just '''Makefile'''.
+  make -f Makefile.simple
-# Edit the '''Makefile''' in case there's any settings you need to change for your particular platform.
-# Type '''make''' to compile all the code.
+On OSX, that last command (for me, at least) is:
-# Go to the '''bin/''' folder and run '''./openxcom'''.
-# In the future, you can stay up to date by using '''git pull'''.
+  PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig CXX=/usr/bin/clang++ CXXFLAGS="-O2 -I/usr/local/Cellar/boost/1.57.0/include" make -f Makefile.simple -j10
+You can now run the game from <code>OpenXcom/bin/openxcom</code>
+[[Category:OpenXcom]]