Link

Building the project

Start by syncing the Git project at https://github.com/vblanco20-1/vulkan-guide/. The all-chapters branch contains the example code for the entire project, and the starting-point branch contains the initial empty project setup. I recommend you sync both branches to different folders, and if at one point you get stuck, check how the code works in the all-chapters code. If you want a direct download to the code without using Git just download from these direct links.

All Chapters

Starting Point

You will need Visual Studio to build the project. The code in the project should work cross-platform, but this guide is windows-centric.

First, install the Vulkan SDK https://vulkan.lunarg.com/sdk/home. This will contain the development headers and libraries needed to create Vulkan applications. It is put in a global location, so you don’t need to worry about where it gets installed.

Then grab CMake, as it’s the build system we are going to use. https://cmake.org/.

Once CMake is installed, use CMake-gui to open the project root CMakeLists. Press the Configure button. At this point, it should give you an error about missing SDL2.

SDL2 is a library dependency that we need to get separately from the rest.

You can grab it here https://www.libsdl.org/download-2.0.php . I recommend you just take the development libraries. Once you have unzipped SDL somewhere, put the root path in the SDL2_dir variable of CMake. Note, this is not the /libs or similar folder, but the root folder of SDL itself.

If at this point it complains about not finding Vulkan_INCLUDE_DIR or Vulkan_LIBRARY, make sure you’ve finished installing the Vulkan SDK, then close and open CMake-Gui and try configuring again.

Now that the dependencies are set, you can proceed with CMake and Configure then Generate the project files for Visual Studio (or your IDE of choice).

Cmake should look like this:

cmake

From Visual Studio, select the vulkan-guide target, set as Startup Project, and you can now compile and execute it by just hitting F5 (start debugging)

vs

If you get the message of SDL2 dll missing, go to your sdl folder, lib directory, and grab the dlls from there. Paste them on vulkan_guide/bin/Debug/ folder. (Or Release) . The dll has to be by the side of the vulkan_guide.exe

dll

Next: Chapter 0 code walkthrough