如何自动保存DSYM文件

原文地址:http://www.cimgf.com/2009/12/23/automatically-save-the-dsym-files/
如原作者发现有侵权行为可责令我在24小时之内删除,前提是你能看到。


曾几何时起,用OC编写的应用程序,不管是Mac应用程序还是iOS程序,你在编译的时候弹出来的调试信息都是一堆汇编或者二进制信息。因此在应用程序crash的时候,不像其他语言比如Java,OC很难让我们定位到程序奔溃的原因。然而,殊不知OC程序在编译的时候会生成一个dSYM文件,该文件可以让这些调试信息和我们的奔溃日志相匹配,这样就可以帮助我们更好的定位到crash的位置。

需要注意的是,dSYM文件必须直接和二进制匹配(因为每个Mach-o对象中都内嵌了一个uuid,这个uuid必须和dsym文件中的uuid一一对应,所以重新打包后之前的uuid就不能用了),因此在每次项目打完测试包或者发布包之后都要手动把dSYM文件保存下来,这对于开发者来说很痛苦。

为了解决每次手动保存的问题,我写了一段脚本,每次我构建包之后都会运行这段脚本。这段脚本会把dSYM文件移动到项目中一个同名(dSYM)的目录下。这段脚本还会去检查代码是否提交到git仓库中,并将这个文件也提交到git中,为了解决重名问题,脚本会把文件名更改为当前的日期加时间。

失败检查

脚本做的第一件事是确保它能够被正常的运行。

if [ "$BUILD_STYLE" == "Debug" ]; then
  echo "Skipping debug"
  exit 0;
fi

第一行表示检查项目的编译模式是否为debug,因为debug模式下打出来的包大多数时候试运行在开发者的设备上,其中包含了很多调试信息,而这些信息都是可以忽略的。

if [ "$EFFECTIVE_PLATFORM_NAME" == "-iphonesimulator" ]; then
  echo "Skipping simulator build"
  exit 0;
fi

第二步检查运行的设备是否为模拟器,如果是的话则不会保存dSYM文件。

移动文件

因为成千上万开发者的项目文件路径是不同的,所以我使用了系统提供的环境变量来定位编译后生成的dSYM文件位置。

SRC_PATH=${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
RELATIVE_DEST_PATH=dSYM/${EXECUTABLE_NAME}.$(date +%Y%m%d%H%M%S).app.dSYM
DEST_PATH=${PROJECT_DIR}/${RELATIVE_DEST_PATH}
echo "moving ${SRC_PATH} to ${DEST_PATH}"
 
mv "${SRC_PATH}" "${DEST_PATH}"

下一步就是建立文件夹并移动文件了。我喜欢将文件路径保存在变量里,这样就可以通过控制台将它们打印出来看是路径否出错。

提交到版本控制中

现在应该没有项目是不进行版本控制的吧。

if [ -f ".git/config" ]; then
  git add "${RELATIVE_DEST_PATH}"
  git commit -m "Added dSYM file for ${BUILD_STYLE} build" \
      "${RELATIVE_DEST_PATH}"
fi

最后一部分只有项目在远程仓库中的时候才会执行,脚本会帮你将新建的文件夹提交到git仓库中,并配上一条简单的提交信息。

结论

最近我使用xcode自带的symbolicatecrash工具时遇到了一点问题,但最终我们会解决它的,这些dSYM文件是追踪crash的好东西。
附件中提供了一个文件,我通常会将这个文件加入到项目中,有一段脚本专门去运行文件中的脚本。
Move_dSYM_To_Storage.sh.zip

更新

Reader Rob Elkin给我了一点提示,下面是更新后的脚本,也是我使用的最新版本:

echo "starting dsym archiving"
 
if [ "$BUILD_STYLE" == "Debug" ]; then
echo "Skipping debug"
exit 0;
fi
 
if [ "$EFFECTIVE_PLATFORM_NAME" == "-iphonesimulator" ]; then
echo "Skipping simulator build"
exit 0;
fi
 
SRC_PATH=${ARCHIVE_DSYMS_PATH}/${DWARF_DSYM_FILE_NAME}
RELATIVE_DEST_PATH=dSYM/${EXECUTABLE_NAME}.$(date +%Y%m%d%H%M%S).app.dSYM
DEST_PATH=${PROJECT_DIR}/${RELATIVE_DEST_PATH}
echo "moving ${SRC_PATH} to ${DEST_PATH}"
 
cp -r "${SRC_PATH}" "${DEST_PATH}"
 
if [ -f ".git/config" ]; then
git add "${RELATIVE_DEST_PATH}"
git commit -m "Added dSYM file for ${BUILD_STYLE} build" "${RELATIVE_DEST_PATH}"
fi
 
主要改动的地方在这里:
 
SRC_PATH=${ARCHIVE_DSYMS_PATH}/${DWARF_DSYM_FILE_NAME}

以为现在构建包之后的存储路径改变了(specifically ~/Library/Developer/Xcode/Archives//)
我还将mv指令改变成了cp -r,我更喜欢将原文件复制一份到新的文件夹中,这样对原文件就不会有任何影响。
希望这能帮助到你,也要感谢Rob愿意分享你的想法。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 201,681评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,710评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,623评论 0 334
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,202评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,232评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,368评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,795评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,461评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,647评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,476评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,525评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,226评论 3 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,785评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,857评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,090评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,647评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,215评论 2 341

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,571评论 18 139
  • 什么是符号表? 符号表是内存地址与函数名、文件名、行号的映射表。符号表元素如下所示: <起始地址> <结束地址> ...
    深圳阳光阅读 12,159评论 28 5
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,330评论 25 707
  • 你可曾看过: 云追月 影逐日 风撼树 蝶恋花 鱼游水 鸟衔枝
    弄花鱼沉阅读 122评论 0 0
  • 晚上放学路上还好端端的,回到家闺女突然说肚子疼,我忙着在厨房做饭,也没有空搭理她,心想不会是她无病呻吟吧? 正好她...
    邱Q糖阅读 510评论 0 1