These instructions cover setting up Windows Subsystem for Linux so that you can cross-compile for 32Blit.
A basic knowledge of the Linux command-line, installing tools and compiling code from source is assumed.
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: (These are similar to the Linux requirements, see those for more details)
sudo apt install gcc gcc-arm-none-eabi unzip cmake make python3 python3-pip python3-setuptools
pip3 install 32blit construct bitstring
If you are using the older Ubuntu 18.04-based WSL, you will need a newer toolchain than the one provided:
# This repo backports the toolchain from Ubuntu 19.10
sudo add-apt-repository ppa:daft-freak/arm-gcc
sudo apt updateIf 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. This approach is included for completeness but not recommended, since MinGW binaries are statically linked and much larger than the Visual Studio output.
If you're more familiar with Visual Studio then you should follow the instructions in Windows-VisualStudio.md
You will need to install SDL2 and SDL2_image/_net for MinGW.
The following packages enable cross-compiling to Windows via MinGW: (Assuming you have installed the tools for building to 32Blit above.)
sudo apt install gcc-mingw-w64 g++-mingw-w64This 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://github.com/libsdl-org/SDL/releases/download/release-2.24.0/SDL2-devel-2.24.0-mingw.tar.gz
tar xzf SDL2-devel-2.24.0-mingw.tar.gz
sudo cp -r SDL2-2.24.0/x86_64-w64-mingw32 /opt/local/Grab and install the SDL2_image mingw development package:
wget https://github.com/libsdl-org/SDL_image/releases/download/release-2.6.2/SDL2_image-devel-2.6.2-mingw.tar.gz
tar xzf SDL2_image-devel-2.6.2-mingw.tar.gz
sudo cp -r SDL2_image-2.6.2/x86_64-w64-mingw32 /opt/local/Grab and install the SDL2_net mingw development package:
wget https://github.com/libsdl-org/SDL_net/releases/download/release-2.2.0/SDL2_net-devel-2.2.0-mingw.tar.gz
tar xzf SDL2_net-devel-2.2.0-mingw.tar.gz
sudo cp -r SDL2_net-2.2.0/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.toolchainNow to make any example, type:
make example-nameFor example:
make raycasterThis will produce examples/raycaster/raycaster.exe which you should run with:
./examples/raycaster/raycaster.exeWSL 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:
makeWhen 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.