多品牌适配场景下如何从自定义Bundle加载XCAsset的图片与color codes

前置配置校验（必做，80%的加载失败都是这步没做对） #

• 各品牌独立的.xcassets文件的Target Membership，只勾选对应的自定义Bundle Target，绝对不要同时勾主App Target——不然相同名称的资源会被主Bundle的Assets.car抢先收录，最后加载出来的永远是主App的默认资源，根本拿不到品牌差异化配置
• 编译完直接右键Products文件夹里的.app文件，显示包内容，找到对应的.bundle文件，再显示包内容，确认里面有Assets.car文件。没有这个文件说明XCAsset根本没被打进Bundle，不管后面代码怎么写都加载不出来
• 不要手动把XCAsset拖进Copy Bundle Resources列表，Xcode会自动把关联到Target的XCAsset编译成Assets.car打进对应Bundle，手动加了反而会出问题

加载自定义Bundle内XCAsset中的图片 #

核心逻辑不需要手动拼接图片路径、找png文件，只要正确关联Bundle实例，直接调用系统初始化方法就能匹配到Assets.car里的资源，支持深色模式、多缩放规格的全量适配。

1. 先封装获取品牌自定义Bundle的通用方法：

// 传入品牌对应的Bundle文件名，比如 "BrandX.bundle"
static func getBrandBundle(bundleName: String) -> Bundle? {
    guard let bundlePath = Bundle.main.path(forResource: bundleName, ofType: "bundle") else {
        return nil
    }
    return Bundle(path: bundlePath)
}

2. 封装图片加载方法：

static func loadBrandImage(named imageName: String, bundle: Bundle?) -> UIImage? {
    guard let targetBundle = bundle else {
        // 没传入品牌Bundle时走主App资源加载
        return UIImage(named: imageName)
    }
    // 关键：传入对应Bundle实例，让系统自动匹配Bundle内的Assets.car
    return UIImage(named: imageName, in: targetBundle, compatibleWith: nil)
}

避坑提醒：别用UIImage(contentsOfFile:)的方式试图加载XCAsset里的图片——XCAsset编译之后是归档格式，根本不存在独立的png文件路径，这么写100%加载失败。

加载自定义Bundle内XCAsset中的颜色 #

iOS 13+系统支持从Asset Catalog加载自定义颜色，加载逻辑和图片完全一致，同样通过Bundle关联匹配对应的Assets.car资源：

1. 封装颜色加载方法：

static func loadBrandColor(named colorName: String, bundle: Bundle?) -> UIColor? {
    guard let targetBundle = bundle else {
        return UIColor(named: colorName)
    }
    return UIColor(named: colorName, in: targetBundle, compatibleWith: nil)
}

2. SwiftUI场景适配：如果项目用SwiftUI，直接把获取到的品牌Bundle传给系统初始化方法即可，不需要额外封装：
   • 图片加载：Image("图片名称", bundle: targetBundle)
   • 颜色加载：Color("颜色名称", bundle: targetBundle)

常见加载失败排查点 #

• 先找对Bundle位置：自定义Bundle要放在主App的资源根目录，别嵌套在其他子文件夹里，不然path(forResource:ofType:)会直接返回nil
• 排查资源覆盖问题：如果加载出来的资源和配置的品牌不一样，就检查是不是XCAsset同时勾了主App和自定义Bundle的Target，被主资源包覆盖了
• 版本兼容提醒：如果项目最低支持版本低于iOS 13，XCAsset里的自定义颜色是根本没法通过系统API加载的，这部分要提前做好版本分支适配

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