BUILDING.md

How to Build Soda

Soda is a command-line program written in C++ and using SDL. On most systems the build is fairly straightforward once the prerequisites are met.

Prerequisites

1. Make sure you have a C++ toolchain installed. Currently, the Linux/Mac makefile assumes this is accessed via a gcc command. You can use gcc -v to verify that such a compiler is installed, and check the version number. On Windows, install the Visual Studio Command-Line Tools.

2. Install the SDL2 and SDL2_image development libraries. For details, see:

• https://wiki.libsdl.org/Installation
• https://www.libsdl.org/projects/SDL_image/

Build Steps (Mac/Linux)

1. cd soda to change to the soda subdirectory (next to this document).
2. ./configure to run the configure script. This will detect what platform you are on, and copy the appropriate makefile to the Build directory.
3. cd Build to change to the soda/Build subdirectory.
4. make to build the soda executable. If all goes well, you will now have a soda executable in the Build directory.
5. (optional) sudo make install to copy the executable into /usr/local/bin, making it easily accessible from any directory (assuming this is in your PATH, as is usually the case).
6. (optional) make clean to clean intermediate products out of the Build directory.

Build Steps (Windows)

0. Run the Developer Command Prompt for VS.
1. cd soda to change to the soda subdirectory (next to this document).
2. cd src to move to the soda\src directory.
3. cl /EHsc /wd4068 *.cpp MiniScript/*.cpp /Fesoda.exe

That should do it if the SDL paths are all sorted out. Which they probably aren't. This is a work in progress.