Compiling on windows like a human

[spoutn1k]

This project is compatible with windows, but windows is not compatible with having a good time. I spend so long fiddling with such inane bullshit that I do not wish it upon anyone else, so here are the steps I go through when building for a release.

The following is tied to your VS install and sets up the environment. We use
this on the command prompt to avoid touching VS Code and their fucky
configuration JSONs with a 10ft pole.

"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64

Run it in every command prompt you use ! Or else the configuration will fail.

Install CMake, Ninja and python3 with choco. CMake configures and Ninja
builds. Ninja is optional but is about 20x faster than whatever VS is using so
we'll use that. Python3 is here as Qt will need it to build.

Fetch the sources and uncompress them where you feel like it. You will need:

• fmt
• spdlog
• zlib
• libpng
• qt6

Set the BUILDDIR variable on the command prompt. We will install all libraries
in there to make it easier to access them later. No need to choose a long term
folder as we compile statically and punt this out after compilation.

SET BUILDDIR=K:\path\to\builddir

For zlib, fmt and spdlog, run in each folder:

mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release^
-DCMAKE_INSTALL_PREFIX=%BUILDDIR%
ninja install

If this is your first time doing this, cmake is going to configure the project
following our instructions, like how to build (release) and where to install
(BUILDDIR), then Ninja will compile the project using the variables set at the
top and the results of the configuration, and finally install it where we asked.
You will find that it created files in BUILDDIR.

For libpng, we need zlib:

mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_INSTALL_PREFIX=%BUILDDIR% ^
-DZLIB_LIBRARY=%BUILDDIR%\lib\zlibstatic.lib ^
-DZLIB_INCLUDE_DIR=%BUILDDIR%\include
ninja install

Configuring Qt is a pain. This is the script that worked. -static is hella
important, as it will save us a headache trying to run the binary. You will find
the configure.bat script at the root of the Qt source.

configure.bat -prefix %BUILDDIR% -static ^
-skip qt3d -skip qtactiveqt -skip qtcharts -skip qtcoap -skip qtconnectivity ^
-skip qtdatavis3d -skip qtdoc -skip qtgraphs -skip qtgrpc -skip qthttpserver ^
-skip qtlanguageserver -skip qtlocation -skip qtlottie -skip qtmqtt ^
-skip qtnetworkauth -skip qtopcua -skip qtpositioning -skip qtremoteobjects ^
-skip qtscxml -skip qtsensors -skip qtserialbus -skip qtserialport ^
-skip qtspeech -skip qtvirtualkeyboard -skip qtwayland -skip qtwebchannel ^
-skip qtwebengine -skip qtwebsockets -skip qtwebview -skip qtmultimedia ^
-- -G Ninja
ninja install

Finally, we can configure mcmap using all the blocks above.

cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_PREFIX_PATH=%BUILDDIR%\lib\cmake\fmt;%BUILDDIR%\lib\cmake\spdlog;%BUILDDIR%\lib\cmake ^
-DCMAKE_INSTALL_PREFIX=%BUILDDIR% ^
-DZLIB_LIBRARY=%BUILDDIR%\lib\zlibstatic.lib ^
-DZLIB_INCLUDE_DIR=%BUILDDIR%\include ^
-DPNG_LIBRARY=%BUILDDIR%\lib\libpng16_static.lib ^
-DPNG_PNG_INCLUDE_DIR=%BUILDDIR%\include
ninja

Notes

You can install cmake through vscode, but good luck getting it to work :) Installing with choco is easier.

Make sure your system clock is up to date, as this can somehow trip up ninja.