如何为兼容SPM与Pod Lib的包定义内部Bundle以加载图片

核心思路 #

通过条件编译区分SPM和CocoaPods环境，分别获取对应环境下的资源Bundle，让同一份代码在两种包管理工具下都能正确加载图片资源。

步骤1：编写兼容的Bundle获取逻辑 #

创建一个工具类（比如ResourceBundleHelper），封装Bundle的获取逻辑：

import UIKit

class ResourceBundleHelper {
    static func currentBundle() -> Bundle {
        #if SWIFT_PACKAGE
        // SPM环境下使用自动生成的Bundle.module
        return Bundle.module
        #else
        // CocoaPods环境下查找对应的资源bundle
        let classBundle = Bundle(for: ResourceBundleHelper.self)
        guard let bundleURL = classBundle.url(forResource: "YourBundleName", withExtension: "bundle"),
              let resourceBundle = Bundle(url: bundleURL) else {
            return classBundle
        }
        return resourceBundle
        #endif
    }
}

步骤2：统一资源加载方式 #

后续加载图片时，直接调用这个工具类获取Bundle：

let image = UIImage(named: "MyImage", in: ResourceBundleHelper.currentBundle(), compatibleWith: nil)

步骤3：配置Podspec文件 #

确保你的.podspec中正确配置资源bundle，示例如下：

s.resource_bundles = {
  'YourBundleName' => ['Sources/YourTargetName/Resources/**/*.xcassets']
}

注意：这里的YourBundleName要和步骤1中url(forResource:)的参数完全一致，路径要对应你项目中media.xcassets的实际位置。

关键说明 #

• SWIFT_PACKAGE是SPM自动定义的编译宏，用于区分SPM环境；
• CocoaPods会将资源打包成独立的.bundle文件，所以需要通过主Bundle找到这个子Bundle；
• 不要混用Bundle.module和Bundle(for:)，必须通过条件编译隔离两种逻辑。

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