添加-fcikernel编译标志后SwiftUI无法加载Metal着色器

问题背景 #

为了让Core Image Metal Kernel正常工作，你在Build Settings的Other Metal Compile Flags和Other Metal Link Flags中全局添加了-fcikernel标志，但之后SwiftUI代码里通过ShaderLibrary.default加载自定义着色器时失败，报错如下：

NSBundle....simruntime/Contents/Resources/RuntimeRoot/System/Library/PrivateFrameworks/MetalTools.framework/ 的主类为nil，因为所有回退方案均失败

原因分析 #

-fcikernel是专门用于编译Core Image Kernel类型Metal代码的标志，全局设置会让Xcode把所有Metal文件都按CI Kernel规则编译。但SwiftUI的Shader依赖的是标准Metal着色器，这类着色器不需要该标志，强制编译会导致着色器库无法被正确识别和加载。

解决方案 #

不要全局设置-fcikernel，仅给Core Image Kernel对应的Metal文件单独配置该标志：

• 在Xcode项目中找到你的Core Image Kernel文件（通常命名类似xxx.cikernel.metal）
• 选中该文件，打开右侧的「文件检查器」（File Inspector）
• 滚动到「Build Settings」区域，找到Other Metal Compile Flags，添加-fcikernel
• 返回项目级Build Settings，移除Other Metal Compile Flags和Other Metal Link Flags中的全局-fcikernel标志

这样既保证Core Image Kernel能正常编译，又不会影响SwiftUI标准Metal着色器的加载。

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