SYM - macOS 崩溃日志符号化工具

SYM 是一款专为 macOS 平台设计的图形化 iOS/macOS 应用崩溃日志符号化工具。它旨在简化开发者和测试人员在分析崩溃报告时的繁琐流程，将难懂的十六进制内存地址转换为可读的函数名和代码行号。

主要功能特点

1. 多格式崩溃日志支持

• 标准 Apple 崩溃报告: 完整支持 iOS、macOS、tvOS 等系统生成的 .crash 文件。
• CPU 使用率日志: 可分析包含 CPU 使用详情的性能日志。
• 第三方服务集成:
  • Fabric/Crashlytics: 支持解析来自 Firebase Crashlytics 的崩溃报告。
  • 友盟 (Umeng): 支持解析国内常用的友盟统计的崩溃日志格式。

2. 智能 dSYM 文件管理

• 自动查找与匹配: 应用会自动扫描系统中的 ~/Library/Developer/Xcode/ 目录、Spotlight 索引以及常见位置，智能查找与崩溃日志构建 UUID 匹配的 dSYM 文件。
• 自定义下载脚本: 如果 dSYM 文件未存储在本地，用户可以编写自定义脚本（如从公司内部服务器或 CI 系统下载），SYM 可以调用该脚本自动获取所需的符号文件。

3. 便捷的数据导入与管理

• 从设备导入: 可以直接通过 USB 连接 iPhone、iPad 等设备，从设备中导入 .crash 日志文件，无需手动导出。
• 沙盒文件浏览器: 内置简单的沙盒文件浏览器，方便开发者查看和管理应用沙盒内的文件（主要用于 macOS 应用）。

4. 简洁高效的用户体验

• 拖拽与粘贴操作: 只需将崩溃日志文件拖拽到 SYM 窗口，或直接将日志文本内容粘贴进去即可。
• 一键符号化: 点击界面左上角的 Symbolicate 按钮，即可自动完成整个符号化过程，结果清晰展示。

核心优势

• 图形化操作，降低门槛: 避免了在命令行中使用 atos、symbolicatecrash 等工具所需的复杂命令和参数记忆，为非命令行爱好者或新手开发者提供了极大的便利。
• 开源免费，安全透明: SYM 在 GitHub 上采用 MIT 协议开源，用户可以免费使用、审查代码，甚至参与改进，无需担心付费或隐私问题。
• 自动化程度高: 从查找 dSYM 到完成符号化，大部分流程实现了自动化，显著提升了崩溃分析的效率。
• 专注 macOS 原生体验: 作为一个纯粹的 Mac App，其界面和交互遵循 macOS 设计规范，运行流畅，与系统集成良好。

使用方法

1. 方式一 (推荐): 在 Finder 中找到崩溃日志文件（.crash 或 .txt），右键选择 “打开方式” -> “SYM”。
2. 方式二: 打开 SYM 应用，将崩溃日志文件拖入窗口，或直接复制日志文本内容并粘贴到主编辑区域。
3. 点击应用窗口标题栏左侧的 “Symbolicate” 按钮。
4. 等待处理完成，符号化后的可读堆栈信息将直接显示在窗口中。

获取方式

• 源码编译: 开发者也可通过 GitHub 仓库克隆源码，使用 Xcode 自行编译。

系统要求: 需要运行 macOS 操作系统。建议保持 dSYM 文件（应用每次编译生成）的妥善存档，这是进行符号化的关键。