From 3667a5f4dd3665d084b877233c9a78e9614cf0ef Mon Sep 17 00:00:00 2001 From: megabyte0x Date: Fri, 28 Aug 2026 00:36:32 +0530 Subject: [PATCH] docs: document Vulkan build deps via distro packages (non-Ubuntu Linux) The Vulkan guide only covered installing the LunarG Vulkan SDK on Windows and Ubuntu. Add a system-packages path for other Linux distributions with a verified Arch/Asahi command, and call out that SPIRV-Headers is a separate package from spirv-tools (its absence fails CMake configure with "Could not find a package configuration file provided by SPIRV-Headers"). Also note that on Apple Silicon under Asahi Linux the GPU is driven via Mesa's Honeykrisp Vulkan driver, so no SDK install is required. --- docs/guide/Vulkan.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/guide/Vulkan.md b/docs/guide/Vulkan.md index a4942289..8fa8519e 100644 --- a/docs/guide/Vulkan.md +++ b/docs/guide/Vulkan.md @@ -60,6 +60,19 @@ If you see `Vulkan used VRAM` in the output, it means that Vulkan support is wor ([ ! -f "$HOME/.zshrc" ] || grep -qxF "source /opt/vulkan-sdk/setup-env.sh" "$HOME/.zshrc") || (echo "source /opt/vulkan-sdk/setup-env.sh" >> "$HOME/.zshrc") source /opt/vulkan-sdk/setup-env.sh ``` + > + #### Other Linux distributions: system packages {#vulkan-sdk-linux-packages} + Instead of the LunarG SDK, you can install your distribution's Vulkan build packages. You need CMake, Ninja, a `glslc`/shaderc compiler, and the Vulkan headers, loader, and **SPIRV-Headers**. + > + Verified on Arch Linux (including Asahi Linux on Apple Silicon): + ```shell + sudo pacman -S --needed cmake ninja vulkan-headers vulkan-icd-loader \ + shaderc spirv-headers spirv-tools vulkan-tools + ``` + > + > **Note:** `spirv-headers` is a separate package from `spirv-tools` and is easy to miss. Without it, the build fails at CMake configure time with `Could not find a package configuration file provided by "SPIRV-Headers"`. Other distributions ship the same components under similar names (e.g. `vulkan-headers`, `vulkan-loader`/`libvulkan-dev`, `glslc`/`shaderc`, `spirv-headers`). + > + > On Apple Silicon under Asahi Linux there is no Vulkan SDK to install — the Apple GPU is exposed to Vulkan through Mesa's Honeykrisp driver (shipped with `mesa`), and the system packages above are all that's needed to build the Vulkan backend. * :::details Windows only: enable long paths support Open cmd as Administrator and run this command: