iOS 16下框架资源加载异常：Xcode运行时图片返回nil问题排查

问题背景 #

私有库通过CocoaPods以本地路径结合use_frameworks!引入项目，包含多应用共用的图片资源。此前使用以下代码从库的Bundle加载图片：

NSBundle *podBundle = [NSBundle bundleForClass:[self classForCoder]];
NSBundle *imagesBundle = [NSBundle bundleWithURL:[podBundle URLForResource:@"LibKwindoo" withExtension:@"bundle"]];
self.imageView.image = [UIImage imageNamed:@"ImageName" inBundle:imagesBundle compatibleWithTraitCollection:nil];

该代码在iOS 16前正常运行，使用iOS 16 SDK编译后在iOS 15设备上也能正常工作，但在iOS 16设备/模拟器上出现以下异常：

• 通过Xcode直接运行时，图片返回nil
• 直接在设备上独立运行App时，图片加载正常
• 已确认Bundle路径正确，编译后的.car资源包已包含在.app内

导致问题的iOS 16相关变更 #

• Xcode调试模式下的资源路径重定向：iOS 16配合Xcode 14+在调试运行时，会将App的资源加载路径指向Xcode的临时工作目录，而非设备上的App安装目录。虽然代码中获取的Bundle路径字符串看似正确，但实际调试环境下系统无法从临时目录正确索引到私有库Bundle内的.car资源。
• Asset Catalog调试加载机制调整：iOS 16对Asset Catalog的调试加载逻辑做了优化，Xcode运行时会对.car资源做临时缓存和索引重构，这与独立运行App时直接读取包内.car文件的逻辑不一致，导致调试时无法匹配到图片资源。
• NSBundle调试行为差异：bundleForClass:方法在iOS 16调试环境下返回的Bundle实例，其内部资源查找的优先级与正式运行时不同。即使子Bundle的URL路径正确，调试模式下的Bundle实例无法正确解析.car中的图片资源。

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