调试信息文件
了解调试信息文件如何使 Sentry 能够提取堆栈跟踪并为大多数编译平台的崩溃报告提供更多详细信息。
调试信息文件使 Sentry 能够提取堆栈跟踪,并为大多数编译平台的崩溃报告提供更多详细信息。存储在调试文件中的信息包括原始函数名称、源文件路径和行号、源代码上下文或内存中变量的位置。Sentry 可以使用其中的一些信息并在问题详情页面上显示。
每个主要平台使用的调试信息文件格式不同。我们目前支持以下格式:
- dSYM 文件 适用于 iOS、iPadOS、tvOS、watchOS、macOS 和 visionOS
- ELF symbols 适用于 Linux 和 Android(NDK)
- PDB 文件 适用于 Windows 和 .NET
- Breakpad symbols 适用于所有平台
- WASM 文件 适用于 WebAssembly
- ProGuard 映射 适用于 Java 和 Android
虽然源映射也是调试信息文件,但在 Sentry 中处理方式不同。更多详情请参阅 sentry-cli 中的源映射。
为了提供完全符号化的崩溃报告,Sentry 需要访问应用程序及其系统库的调试信息文件。你可以通过 上传 文件到 Sentry 或将文件放在兼容的 Symbol Server 上,以便在需要时由 Sentry 下载。
上传后,调试信息文件可以在关联项目的设置页面中的 Debug Files 部分查看和管理。该页面列出了所有已上传的调试文件,并允许你配置符号服务器以实现自动下载。
从 项目详情 页面,点击进入设置,然后在页面导航中点击 Debug Files。
ProGuard 文件会单独列出,在项目设置页面的 ProGuard 部分。
调试文件的保留期为 90天,采用 空闲时间 到期机制。这意味着上传的调试文件会在其被用于事件处理期间一直保留。一旦调试文件在至少 90 天内未用于处理传入事件,它将自动过期并符合删除条件。