SwiftPM可执行Target资源Xcode正常但命令行运行崩溃问题

问题背景 #

我创建了一个包含MyLibrary和MyExecutable的Swift Package：

• MyLibrary包含Resources/Assets.xcassets（内有名为Test的图片），以及通过Bundle.module获取资源的Images.swift文件
• MyExecutable仅调用Images.printTestExists()方法

出现的问题 #

• 在Xcode中运行MyExecutable，输出Exists: true，一切正常
• 命令行执行swift run -c release MyExecutable时程序崩溃，报错：-[NSBundle imageForResource:]: unrecognized selector sent to instance
• 命令行环境下，使用SwiftUI的Image("Test", bundle: .module)也无法显示图片

已在Package.swift中配置.process("Resources")处理资源，疑惑点：为什么命令行下资源无法正常工作？可执行文件应该能访问库的资源才对？

解决方案 #

这个问题本质是Swift Package在命令行Release构建和Xcode Debug构建时的资源打包/解析逻辑不一致导致的，以下是具体原因和解决办法：

1. Bundle.module的路径解析差异 #

Xcode Debug运行时，Bundle.module会自动指向库的独立资源bundle；但命令行Release构建时，资源默认不会被打包成独立的.bundle文件，而是直接平铺在可执行文件的同目录下，导致Bundle.module返回的对象无法识别imageForResource:这类方法（本质是这个Bundle实例并非有效的资源bundle）。

解决办法：手动构造正确的资源Bundle路径，Swift Package在Release构建时会生成名为[你的库名]_Resources.bundle的资源包，示例代码如下：

// 替换MyLibrary为你的实际库名
guard let bundlePath = Bundle.main.path(forResource: "MyLibrary_Resources", ofType: "bundle") else {
    print("无法找到资源Bundle")
    return
}
let resourceBundle = Bundle(path: bundlePath)!
// 用这个resourceBundle加载资源
if let image = NSImage(named: "Test", in: resourceBundle, compatibleWith: nil) {
    print("Exists: true")
} else {
    print("Exists: false")
}

2. XCAssets的编译处理问题 #

命令行环境下，Release构建不会像Xcode那样把XCAssets编译成Assets.car文件，而是保留原始的xcassets目录结构，这就导致imageForResource:或者SwiftUI的Image无法正确读取里面的图片。

解决办法：

• 若不需要多分辨率适配等XCAssets特性，直接把图片从XCAssets中移出，放到Resources根目录下，通过文件路径直接加载：

guard let imagePath = resourceBundle.path(forResource: "Test", ofType: "png") else {
    return
}
let image = NSImage(contentsOfFile: imagePath)

• 若必须使用XCAssets，需要在Package.swift中显式指定资源处理方式，强制编译XCAssets：

.target(
    name: "MyLibrary",
    resources: [
        .process("Resources/Assets.xcassets"),
        // 确保XCAssets被正确编译
        .copy("Resources")
    ]
)

不过这种方式在部分环境下可能仍有问题，更稳妥的方式是针对运行环境做分支处理：检查当前是命令行还是Xcode环境，选择对应的资源加载逻辑。

验证步骤 #

执行swift build -c release后，前往.build/release目录查看：

• 确认MyLibrary_Resources.bundle是否存在
• 打开bundle，检查里面是否有Assets.car（XCAssets编译后的文件）或者原始图片文件

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