Vulkan SDKを用いたプログラムをビルド・実行する手順を説明します。 以下のプログラムをエラーなくコンパイルすることが目標です。

#include <vulkan/vulkan.hpp>

int main() {
    return 0;
}

前節でVulkan SDKをインストールしていること、および基本的なコマンドライン(シェル)の使い方を知っていることを前提とします。

インストールするもの

• CMake
• vcpkg
• 何らかのC++コンパイラ
  • GCC
  • Clang
  • Visual C++

vcpkgはVulkan単独での使用の際には不要ですが、「glfw」や「glm」といった便利な補助的ライブラリを入れる際にとても便利なので強く推奨しておきます。

ビルド手順

1. 空のディレクトリを作成してそこに移動する。

   mkdir vulkan-test
   cd vulkan-test
   

2. ディレクトリに以下のファイルを配置する。
   • main.cpp(プログラムファイル)

   #include <vulkan/vulkan.hpp>
   
   int main() {
       return 0;
   }
   

   • CMakeLists.txt(ビルドスクリプト)

   cmake_minimum_required(VERSION 3.22)
   
   project(vulkan-test)
   
   set(CMAKE_CXX_STANDARD 17)
   
   add_executable(app main.cpp)
   
   find_package(Vulkan REQUIRED)
   target_include_directories(app PRIVATE ${Vulkan_INCLUDE_DIRS})
   target_link_libraries(app PRIVATE ${Vulkan_LIBRARIES})
   

3. buildディレクトリを作成して移動する。

   mkdir build
   cd build
   

4. CMakeのコンフィグを行う。vcpkgのパスを指定することに注意。

   cmake .. -DCMAKE_TOOLCHAIN_FILE=(vcpkgのインストールパス)/scripts/buildsystems/vcpkg.cmake
   

5. ビルドを実行する。

   cmake --build .
   

   これで実行ファイルが生成されます。(GCC/Clangならばbuild/appに、Visual Studioならbuild/Debug/app.exeに)

過去にはVisual Studioによる開発方法を案内していたので、その内容も残しておきます。

#include <vulkan/vulkan.hpp>

int main() {
    return 0;
}