下载脚本

简介

SYM 支持自定义的下载脚本，当 dSYM 文件不在本地磁盘时，可以选择用脚本从服务器上下载。

环境变量

崩溃日志的信息通过参数以及环境变量传递给下载脚本，目前支持的信息如下：

名称	描述	示例
$1	崩溃日志文件路径
$2	下载目录	~/Downloads
${APP_NAME}	App 二进制文件名	im_zorro_sym
${UUID}	Crash UUID	E5B0A378-6816-3D90-86FD-2AEF15894A85
${BUNDLE_ID}	Bundle ID	im.zorro.sym
${APP_VERSION}	App 版本号	212 (1.0.1)

错误处理

下载脚本可以通过不同的返回值来通知 SYM 失败原因，定义如下：

返回值	描述
0	下载成功
1	找不到 dSYM 文件
2	下载失败

一个简单的下载示例

#!/bin/bash

curl -o $2/${UUID}.zip http://your.server.domain/path/to/${UUID}.zip
unzip -o "$2/${UUID}.zip" -d "$2/${UUID}"
for f in "$2/${UUID}/*.dSYM"; do dwarfdump --uuid $f ; done

一些 Tips

• 如果下载脚本要分享给别人使用，建议用 macOS 自带的命令行工具。
• 推荐用 curl 来下载，SYM 可以解析它的输出，并在 UI 上展示下载进度。
• 在脚本的最后，推荐执行一次 dwarfdump --uuid xxx.dSYM 命令，SYM 可以识别它的输出，加速 dSYM 文件的索引速度。