These instructions cover setting up Windows Subsystem for Linux so that you can cross-compile Windows-compatible binaries with MinGW. This approach is included for completeness but not recommended, since MinGW binaries are statically linked and much larger than the Visual Studio output.
A basic knowledge of the Linux command-line, installing tools and compiling code from source is assumed.
If you're more familiar with Visual Studio then you should follow the instructions in Windows-VisualStudio.md
To enable Windows Subsystem for Linux, you must access the Turn Windows features on or off dialog. Find the entry for Windows Subsystem for Linux and make sure it is enabled.
After that, proceed to the Microsoft Store to download Ubuntu for WSL.
The following requirements enable cross-compile to 32Blit via ARM GCC and to Windows via MinGW:
# Ubuntu 18.04's gcc-arm-none-eabi is too old, this repo backports the one from 19.10 sudo add-apt-repository ppa:daft-freak/arm-gcc sudo apt update sudo apt install gcc gcc-arm-none-eabi gcc-mingw-w64 g++-mingw-w64 unzip cmake make python3 python3-pip pip3 install 32blit construct bitstring
If you want to run code on 32Blit, you should now refer to Building & Running On 32Blit.
You can use WSL on Windows to cross-compile your project (or any 32Blit example) into a Windows .exe for testing locally.
You will need to cross-compile SDL2 for MinGW and install both it, and SDL2-image.
This will install the SDL2 64bit mingw development headers and libraries into /opt/local/x86_64-w64-mingw32/.
Note: the lib/cmake/SDL2/sdl2-config.cmake shipped with these libraries expects them to be in /opt/local, if you change the install path you will have to modify this file.
First, make sure the /opt/local/ directory exists:
sudo mkdir -p /opt/local/
Grab and install the SDL2 mingw development package:
wget https://libsdl.org/release/SDL2-devel-2.0.10-mingw.tar.gz tar xzf SDL2-devel-2.0.10-mingw.tar.gz sudo cp -r SDL2-2.0.10/x86_64-w64-mingw32 /opt/local/
Grab and install the SDL2_image mingw development package:
wget https://www.libsdl.org/projects/SDL_image/release/SDL2_image-devel-2.0.5-mingw.tar.gz tar xzf SDL2_image-devel-2.0.5-mingw.tar.gz sudo cp -r SDL2_image-2.0.5/x86_64-w64-mingw32 /opt/local/
Finally, set up the 32Blit Makefile from the root of the repository with the following commands:
mkdir build.mingw cd build.mingw cmake .. -DCMAKE_TOOLCHAIN_FILE=../mingw.toolchain
Now to make any example, type:
make example-name
For example:
make raycaster
This will produce examples/raycaster/raycaster.exe which you should run with:
./examples/raycaster/raycaster.exe
WSL will launch the example in Windows, using the required SDL2.dll that will have been copied into the build root.
Don't forget to include SDL2.dll this if you want to redistribute a game/example.
Alternatively you can build everything by just typing:
make
When the build completes you should be able to run any example.
If you see cannot create target because another target with the same name already exists you've probably run cmake .. in the wrong directory (the project directory rather than the build directory), you should remove all but your project files and cmake .. again from the build directory.