混编OC&Swift的Cocoapods Framework资源加载异常问题排查

核心原因拆解 #

问题本质是CocoaPods对混编/纯Swift Framework的资源Bundle处理逻辑不同，再加上Bundle(for: .self)的行为差异共同导致：

1. CocoaPods的resource_bundles机制
   你在podspec中配置的resource_bundles会将资源打包到独立的资源Bundle中，而非主Framework的Bundle。CocoaPods会自动修改这个资源Bundle的标识为org.cocoapods.MyFramework（替换你Framework的原始标识com.be.MyFramework），所有图片等资源实际存储在这个独立Bundle里。

2. 纯Swift Framework的Bundle(for: .self)行为
   对于纯Swift Framework，CocoaPods会做特殊关联处理：当调用Bundle(for: SomeSwiftClass.self)时，Swift运行时返回的Bundle直接指向资源Bundle，而非主Framework的Bundle。因此用这个Bundle可以直接找到Assets中的图片。

3. 混编Framework的Bundle(for: .self)行为
   如果你选取的<MyClass>是Objective-C类，Bundle(for: <MyClass>.self)返回的是主Framework的Bundle（标识为com.be.MyFramework）——因为Objective-C类的二进制编译在主Framework中，其关联的Bundle默认是主Framework的Bundle。而资源不在这个Bundle里，自然加载失败。
   即使你选取的是Swift类，混编场景下CocoaPods的关联逻辑会被破坏，Bundle(for: .self)仍会返回主Framework的Bundle，导致无法找到资源。

验证方式 #

你可以打印两个Bundle的路径确认差异：

// 主Framework的Bundle路径
print(Bundle(for: <MyClass>.self).bundlePath)
// 资源Bundle的路径
print(Bundle(identifier: "org.cocoapods.MyFramework")?.bundlePath ?? "")

主Framework的Bundle路径通常是YourApp.app/Frameworks/MyFramework.framework，而资源Bundle的路径是YourApp.app/Frameworks/MyFramework.framework/Resources/MyFramework.bundle（或同级目录，取决于CocoaPods版本），二者完全独立。

稳定解决方案 #

不依赖Bundle(for: .self)的不确定性，推荐两种可靠方式获取资源Bundle：

1. 通过CocoaPods生成的标识获取（你已验证可行）：

   guard let resourceBundle = Bundle(identifier: "org.cocoapods.MyFramework") else {
       fatalError("无法找到资源Bundle")
   }
   let image = UIImage(named: "someImage", in: resourceBundle, compatibleWith: nil)
   

2. 通过主Framework的Bundle查找资源Bundle（更稳定，不依赖标识）：

   let mainFrameworkBundle = Bundle(for: <MyClass>.self)
   guard let resourceBundlePath = mainFrameworkBundle.path(forResource: "<MyFramework>", ofType: "bundle"),
         let resourceBundle = Bundle(path: resourceBundlePath) else {
       fatalError("无法找到资源Bundle")
   }
   let image = UIImage(named: "someImage", in: resourceBundle, compatibleWith: nil)
   

   这里的<MyFramework>是你在resource_bundles配置中指定的键名，与资源Bundle的文件名一致。

内容的提问来源于stack exchange，提问作者James. H