iOS：如何在Framework中添加Assets文件夹并正确访问资源？

嘿，作为iOS新手碰到这个问题真的很常见，完全不用慌——Framework里是可以创建并使用Assets文件夹的，只是你之前的操作可能漏掉了几个关键步骤，导致资源无法被正确加载。下面一步步给你讲正确的做法：

一、正确添加Asset Catalog到Framework #

1. 更稳妥的添加方式（不建议直接拖Finder文件夹）：
   • 在Xcode里选中你的Framework目标（不是主App），右键选择「New File...」
   • 在模板列表的「Resource」分类里选「Asset Catalog」，点击「Next」
   • 给这个资源目录起个名字（比如FrameworkAssets），确保下方「Targets」只勾选你的Framework，再点击「Create」
2. 如果已经手动拖了Assets文件夹进来，必须检查两个关键设置：
   • 选中Assets文件夹，看右侧「File Inspector」的「Target Membership」，确保只勾选你的Framework（别选主App）
   • 进入Framework的「Build Phases」标签，检查「Copy Bundle Resources」列表里有没有这个Assets文件夹，没有的话点「+」把它加进去

二、正确加载Framework里的资源 #

这是最容易踩坑的点！Framework有自己独立的Bundle，不能像主App那样直接用UIImage(named: "xxx")加载，必须指定Framework的Bundle：

Swift 写法 #

// 替换成你的Framework的Bundle Identifier（在Framework的Info.plist里找CFBundleIdentifier）
guard let frameworkBundle = Bundle(identifier: "com.yourteam.YourFrameworkName") else {
    print("找不到Framework的Bundle")
    return nil
}
// 加载图片，第三个参数传nil即可
let targetImage = UIImage(named: "YourImageName", in: frameworkBundle, compatibleWith: nil)

如果你的Framework是用Swift Package Manager创建的，Xcode 11+还支持更简洁的写法：

let targetImage = UIImage(named: "YourImageName", in: Bundle.module, compatibleWith: nil)

Objective-C 写法 #

// 替换成你的Framework的Bundle Identifier
NSBundle *frameworkBundle = [NSBundle bundleWithIdentifier:@"com.yourteam.YourFrameworkName"];
UIImage *targetImage = [UIImage imageNamed:@"YourImageName" inBundle:frameworkBundle compatibleWithTraitCollection:nil];

三、几个额外注意事项 #

• 资源名称是大小写敏感的！比如Assets里的图片叫Logo.png，代码里写logo就会加载失败
• 不要让主App的Target也勾选Assets的Target Membership，否则会导致资源冲突，甚至加载错误版本
• 如果是颜色资源，加载逻辑和图片一致，比如Swift里用UIColor(named: "YourColor", in: frameworkBundle, compatibleWith: nil)

按照上面的步骤操作，你的Framework资源应该就能正常显示啦！

内容的提问来源于stack exchange，提问作者Archie G. Quiñones