The first step to using any new project or tool is to get it installed and setup on your machine. This quick guide will walk through the process of getting your Windows box setup to use the Soup Command Line Application to build your C++ code.
Soup Build is at the end of the day just a build system; you will need a Compiler and Linker to do anything useful. In the future Soup will work with all compilers (and may even ship with one in the box), however, due to C++ 20 implementation limitations, its first iteration only supports the Microsoft C++ Compiler (MSVC). MSVC can be found in either Visual Studio 2019 by selecting the "Desktop development with c++" workload or in the Visual Studio 2019 Build Tools. Once installed, Soup relies on a tool called vswhere to locate the compiler installation and automatically inject it into the build execution. Note: You will want to have the latest versions of MSVC if you plan to do any C++20 Modules code, which is a main focus of the Soup build system.
The fastest and easiest way to get Soup is to download the installer from the latest release artifacts on GitHub. If you would like to have full control over where the executable is placed on your machine you do have the option to download the raw zip archive. This tutorial assumes that you want to take the easy path and rely on the installer.
Step 3: Grant permissions to the unknown installer. Note: The reason there are so many scary looking messages from Windows is because Soup is in Alpha and has not setup code signing for its installer yet. Generally you should not trust any installer that has not been signed by an offical publisher, and in this case please ensure you only download the version that is uploaded to the GitHub artifacts store. This will all be streamlined when the project enters Beta.
Step 4: Accept the end user license agreement and complete the installation.
The installers primary job is to place all of the required executable binaries and their dependencies into the correct Soup folder under the x64 Program Files folder (C:\Program Files\SoupBuild\Soup)
Lastly the installation will register the Soup Program Files folder to the system Environment Variable PATH so it is available from all command prompts.
Now that everything is setup and running check out my next set of tutorials showing how to build a simple executable.