Build Instructions
Contents
Getting the source
Clone the source code using git, and grab all the submodules:
git clone --recursive https://github.com/PrismLauncher/PrismLauncher.git
cd PrismLauncher
The rest of the documentation assumes you have already cloned the repository.
Building
Tested on OpenBSD 7.0-alpha i386. It should also work on older versions.
Build dependencies
- A C++ compiler capable of building C++11 code (included in base system).
- Qt Development tools 5.12 or newer (meta/qt5).
- cmake 3.1 or newer (devel/cmake).
- extra-cmake-modules (devel/kf5/extra-cmake-modules)
- zlib (included in base system).
- Java JDK (devel/jdk-1.8).
- GL headers (included in base system).
- lwjgl (games/lwjgl and games/lwjgl3).
You can use IDEs, like KDevelop or QtCreator, to open the CMake project if you want to work on the code.
Building a portable binary
mkdir install
# configure the project
cmake -S . -B build \
-DCMAKE_INSTALL_PREFIX=./install -DCMAKE_PREFIX_PATH=/usr/local/lib/qt5/cmake -DENABLE_LTO=ON
# build
cd build
make -j$(nproc) install
cmake --install install --component portable
Building & installing to the system
This is the preferred method of installation, and is suitable for packages.
# configure everything
cmake -S . -B build \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX="/usr/local" \ # /usr/local is default in OpenBSD and FreeBSD
-DCMAKE_PREFIX_PATH=/usr/local/lib/qt5/cmake # use linux layout and point to qt5 libs
-DENABLE_LTO=ON # if you want to enable LTO/IPO
-DLauncher_QT_VERSION_MAJOR="5"
cd build
make -j$(nproc) install # Optionally specify DESTDIR for packages (i.e. DESTDIR=${pkgdir})