Crashlytics缺失本地Swift Packages的dSYMs问题排查求助

核心关联分析 #

静态库类型的Swift Package符号确实应该嵌入主App的dSYM的__swift_ast节中，你这边未找到该节，这就是导致对应UUID的dSYM缺失的直接原因。以下是可能阻止生成该节的设置及修复方案：

关键配置排查与修复 #

• Swift编译模式问题
  Xcode 14默认的增量编译（incremental）可能导致静态库Swift符号无法合并到主dSYM中。需将所有Target（包括Swift Package的隐式Target）的SWIFT_COMPILATION_MODE设置为Whole Module：

  1. 打开项目Build Settings，搜索SWIFT_COMPILATION_MODE
  2. 把Debug/Release配置下的所有Target值改为Whole Module

• Swift Package显式配置缺失
  本地Swift Package不会完全继承主Target的所有编译设置，需在Package.swift中强制指定符号生成规则：

  targets: [
      .target(
          name: "YourLocalSP",
          swiftSettings: [
              .unsafeFlags(["-debug-info-format=dsym"]),
              .unsafeFlags(["-whole-module-optimization"])
          ]
      )
  ]
  

• 禁用Bitcode后的符号处理
  禁用Bitcode后，Xcode不再生成Bitcode相关符号，需确保静态库符号直接嵌入主dSYM：

  1. 全局确认DEBUG_INFORMATION_FORMAT在所有配置下均为DWARF with dSYM File
  2. 清理Build文件夹（Cmd+Shift+K）后重新Archive

验证与CI端调整 #

• 重新Archive后，用dwarfdump --uuid YourApp.dSYM输出所有UUID，对比IPA的symbols文件夹内的UUID，确认缺失项是否已包含
• 用dwarfdump -s YourApp.dSYM检查是否出现__swift_ast节
• Bitrise端需确保脚本遍历所有DerivedData中的dSYM文件（Swift Package的dSYM可能不在主Archive目录下），再上传至Crashlytics

额外修复点 #

• 升级Xcode到14.3及以上版本，早期Xcode 14存在静态库符号合并的已知bug
• 检查第三方Swift Package的Package.swift，若存在debugInfoFormat = .dwarf的设置，需修改为.dsym

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