Qt6下获取原生窗口句柄创建Vulkan Surface（macOS遇NSView报错）

问题原因 #

出现“unknown type name NSView”是因为NSView属于macOS Cocoa框架类，Qt默认不会自动引入相关头文件；同时Qt6移除了QMacNativeWidget，需通过平台原生接口正确获取并处理。

解决步骤 #

1. 添加Cocoa框架依赖 #

在Qt项目的.pro文件中加入以下配置，链接Cocoa框架：

LIBS += -framework Cocoa

2. 启用Objective-C++编译 #

由于要调用Cocoa的Objective-C类，需将代码文件后缀改为.mm，或在.pro中添加编译选项：

QMAKE_CXXFLAGS += -x objective-c++

3. 修正NSView获取及Surface创建代码 #

在代码中引入Cocoa头文件，通过Qt平台接口获取NSView并创建Vulkan Surface：

#include <Cocoa/Cocoa.h>
#include <vulkan/vulkan_mvk.h>

// 获取当前QWindow对应的NSView
auto* platformInterface = QGuiApplication::platformNativeInterface();
auto* handle = platformInterface->nativeResourceForWindow("nsview", this);
NSView* nsView = static_cast<NSView*>(handle);

// 创建macOS平台的Vulkan Surface
vk::MacOSSurfaceCreateInfoMVK surfaceInfo{};
surfaceInfo.pView = nsView;
vk::SurfaceKHR surface = vulkanInstance.createSurfaceKHR(surfaceInfo);

4. 启用Vulkan macOS扩展 #

创建Vulkan Instance时必须添加VK_MVK_MACOS_SURFACE_EXTENSION_NAME扩展：

std::vector<const char*> extensions = {
    VK_KHR_SURFACE_EXTENSION_NAME,
    VK_MVK_MACOS_SURFACE_EXTENSION_NAME // 必须添加该扩展
};

vk::InstanceCreateInfo instanceInfo{};
instanceInfo.enabledExtensionCount = extensions.size();
instanceInfo.ppEnabledExtensionNames = extensions.data();

vk::Instance vulkanInstance = vk::createInstance(instanceInfo);

注意事项 #

• Qt6中platformNativeInterface获取NSView的键值为"nsview"，大小写敏感。
• macOS上Vulkan基于Metal层实现，必须使用VK_MVK_macos_surface扩展创建Surface，不能复用Windows平台的Surface创建逻辑。

内容的提问来源于stack exchange，提问作者liuyulvv