ios开启调试模式查看app崩溃日志

原创

mob64ca12e63b18 2024-09-17 05:32:10 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12e63b18的原创作品，请联系作者获取转载授权，否则将追究法律责任

iOS 开启调试模式查看 App 崩溃日志

在开发 iOS 应用时，了解如何获取应用崩溃日志是非常重要的，它可以帮助开发者快速定位和修复问题。本文将指导你如何在 iOS 中开启调试模式并查看应用的崩溃日志，特别适合新入行的开发者。这一过程将通过表格展示步骤，并详细解释每一步所需的代码。

整体流程

步骤	描述
1	激活调试模式并使用 Xcode
2	在代码中添加崩溃日志捕捉
3	运行应用并引发崩溃
4	查看崩溃日志

每一步的详细操作

步骤 1: 激活调试模式并使用 Xcode

打开你在 Xcode 中的项目。
连接你的 iOS 设备并确保设备处于开发者模式。
选择运行目标为你的设备（而非模拟器）。
点击 Xcode 界面左上角的“运行”按钮（一个三角形图标）。

步骤 2: 在代码中添加崩溃日志捕捉

在代码中，我们可以通过 NSSetUncaughtExceptionHandler 来捕捉崩溃日志。请在你的 AppDelegate 中添加如下代码：

func setupCrashHandler() {
    NSSetUncaughtExceptionHandler { exception in
        let crashMessage = """
        Exception Name: \(exception.name)
        Exception Reason: \(exception.reason ?? "No reason") 
        Call Stack: \(exception.callStackSymbols)
        """
        print(crashMessage)
        // 可将崩溃信息存储在文件或上传到服务器
    }
}

// 在 application(_:didFinishLaunchingWithOptions:) 中调用 setupCrashHandler()
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    setupCrashHandler()
    return true
}

代码解释:

NSSetUncaughtExceptionHandler：设置一个处理未捕获异常的函数。
exception.name：捕捉崩溃的类型。
exception.reason：捕捉崩溃的原因。
exception.callStackSymbols：获取崩溃时的调用堆栈信息。

步骤 3: 运行应用并引发崩溃

为了测试我们捕捉崩溃日志的机制可以故意引发崩溃，例如在某个按钮的操作中添加以下代码：

@IBAction func crashButtonTapped(_ sender: UIButton) {
    fatalError("This is a crash test!")
}

代码解释:

fatalError("...") 是一种故意的崩溃方式，用于测试我们的崩溃捕捉逻辑。

步骤 4: 查看崩溃日志

在运行后，点击 вызывает崩溃的按钮。
在 Xcode 的控制台中，你会看到捕捉的崩溃信息输出。
如果你希望将崩溃日志保存到文件，代码可以这样改动：

func setupCrashHandler() {
    NSSetUncaughtExceptionHandler { exception in
        let crashMessage = """
        Exception Name: \(exception.name)
        Exception Reason: \(exception.reason ?? "No reason") 
        Call Stack: \(exception.callStackSymbols)
        """
        
        // 将崩溃日志写入文件
        let filePath = NSHomeDirectory() + "/Documents/crash_log.txt"
        do {
            try crashMessage.write(toFile: filePath, atomically: true, encoding: .utf8)
        } catch {
            print("Failed to write crash log to file: \(error)")
        }
    }
}

代码解释:

使用 NSHomeDirectory() 获取应用的文档目录。
使用 write(toFile:atomically:encoding:) 将崩溃信息写入文件。

序列图

sequenceDiagram
    participant Dev as Developer
    participant Xcode as Xcode
    participant Device as iOS Device
    Dev->>Xcode: 选择设备并运行应用
    Xcode->>Device: 运行应用
    Dev->>Device: 点击崩溃按钮
    Device-->>Xcode: 触发崩溃
    Xcode->>Dev: 显示崩溃信息

旅行图

journey
    title 追踪崩溃日志的过程
    section 1. 开启调试模式
      连接设备  : 5: Dev
      启动 Xcode : 5: Dev
    section 2. 添加日志捕捉
      添加崩溃捕捉代码 : 4: Dev
      设置异常处理 : 4: Dev
    section 3. 触发崩溃
      点击测试崩溃按钮 : 5: Dev
    section 4. 查看崩溃日志
      查看控制台输出 : 5: Dev
      写入崩溃日志文件 : 4: Dev