Vulkan Test Applications is a repository that contains several sets of
Vulkan applications.
The goals of this project are to maintain a repository of accessible test applications for Vulkan tool developers to leverage, as well as expose interesting or non-obvious implications of the API.
This is not an official Google product (experimental or otherwise), it is just code that happens to be owned by Google. See the CONTRIBUTING.md file for more information. See also the AUTHORS and CONTRIBUTORS files.
These are a set of sample applications that either uses the API in a way that is interesting for tools or use some functionality of the API that has not been exposed to other samples.
These tests are designed to test the functionality of GAPID for Vulkan. They can also be used to expose a variety of function call permutations for any layers. As a group, they attempt to call all Vulkan functions with all permutations of valid inputs. See gapid_tests for more information.
To clone:
git clone --recursive path/to/this/repository
This will ensure that you have all of the dependencies checked out.
To build for Windows (NOTE: see Windows Dependencies).
cmake -G "Visual Studio 14 2015 Win64" /path/to/source
open VulkanTestApplications.sln
or if you want to use Ninja
From a Visual Studio command-prompt
cmake -GNinja /path/to/source -DCMAKE_BUILD_TYPE=Release
ninja
To build for Linux.
cmake -GNinja /path/to/source
ninja
To build for Android.
cmake -GNinja {root} -DBUILD_APKS=ON -DANDROID_SDK=path/to/android/sdk
ninja
This assumes the Android ndk is installed in the default location of path/to/android/sdk/ndk-bundle.
If it is installed elsewhere, use
cmake -GNinja {root} -DBUILD_APKS=ON -DANDROID_SDK=path/to/android/sdk -DANDROID_NDK=path/to/ndk -DCMAKE_GLSL_COMPILER=path/to/glslc
To build only for 32-bit ARM platform.
cmake -GNinja {root} -DBUILD_APKS=ON -DANDROID_SDK=path/to/android/sdk -DANDROID_ABIS=armeabi-v7a -DCMAKE_GLSL_COMPILER=path/to/glslc
glslc is required to compile GLSL shaders to SPIR-V. If it is not
on your path, its location should be specified through -DCMAKE_GLSL_COMPILER
option.
The only specific other compilation options control default behavior for all applications. See entry for more information on these flags.
These should be checked out into third_party.
To build on Windows the following tools and libraries are required:
- cmake (https://cmake.org/)
- Vulkan SDK (https://www.lunarg.com/vulkan-sdk/)
- Python3 (https://www.python.org/)
- Pillow (https://pillow.readthedocs.io/)