2022-06-20

在 Windows 上使用 Xmake 配置 Vulkan 开发环境

也可以是C++小项目的配置

开发环境构建

vscode+xmake+clang+clangd

如果在配置过程中有问题，可以先看一下文末的FQA

C++编译工具链

• Visual Studio 2022
• clang

构建系统

xmake

Vulkan SDK

https://www.lunarg.com/vulkan-sdk/

假装IDE的文本编辑器

Visual Studio Code

安装插件

• clangd
• XMake

Getting started

上面列出来的工具下载完成后，新建一个目录，在目录下新建xmake.lua，写入下面内容

set_project("vulkan")

set_arch("x64")
set_warnings("all")
set_languages("c++20")
set_toolchains("clang")

add_rules("mode.debug", "mode.releasedbg", "mode.release", "mode.minsizerel")

add_requires("vulkansdk", "glfw", "glm")

target("main")
    set_default(true)
    set_kind("binary")
    add_files("src/main.cpp")
    add_packages("vulkansdk", "glfw", "glm")

依赖的 vulkansdk 在上面已经下载，如果用他的 installer 安装会自动设置环境变量，xmake 会根据环境变量自动探测编译器、vulkansdk 的正确位置，glm 和 glfw 由 xmake 的包管理处理

编译

测试代码来自vulkan tutorial

直接新建一个main.cpp，把代码复制下来

一切配置好后，可以测试一下了

xmake
xmake run

出现窗口代表环境配置成功

Intellisense

xmake会在.vscode目录自动生成compile_commands.json

所以我们在.vscode/settings.json给clangd加上参数

{
    "clangd.arguments": [
        "--compile-commands-dir=.vscode",
        "--header-insertion=never",
        "--completion-style=detailed"
    ]
}

FQA

Q: xmake下载包失败怎么办

A: 查看文档使用远程包 - xmake

Q: 编译失败怎么办

A: 执行xmake -v，查看详细输出信息

Q: 我想用vs写代码怎么办

A: 执行xmake project -k vsxmake -m "debug,release"生成vs工程文件