主Bundle中ODR图片资源测试失败，如何排查问题？

1. 找错了目标Bundle #

在单元测试环境中：

• Bundle(for: type(of: self)) 获取的是测试模块的Bundle，不是主App的Bundle
• Bundle.main 默认指向的也是测试模块的Bundle，而非主App的Bundle

要获取主App的Bundle，有两种可靠方式：

• 通过主App的Bundle ID获取：

  guard let mainAppBundle = Bundle(identifier: "com.yourcompany.yourapp") else {
      XCTFail("主App Bundle未找到")
      return
  }
  

• 通过主App中的任意类获取（比如AppDelegate或者自定义工具类）：

  let mainAppBundle = Bundle(for: AppDelegate.self)
  

2. ODR资源的存储路径特殊 #

ODR（按需资源）不会直接放在主Bundle根目录，而是被打包在OnDemandResources子目录下（具体路径可能因资源打包方式略有差异）。常规的url(forResource:withExtension:)方法无法直接找到它们，必须指定子目录：

let fileUrl = mainAppBundle.url(forResource: fileNameWithoutExtension, 
                               withExtension: fileExtension, 
                               subdirectory: "OnDemandResources")

如果你的ODR图片是放在Asset Catalog中管理的，还需要用NSBundleResourceRequest先请求访问资源，再进行检查：

let resourceRequest = NSBundleResourceRequest(tags: ["your-odr-tag"])
resourceRequest.beginAccessingResources { error in
    defer { resourceRequest.endAccessingResources() }
    if let error = error {
        XCTFail("加载ODR资源失败：\(error.localizedDescription)")
        return
    }
    // 这里再执行图片存在性检查
}

3. 文件名大小写不匹配 #

iOS的Bundle对文件名大小写敏感，比如Filename.jpg和filename.jpg会被判定为不同文件。请确认cat.image中的文件名与Bundle内实际文件名完全一致（包括大小写）。

修正后的测试代码示例 #

func testODRImagesExist() {
    // 获取主App Bundle
    guard let mainAppBundle = Bundle(identifier: "com.yourcompany.yourapp") else {
        XCTFail("无法获取主App Bundle")
        return
    }
    
    for cat in cats {
        let fileURL = URL(fileURLWithPath: cat.image)
        let fileName = fileURL.deletingPathExtension().lastPathComponent
        let fileExt = fileURL.pathExtension
        
        // 指定ODR资源所在子目录
        let odrResourceUrl = mainAppBundle.url(forResource: fileName, 
                                              withExtension: fileExt, 
                                              subdirectory: "OnDemandResources")
        
        XCTAssertNotNil(odrResourceUrl, "文件 \(cat.image) 不在ODR资源目录中")
        if let url = odrResourceUrl {
            XCTAssertTrue(FileManager.default.fileExists(atPath: url.path), "文件 \(cat.image) 实际不存在")
        }
    }
}

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