Firebase Crashlytics：上传缺失的 dSYM 以查看 1 个版本的崩溃情况。(iOS)

IOS

上传缺失的 dSYM 以查看 1 个版本的崩溃情况

Firebase Crashlytics 是一个强大的崩溃报告工具，可以帮助开发者快速定位和解决应用程序的崩溃问题。在使用 Firebase Crashlytics 进行崩溃分析时，需要上传缺失的 dSYM 文件以查看特定版本的崩溃情况。本文将介绍如何使用 Firebase Crashlytics 上传 dSYM 文件，并通过一个案例代码演示其使用方法。

什么是 dSYM 文件？

dSYM 文件是 IOS 应用程序的调试符号文件，包含了应用程序的符号表信息。在应用程序编译时，Xcode 会生成 dSYM 文件，用于在崩溃发生时定位和解析崩溃堆栈信息。

为什么需要上传 dSYM 文件？

上传 dSYM 文件是为了让 Firebase Crashlytics 能够解析崩溃堆栈信息，并将其映射到对应的源代码行。这样，开发者就可以准确地知道是哪段代码导致了崩溃，进而快速修复问题。

如何上传 dSYM 文件？

在 Xcode 中，我们可以通过以下步骤上传 dSYM 文件：

1. 打开 Xcode 项目，选择项目的应用程序目标。

2. 在项目设置中，选择 "Build Settings"。

3. 搜索 "Debug Information Format"，将其设置为 "DWARF with dSYM File"。

4. 在 "Build Settings" 中搜索 "Debug Information Level"，将其设置为 "All".

5. 在 "Build Settings" 中搜索 "Debug Information Format"，确保其设置为 "DWARF with dSYM File"。

6. 在 "Build Settings" 中搜索 "Strip Debug Symbols During Copy"，将其设置为 "No"。

7. 在 "Build Settings" 中搜索 "Strip Linked Product"，将其设置为 "No"。

8. 在 "Build Phases" 中，找到 "Run Script" 阶段，确保 "Run Script" 的脚本内容如下：

"${PODS_ROOT}/FirebaseCrashlytics/run"

9. 在终端中，导航到项目的根目录，并运行以下命令：

$ pod install

10. 在 Xcode 中，选择 "Product" -> "Archive"，将应用程序归档。

11. 在 Xcode 中，选择 "Window" -> "Organizer"，找到刚刚归档的应用程序版本，并选择 "Upload to App Store Connect"。

12. 在 Firebase 控制台中，选择对应的项目，点击 "Crashlytics" -> "Versions"。

13. 点击 "Upload missing dSYMs"，选择刚刚导出的 dSYM 文件，并上传。

案例代码

下面是一个简单的案例代码，演示了如何使用 Firebase Crashlytics 进行崩溃报告。

Swift
import UIKit
import FirebaseCrashlytics
class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        // 通过 Crashlytics.log 方法记录日志
        Crashlytics.crashlytics().log("ViewController did load")
        
        // 通过 Crashlytics.setcustomValue 方法设置自定义键值对
        Crashlytics.crashlytics().setcustomValue("example@example.com", forKey: "UserEmAIl")
        
        // 通过 Crashlytics.recordError 方法手动记录错误
        do {
            try FileManager.default.removeItem(atPath: "/path/to/nonexistent/file")
        } catch {
            Crashlytics.crashlytics().record(error: error)
        }
    }
}

通过上传缺失的 dSYM 文件，开发者可以使用 Firebase Crashlytics 来分析特定版本的崩溃情况，并及时解决应用程序中的问题。使用 Firebase Crashlytics 可以大大提升应用程序的稳定性和用户体验，是每个 IOS 开发者都应该掌握的工具。希望本文能够帮助读者更好地理解和使用 Firebase Crashlytics。