You will need build tools and CMake. Assuming you have homebrew installed:
xcode-select --install brew install cmake
Before trying to install python3, it's worth checking if you already have it installed (and if so, which version), by jumping to ‘Verifying install’, below. If you do already have it installed, skip this section.
Installing python3 can be done with homebrew with a simple brew install python which installs both python3 and pip3.
TODO: Document install of construct and bitstring for Python 3 (probably need a requirements.txt for the tools directory)
python3 --version
(expected output Python 3.7.x)
and
pip3 --version
(expected output pip x.x.x from /usr/local/lib/python3.7/site-packages/pip (python 3.7) or similar)
gcc-arm-none-eabiOnce this is done, you'll need to install gcc-arm-none-eabi. The easiest way to install this tool is via homebrew with the following source:
brew tap ArmMbed/homebrew-formulae brew install arm-none-eabi-gcc
Note: If you do not want to/ are unable to use homebrew to do this, you should be able to find the manual install instruction in the arm-none-eabi-gcc.rb file in this repository.
If you want to run code on 32Blit, you should now refer to Building & Running On 32Blit.
You'll need to build and install SDL2:
curl https://www.libsdl.org/release/SDL2-2.0.10.zip -o SDL2-2.0.10.zip unzip SDL2-2.0.10.zip cd SDL2-2.0.10 mkdir build cd build ../configure make sudo make install
Then, set up the 32Blit Makefile from the root of the repository with the following commands:
mkdir build cd build cmake .. -DCMAKE_TOOLCHAIN_FILE=../darwin.toolchain
Now to make any example, type:
make example-name
For example:
make raycaster
This will produce examples/raycaster/raycaster which you should run with:
./examples/raycaster/raycaster
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.