脚本处理iOS的Crash日志

背景

当我们打包app时，可以选择生成对应的符号表，其保存 16 进制函数地址映射信息，通过给定的函数起始地址和偏移量，可以对应函数具体信息以供分析。

所以我们拿到测试给的闪退日志(.crash)时，需要找到打包时对应生成的符号表(.dSYM)作为钥匙解析。具体分为下面几个步骤

dwarfdump --uuid 命令获取 .dSYM 的 uuid
打开 .crash 文件，在特定位置找到 uuid
根据 arm 版本比对两者是否一致
到 Xcode 目录下寻找 symbolicatecrash 工具

不同版本文件路径不同，具体版本请谷歌。Xcode9路径是/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/
设置终端环境变量

export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
使用 symbolicatecrash 工具解析日志

symbolicatecrash .crash .dsym > a.out

虽然过程不复杂，但是每次都需要手动执行一次检查与命令，过于繁琐，所以决定用脚本化提高效率。

步骤实现

输入Crash日志

#要求输入crash文件路径

inputFile 'Please Input Crash File' 'crash'

crashPath=$filePath

由于需要输入两种不同后缀的文件路径，且都需要检查，因此统一定义一个方法。

#定义全局变量

filePath=

#输入文件路径

inputFile() {

    readSuccess=false

    #首先清空变量值

    filePath=

    while [ $readSuccess = false ]; do

        echo $1

        #读取到变量中

        read -a filePath

        if [[ ! -e $filePath || ${filePath##*.} != $2 ]]; then

            echo "Input file is not ."$2

        else

            readSuccess=true

        fi

    done

}

.dSYM 是文件夹路径，所以这里简单的判断了路径是否存在，如果不存在就继续让用户输入。

Shell命令中判断分为[]与[[]]，后者比前者更通用，可以使用 || 正则运算等。

判断中，-f表示检查是否存在该文件，-d表示检查是否存在文件夹，-e表示检查是否存在该路径

输入dSYM符号表

dsymSuccess=false

while [ $dsymSuccess = false ]; do

    #要求输入dSYM文件路径

    inputFile 'Please Input dSYM File' 'dSYM'

    dsymPath=$filePath

    #检查是否匹配

    checkUUID "$crashPath" "$dsymPath"

    match=$?

    if [ $match -eq 0 ]; then

        echo 'UUID not match!'

    else

        dsymSuccess=true

    fi

done

循环获取匹配 UUID 的 dSYM ，这里使用了另一种方法获取方法返回值，具体之后章节会总结。

查找symbolicatecrash工具

在 Xcode 文件夹指定路径下查找工具，加快效率，如果没找到就停止运行。

# 查找symbolicatecrash解析工具，内置在Xcode的库文件中

toolPath=`find /Applications/Xcode.app/Contents/SharedFrameworks -name symbolicatecrash | head -n 1`

if [ ! -f $toolPath ]; then

    echo "Symbolicatecrash not exist!"

    exit 0

fi

执行解析命令

#先设置环境变量

export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"

#指定解析结果路径

crashName=`basename $crashPath`

afterPath="$(dirname "$crashPath")"/"${crashName%%.*}""_after.crash"

#开始解析

$toolPath "$crashPath" "$dsymPath" > "$afterPath" 2> /dev/null

这里我将错误信息导流到 /dev/null，保证解析文件没有杂乱信息。

遇到的问题

怎么获取函数返回值？

之前没有处理过需要返回数值的方法，所以一开始有点懵，查询资料后最终采用了两种方式实现了效果，现在做一些总结。

全局变量记录

#定义全局变量

filePath=

inputFile() {

    #读取到变量中

    read -a filePath

}

inputFile

crashPath=$filePath

通过 inputFile 方法来了解一下，首先定义一个全局变量为 filePath，在方法中重新赋值，方法结束后读取全局变量中的数据。

这种方法的好处是可以自定义返回参数类型和个数，缺点是容易和其他变量搞混。

Return返回值

类似与C语言中的用法，脚本也支持 retrun 0 返回结果并停止运行。

checkUUID() {

    grep "$arm64id" "$1"

    if [ $? -ne 0 ]; then

        return 1;

    fi

    return 0;

}

checkUUID "$crashPath" "$dsymPath"

match=$?

获取结果的方式为 $?，其能够返回环境中最后一个指令结果，也就是之前执行的checkUUID的结果。

优点是简洁明了，符合编码习惯，缺点是返回值只能是 0-255 的数字，不能返回其他类型的数据。

获取打印值

还有一种方法其实平时一直在使用，只不过并不了解其运行方式。

crashName=`basename $crashPath`

print() {

    echo "Hello World"

}

text=$(print)

运行系统预设的方法或者自定义方法，将执行命令用 $() 的方式使用，就可以获取该命令中所有打印的信息，赋值到变量就可以拿到需要的返回值。

优点是功能全效率高，使用字符串的方式可以传递定制化信息，缺点是不可预期返回结果，需要通过字符串查找等命令辅助。

循环输入合法路径

在我的设想中，需要用户输入匹配的 dSYM 文件路径，如果不匹配，则重新输入，直到合法。为了支持嵌套，需要定义局部变量控制循环，具体代码如下

dsymSuccess=false

while [ $dsymSuccess = false ]; do

    #要求输入dSYM文件路径

    inputFile 'Please Input dSYM File' 'dSYM'

    dsymPath=$filePath

    #检查是否匹配

    checkUUID "$crashPath" "$dsymPath"

    match=$?

    if [ $match -eq 0 ]; then

        echo 'UUID not match!'

    else

        dsymSuccess=true

    fi

done

处理字符串

获取到 UUID 所有输出信息后，需要截取出对应平台的信息，处理还是不太熟悉，特地整理如下

#原始信息

UUID: 92E495AA-C2D4-3E9F-A759-A50AAEF446CD (armv7) /Volumes/.dSYM/Contents/Resources/DWARF/app

UUID: 536527A8-0243-34DB-AE08-F1F64ACA4351 (arm64) /Volumes/.dSYM/Contents/Resources/DWARF/app

#去除中间间隔-

uuid=${uuid//-/}

#从后往前找第一个匹配 \(arm64的，并且都删除

arm64id=${uuid% \(arm64*}

#处理后

UUID: 92E495AAC2D43E9FA759A50AAEF446CD (armv7) /Volumes/.dSYM/Contents/Resources/DWARF/app

UUID: 536527A8024334DBAE08F1F64ACA4351

#从前往后找最后一个UUID: ，并删除

arm64id=${arm64id##*UUID: }

#处理后

536527A8024334DBAE08F1F64ACA4351

总结

看似简单的脚本，也花了一天时间编写，总体还是不太熟练，仍需努力联系。

这次特地尝试了与上次不同的参数输入方法，使用提示输入的方式，果然遇到了新的问题。好在都查资料解决了，结果还算满意。

脚本我提交到了Github，欢迎大家指教共同进步！给个关注最好啦～