使用SPM集成XCFramework在Release配置下无法正常运行

以下是针对Debug运行正常、Release崩溃提示“符号未找到”问题的排查方向和修复方案：

1. 检查XCFramework的Release兼容性 #

• 验证XCFramework是否包含所有目标架构的Release编译产物：
  执行命令lipo -info YourFramework.xcframework/ios-arm64/YourFramework.framework/YourFramework，确认输出包含你需要的架构（比如iOS设备的arm64、模拟器的x86_64/arm64）。
• 确认XCFramework未过度strip符号：如果是自行编译的XCFramework，在Build Settings中把Strip Style设置为Debugging Symbols Only，避免移除必要的链接符号；若是第三方提供的包，联系提供者确认其Release产物保留了完整的链接符号。

2. 修正Wrapper Target的依赖配置 #

• 确保Wrapper Target的Package.swift中正确声明依赖并设置合理的链接属性：

  targets: [
      .target(
          name: "YourWrapperTarget",
          dependencies: [
              .target(name: "YourXCFrameworkTarget"),
              .product(name: "RealmSwift", package: "realm-swift")
          ],
          // 根据XCFramework类型选择static/dynamic，确保依赖符号能传递到主项目
          linking: .static
      ),
      .binaryTarget(
          name: "YourXCFrameworkTarget",
          path: "./YourFramework.xcframework"
      )
  ]
  

• 主项目不要重复添加Realm依赖：本地SPM包已指定Realm精确版本，主项目直接依赖本地包即可，避免版本冲突导致符号不匹配。

3. 调整Release模式的编译优化设置 #

• 关闭Dead Code Stripping：在主项目的Build Settings中，将Release模式下的Dead Code Stripping改为NO，避免编译器误删必要的依赖符号。
• 暂时关闭Link Time Optimization：若开启了Link Time Optimization（LTO），将Release模式下的该选项设置为NO，验证是否是LTO导致符号丢失。如果问题解决，可尝试升级Xcode版本或切换为增量LTO模式。

4. 确认XCFramework与Realm的版本一致性 #

• 确保XCFramework编译时依赖的Realm版本和本地SPM包中指定的版本完全一致：小版本差异都可能导致ABI不兼容，引发符号未找到问题。若是第三方XCFramework，联系提供者确认其编译环境的Realm版本。

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