Sentry命令行工具之dSYM上传

sentry-cli可以将dSYM文件上传到Sentry，以允许iOS应用程序崩溃的符号。如果您使用fastlane或构建系统集成等系统，它也会在幕后使用。

1、基本上传

使用upload-dif上传dSYM文件并指定dsym类型。如果在Xcode构建步骤中调用，sentry-cli将自动获取环境变量DWARF_DSYM_FOLDER_PATH。否则，提供包含dSYMs作为命令行参数的dSYM或文件夹的路径。

注意
由于调试文件属于项目，因此您需要指定正在使用的组织和项目。有关此内容的更多信息，请参阅使用项目。

由于dSYM具有唯一的签名，因此您无需将它们与版本相关联。但是，CLI将自动扫描提供的路径中的Info.plist以查找发行版。如果找到发布，则dSYMS会自动关联。即使没有这种关联，上传的dSYM也将用于符号化。

例：

$ sentry-cli upload-dif -t dsym .

二、上传选项

--no-bin

从上载中排除可执行文件和库，仅搜索dSYM文件。对于iOS应用程序，可以安全地激活此设置，因为Sentry不会要求它们进行符号化。

--derived-data

在派生数据文件夹中搜索dSYM。这是Xcode存储其构建输出的默认位置.

-- no-zips

默认情况下，sentry-cli将打开并搜索ZIP存档以获取dSYM。从iTunes Connect下载构建时，这尤其有用。如果搜索路径包含没有dSYM的大型ZIP存档以加快搜索速度，请使用此开关禁用。

--force-foreground

此选项强制dSYM上载在前台进行。这仅影响从Xcode构建步骤调用的上载。默认情况下，从Xcode启动并在后台完成上传过程将分离。如果您需要调试上载过程，强制上传在前台运行可能会很有用。

--info-plist

覆盖Info.plist的搜索路径，如果它位于非标准位置，则使用user。

--no-reprocessing

此参数可防止Sentry立即触发重新处理。在极少数情况下，如果您希望以多个批次上载文件，并且希望确保Sentry在上载某些可选的dsyms之前不开始重新处理，则它非常有用。请注意，虽然有人仍然可以在此期间触发从UI重新处理。

--symbol-maps

使用BCSymbolMaps在iTunes Connect构建中解析隐藏的符号。如果在AppStore中发布应用程序时未将符号上传到Apple，则需要使用此符号来表示崩溃。 

三、符号映射

如果要隐藏Apple的调试符号，则调试文件将不包含许多有用的符号。在这种情况下，sentry-cli上传将警告您它需要BCSymbolMaps：

 sentry-cli upload-dif ...
> Found 34 debug information files
> Warning: Found 10 symbol files with hidden symbols (need BCSymbolMaps)

在这种情况下，您需要与您的文件匹配的BCSymbolMaps。通常，这些是由Xcode构建过程生成的。提供--symbol-maps参数并将其指向包含符号映射的文件夹：

$ sentry-cli upload-dif --symbol-maps path/to/symbolmaps path/to/debug/symbols