This page gives a few tips and pointers on how to compile Phaethon on various platforms.
Compiler and build system
Phaethon is written in C++, so a C++ compiler, like GCC or clang is required. Phaethon follows the C++14 standard. It has two build systems: Autotools (Autoconf, Automake and Libtool) and CMake. Use whichever you feel more comfortable with.
On Debian-based distributions (including Ubuntu), you should be able to install the required compiler and build system packages with
apt-get install libc6-dev g++ make autoconf automake libtool gettext
On Arch Linux, you can install the necessary packages with
sudo pacman -S base-devel cmake
On other distributions, it should work similarily.
Since Visual Studio does not work with autotools, you have to use the CMake build system if you want to compile xoreos with Visual Studio. If you're using MinGW, however, you're free to choose either build system.
On Windows, it is recommended that instead of Visual Studio, you use MSYS2 together with Mingw-w64 (which can produce both 32-bit and 64-bit binaries). MSYS2 provides a package manager, with which you can install xoreos' library dependencies very easily.
You can install the 32-bit toolchain in MSYS2 with
pacman -S base-devel git mingw-w64-i686-toolchain mingw-w64-i686-cmake
You can install the 64-bit toolchain in MSYS2 with
pacman -S base-devel git mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake
Phaethon uses the following libraries to function:
- zlib (>= 188.8.131.52)
- liblzma (>= 5.0.5)
- libxml2 (>= 2.8.0)
- Boost (>= 1.53.0)
- Qt (>= 5.7.1)
- OpenAL (>= 1.12) (See below)
- MAD (>= 0.15.1b)
- libogg (>= 1.2.0)
- libvorbis (>= 1.3.1)
On Debian-based GNU/Linux distribution (including Ubuntu), you should be able to install these libraries and their development packages with
sudo apt-get install zlib1g-dev liblzma-dev libxml2-dev libboost-all-dev \ libopenal-dev libmad0-dev libogg-dev libvorbis-dev \ qtbase5-dev, libqt5gui5, libqt5widgets5
On Arch Linux, you can install these dependencies with
sudo pacman -S zlib xz libxml2 boost boost-libs openal libmad libogg \ libvorbis qt5-base
Other GNU/Linux distributions should work similarily.
On Windows, if you're using MSYS2, you can install these dependencies for 32-bit with
pacman -S mingw-w64-i686-zlib mingw-w64-i686-xz mingw-w64-i686-libxml2 \ mingw-w64-i686-boost mingw-w64-i686-openal mingw-w64-i686-libmad \ mingw-w64-i686-libogg mingw-w64-i686-libvorbis mingw-w64-i686-qt-creator
On Windows, if you're using MSYS2, you can install these dependencies for 64-bit with
pacman -S mingw-w64-x86_64-zlib mingw-w64-x86_64-xz mingw-w64-x86_64-libxml2 \ mingw-w64-x86_64-boost mingw-w64-x86_64-openal mingw-w64-x86_64-libmad \ mingw-w64-x86_64-libogg mingw-w64-x86_64-libvorbis mingw-w64-x86_64-qt-creator
Windows users not using MSYS2 will have to visit each website manually and download a precompiled version, or, if not available, download the source and compile the library themselves.
A note on OpenAL
On Mac OS X, we're using Apple's OpenAL implementation, so OpenAL does not need to be installed separately there.
On both GNU/Linux and Microsoft Windows, we require OpenAL Soft. There is a propriety OpenAL implementation by Creative Labs, Inc. for Microsoft Windows, which can be found at http://openal.org/, but it's unfortunately old, outdated and abandoned. We do not recommend its use.
Make sure you have your compiler, build system and libraries installed correctly. Then open a terminal and change into the directory of your sources.
./autogen.sh && ./configure && make
The binaries can then be found in the src subdirectory.
Optional, non-conventional ./configure flags:
||Compile with -Werror|
||Compile without the extra warnings enabled|
||Compile with link-time optimization|
cmake . && make
The binaries can then be found in the bin subdirectory.
Please read Running CMake on the CMake website for in-depth information on invoking CMake.
On both build systems,
compiles and runs our unit tests.