Sentry命令行工具调试信息文件

sentry-cli可用于验证和上传调试信息文件（dSYM，Proguard文件等）。

调试信息文件是其他文件，可帮助我们提供有关崩溃报告的更多信息。我们目前支持以下格式：

• 适用于iOS，tvOS和macOS的dSYM文件
• 适用于Linux和Android的ELF符号
• 适用于Windows的PDB文件
• Breakpad或Crashpad的Breakpad符号
• 适用于Android的Proguard映射

请注意，源映射虽然也是调试信息文件，但在Sentry中的处理方式也不同。有关更多信息，请参阅sentry-cli中的Sourcemaps。

一、文件关联

通常，Sentry通过其唯一ID将调试信息文件与事件相关联。每个调试信息文件至少有一个唯一ID。作为特殊情况，dSYM文件可以包含多个ID的符号。如果您有调试信息文件，则可以使用sentry-cli difutil check命令打印包含的ID。 ID取决于文件类型：dSYMs和proguard文件使用UUID，Linux符号使用更长的哈希值（例如SHA256），PDB使用UUID和年龄字段。

同样，上传命令（例如，sentry-cli upload-dif）允许通过提供其已知标识符来搜索特定调试信息文件。

二、检查文件

Sentry并非所有调试信息文件都可以使用。要查看它们是否可用，您可以使用sentry-cli difutil check命令：

sentry-cli difutil check /path/to/debug/information/file

这将报告调试信息文件的UUID以及它是否通过Sentry的基本要求。

三、查找文件

如果您在Sentry的UI中看到调试信息文件丢失但您不确定如何找到它们，则可以使用sentry-cli difutil find命令查找它们：

 sentry-cli difutil find <identifier>

此外，sentry-cli upload-dif可以自动搜索文件夹或ZIP存档中的文件。

四、上传文件

调试文件上载的选项取决于上载环境和调试格式。有关详细说明，请参阅其他文章。