UFOpaedia - User contributions [en]

Compiling (OpenXcom)

2020-11-10T15:34:41Z

Uqs: s/SupSuper/OpenXcom/

The OpenXcom codebase is hosted on [https://github.com/OpenXcom/OpenXcom Github], and you can grab the latest source with any Git client from: <code>https://github.com/OpenXcom/OpenXcom.git</code>

If you're a Github user you might wanna [http://help.github.com/forking use a fork] instead so you can have your own remote repository (you can't push to the official OpenXcom repository without permission) and easily send in pull requests.

OpenXcom is a cross-platform game so it's possible to compile it on a variety of systems and project files for all the popular IDEs are included. There's also a [http://openxcom.org/docs/html/ Doxygen documentation] available.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Dependencies ==

OpenXcom requires the following libraries to compile:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://cms.ferzkopp.net/index.php/software/13-sdl-gfx SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [https://github.com/jbeder/yaml-cpp yaml-cpp], (libyaml-cpp), version 0.5.1 (0.5.2 does ''not'' work, use latest git HEAD if you want newer version)


== All operating systems ==

* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Windows ==

* [[Compiling with Microsoft Visual C++ (OpenXcom)|Compiling with Microsoft Visual C++]]
* [[Compiling with MinGW (OpenXcom)|Compiling with MinGW]]

== Mac OS X ==

* [[Compiling with Xcode (OpenXcom)|Compiling with Xcode]]

== Linux/BSD ==
=== Installing Dependencies ===

On Debian and Debian-derived distributions, such as Ubuntu, all build dependencies can be installed with:

<pre>
apt-get install --no-install-recommends \
build-essential libboost-dev libsdl1.2-dev libsdl-mixer1.2-dev \
libsdl-image1.2-dev libsdl-gfx1.2-dev libyaml-cpp-dev xmlto
</pre>

The <code>--no-install-recommends</code> prevents <code>xmlto</code> from pulling along a gigabyte of unnecessary LaTeX packages.

=== Build Instructions ===
* [[Compiling with Make (OpenXcom)|Compiling with Make]]
* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Android ==

* [[Android port (OpenXcom)|Compiling for Android]]

== OpenXcom Extended (OXCE) ==

See [https://openxcom.org/forum/index.php/topic,7048.0.html Compiling and cross-compiling OXCE]

Covers:
* Windows / VS2107
* Linux / CMake
* MacOS / CMake
* Linux / MXE cross-compile for Windows
* Android / Gradle
* iOS / XCode

[[Category:OpenXcom]]

Compiling with Make (OpenXcom)

2020-11-10T15:34:21Z

Uqs: s/SupSuper/OpenXcom/

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)
* [http://www.libsdl.org/ SDL] (libsdl1.2-dev)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2-dev)
* [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.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 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 ==

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 <code>OpenXcom/bin/openxcom</code>

[[Category:OpenXcom]]

Compiling with CMake (OpenXcom)

2020-11-10T15:31:44Z

Uqs:

CMake is a meta-build system. It doesn't build the code itself. Instead, it autogenerates files for other build systems, like Make or Visual Studio. It is an excellent tool for maintaining consistent build environments across multiple operating systems.

__TOC__

== Before building ==
In addition to the OpenXcom [[Compiling (OpenXcom)#Dependencies |dependencies]], you will need CMake version 2.8.0 or later.

CMake can be used to build OpenXcom with differents tools. So far only the Makefile and Visual Studio have been tried. Other Generators (Xcode/Code blocks, ...) might work, but if you choose to use them, we currently have no way to make sure that they work. If broken, patches are welcome to make them work.

Note : Once a project has been generated, you don't need to regenerate it after updating the source. CMake will automatically check for modifications and regenerate the project for you.

Source dir/build dir: CMake allows you to separate the source directory (where the source resides) from the build directory (where the project is generated). This allows you to always have a clean source directory (no clutter left from builds). The source and build directories can be the same, but it's generally recommended to separate them. The standard name for the build directory is "build", which you must create yourself under the top level OpenXcom directory (where the README.md file is).

== Generate a build project ==

'''Using CMake GUI tool'''
*Launch the CMake configuration tools. First specify the path to the OpenXcom source tree.
*Then specify where the OpenXcom project should be generated (e.g. the "build" directory that you created).
*Click on configure. The first time, CMake will ask you which kind of build tool you wish to use.
*Now CMake will analyze your system and once finished, you will be presented with a list of options. If all is fine for you, then click on generate.

'''Using CMake interactive command line tools'''

ccmake is a command line tool which allows you to configure the build interactively. You can launch it with:
mkdir -p build
cmake -B build -G 'Generator name' .
Generator name, is the name of the build system you wish to use. You can see possible values with:
cmake --help
If omitted, cmake will default to 'Unix Makefile'. Note that this needed only the first time you generate the project.

As with the GUI, tweak the options as needed and then configure the project before generating it.

'''Using CMake command line tools'''
mkdir -p build
cmake -B build -G 'Generator name' -DOPTION_NAME=OPTION_VALUE ..
You can check options value with:
cmake -L
To change the value of an option:
cmake -DOPTION_NAME=OPTION_VALUE ..
For example:
cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$HOME/bin/openxcom.inst .

Once the project is generated, you can use it as you would have done without using CMake.

== End-to-end example ==

This will get you up and running from scratch to a fully functional installation. This example is written with Linux users in mind, but can be adapted easily for Windows or OSX. It shows an alternative way of cd'ing into the build dir and running the compilation commands from there.

git clone git@github.com:OpenXcom/OpenXcom.git openxcom
OR "git clone https://github.com/OpenXcom/OpenXcom.git openxcom" if the above doesn't work for whatever reason
{copy XCOM1 assets into openxcom/bin/UFO and XCOM2 assets into openxcom/bin/TFTD, do not forget to apply the [http://openxcom.org/downloads-extras patchfiles]}
mkdir openxcom/build
cd openxcom/build
cmake ..
ccmake ..
{set CMAKE_BUILD_TYPE to Release (or Debug if you want useful stack traces, but that will slow the game /way/ down)}
{set CMAKE_INSTALL_PREFIX to /home/yourusername/bin/OpenXcom (or whatever)}
{configure, generate, and exit}
make -j3
make install

''' Automated patching and compiling '''

It can also be fully automated, in case you want fast compilation e. g. for testing/using nightlies on a regular basis:

git clone https://github.com/SupSuper/OpenXcom.git openxcom
cp -r /path/to/UFO_vanilla_with_patch_files_applied/* openxcom/bin/UFO/
mkdir openxcom/build
cd openxcom/build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j10
sudo make install

This version downloads the sources, then copies prepared vanilla-files (should already include the [http://openxcom.org/downloads-extras patchfiles]) to the right place. One could as well decompress a prepared 7zip-archive like <code>7za e /path/to/UFO_vanilla_with_patch_files_applied.7z -oopenxcom/bin/UFO/ -y</code>. After that, it compiles automatically as »Release«, also speeding up the process a bit, by using 10 jobs parallel, instead of just 3. As OpenXcom usually is installed automatically in a folder, where users don't have write-access (unless you also change the <code>CMAKE_INSTALL_PREFIX</code> variable accordingly, see <code>-DCMAKE_BUILD_TYPE=Release</code>-line), the <code>sudo</code> before the last command makes sure, a legitimation is requested (if the script is not started already with <code>sudo</code>). If you let it be installed somewhere you have the write permissions, with the mentioned prepared vanilla- and patch-files somewhere laying around, you won't even need the sudo, so you don't need to enter anything for a compilation run. Saving this example adjusted to your need, e. g. as <code>compileopenxcom.sh</code> and making it executable, you have an installation-skript, which needs very little attention. This can save a lot of time, if you compile nightlies more often.

Then there are two ways for getting a well playable/startable game:

''' Starting script '''

Create an executable shell script in your <code>$HOME/bin</code> directory (ensure it is in your PATH) named <code>openxcom</code> with the contents:
#!/bin/sh
"$HOME/bin/OpenXcom/bin/openxcom" -data "$HOME/bin/OpenXcom/share/openxcom/data"

now just run <code>openxcom</code> to play. : )

''' Desktop-icon '''

On Ubuntu-Systems, or in general, using GNOME, you also might want to create a <code>*.desktop</code>-file, which shows a nice icon and starts your OpenXcom as well as that starting-script above. An example would be:

[Desktop Entry]
Version=1.0
Type=Application
Name=OpenXcom
Comment=Open-source clone of UFO: Enemy Unknown
Exec=/binary_path_to/openxcom
Terminal=false
Icon=/path_to_openxcom_basefolder/common/openxcom.png
Categories=Game;StrategyGame;

You can save it as <code>openxcom.desktop</code> either somewhere, you want to start it from (e. g. your desktop) or put it in the suitable folder, where GNOME-Search will find it, e. g. <code>~/.local/share/applications</code>, if you want it only for your own user, or <code>/usr/share/applications</code>, if it is meant for every user. It ''may'' be necessary, to make this file executable.

[[Category:OpenXcom]]

Compiling (OpenXcom)

2020-11-10T15:14:24Z

Uqs: remove autotools

The OpenXcom codebase is hosted on [https://github.com/SupSuper/OpenXcom Github], and you can grab the latest source with any Git client from: <code>https://github.com/SupSuper/OpenXcom.git</code>

If you're a Github user you might wanna [http://help.github.com/forking use a fork] instead so you can have your own remote repository (you can't push to the official OpenXcom repository without permission) and easily send in pull requests.

OpenXcom is a cross-platform game so it's possible to compile it on a variety of systems and project files for all the popular IDEs are included. There's also a [http://openxcom.org/docs/html/ Doxygen documentation] available.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Dependencies ==

OpenXcom requires the following libraries to compile:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://cms.ferzkopp.net/index.php/software/13-sdl-gfx SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [https://github.com/jbeder/yaml-cpp yaml-cpp], (libyaml-cpp), version 0.5.1 (0.5.2 does ''not'' work, use latest git HEAD if you want newer version)


== All operating systems ==

* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Windows ==

* [[Compiling with Microsoft Visual C++ (OpenXcom)|Compiling with Microsoft Visual C++]]
* [[Compiling with MinGW (OpenXcom)|Compiling with MinGW]]

== Mac OS X ==

* [[Compiling with Xcode (OpenXcom)|Compiling with Xcode]]

== Linux/BSD ==
=== Installing Dependencies ===

On Debian and Debian-derived distributions, such as Ubuntu, all build dependencies can be installed with:

<pre>
apt-get install --no-install-recommends \
build-essential libboost-dev libsdl1.2-dev libsdl-mixer1.2-dev \
libsdl-image1.2-dev libsdl-gfx1.2-dev libyaml-cpp-dev xmlto
</pre>

The <code>--no-install-recommends</code> prevents <code>xmlto</code> from pulling along a gigabyte of unnecessary LaTeX packages.

=== Build Instructions ===
* [[Compiling with Make (OpenXcom)|Compiling with Make]]
* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Android ==

* [[Android port (OpenXcom)|Compiling for Android]]

== OpenXcom Extended (OXCE) ==

See [https://openxcom.org/forum/index.php/topic,7048.0.html Compiling and cross-compiling OXCE]

Covers:
* Windows / VS2107
* Linux / CMake
* MacOS / CMake
* Linux / MXE cross-compile for Windows
* Android / Gradle
* iOS / XCode

[[Category:OpenXcom]]