iOS静态库加载内部Bundle中JSON文件失败求助

问题根源 #

仅通过Xcode的「Copy Bundle Resources」添加资源文件，对Swift Package Manager（SPM）管理的静态库无效——SPM要求必须在Package.swift中显式声明资源，否则资源不会被正确打包到库的专属bundle中。

解决步骤 #

1. 修改Package.swift声明资源
   在库的target配置中添加resources字段，指定要打包的JSON文件：

   let package = Package(
       name: "YourLibraryName",
       products: [
           .library(name: "YourLibraryName", targets: ["YourLibraryName"]),
       ],
       targets: [
           .target(
               name: "YourLibraryName",
               // 声明要处理的资源文件，路径需与实际文件位置匹配
               resources: [.process("configs.json")]
           ),
           .testTarget(
               name: "YourLibraryNameTests",
               dependencies: ["YourLibraryName"]
           ),
       ]
   )
   

   • 如果JSON文件放在Resources子目录下，改为.process("Resources/configs.json")；
   • .process会让SPM自动处理资源的打包路径，无需手动配置Copy规则。

2. 修正资源获取代码
   放弃Bundle.main或Bundle(for:)的方式，使用SPM提供的Bundle.module属性获取库的专属bundle：

   guard let bundle = Bundle.module else {
       fatalError("无法加载库的资源bundle")
   }
   guard let jsonUrl = bundle.url(forResource: "configs", withExtension: "json") else {
       fatalError("configs.json未找到")
   }
   // 后续解析JSON的逻辑
   

   Bundle.module是SPM为模块自动生成的属性，能精准定位到库的资源bundle，避免宿主应用bundle的干扰。

3. 清理缓存并重建
   执行Command+Shift+K清理项目缓存，再重新构建库和宿主应用，确保资源文件被正确打包。

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