XCode集成Firebase Crashlytics后dSYM上传成功但App版本显示Unknown

核心原因 #

Crashlytics 依赖App的Info.plist中CFBundleShortVersionString（对外显示的版本号）和CFBundleVersion（构建号）来识别版本。如果这两个字段缺失、格式不合法，或者打包过程中未正确嵌入二进制，就会导致控制台版本显示为“Unknown”。另外本地调试的临时构建配置也可能触发该问题。

具体修复步骤 #

• 检查Info.plist版本配置
  确认项目Info.plist中存在CFBundleShortVersionString（对应Xcode的「Version」）和CFBundleVersion（对应Xcode的「Build」），且值为非空的合法字符串（如1.0、20240520，避免特殊字符或空格）。
• 用Archive打包测试
  本地直接运行调试时，临时构建的二进制可能未正确写入版本信息。尝试通过Xcode的Archive功能打包后安装测试，观察版本是否正常显示。
• 确认Crashlytics初始化时机
  确保FirebaseApp.configure()在App启动早期执行（比如AppDelegate的启动方法，或SwiftUIApp结构体的初始化中），延迟初始化可能导致Crashlytics错过版本信息捕获。
• 验证dSYM与版本匹配
  虽然控制台显示dSYM已上传，但要确认上传的dSYM对应版本和崩溃App的版本一致。可通过Xcode Organizer查看归档的dSYM信息，对比Firebase控制台的记录。
• 清理缓存重新构建
  删除Xcode的Derived Data（路径：Xcode → Settings → Locations → Derived Data），执行Cmd+Shift+K清理Build Folder，重新构建后触发测试崩溃，排除旧缓存的干扰。

额外说明 #

日志中提到的「Firebase Analytics SDK not detected」不会直接导致版本显示异常，仅会影响崩溃统计完整性，若需完整功能可后续集成，但当前版本问题与该提示无关。

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