主題: 如何捕捉發(fā)布版本ipa的崩潰, 并定位崩潰代碼

一怜森、 崩潰日志

• 1 什么是崩潰日志
  iOS設(shè)備上的應(yīng)用閃退時(shí), 操作系統(tǒng)會(huì)聲稱一個(gè)崩潰日志, 保存在設(shè)備上强胰。

路徑是:  設(shè)置 -> 隱私 ->診斷與用量 ->診斷與用量數(shù)據(jù)蜕乡。在這里可以看到設(shè)備上所有的設(shè)備崩潰日志.
在“診斷與用量”界面，建議用戶選擇自動(dòng)發(fā)送，這樣可以每天自動(dòng)發(fā)送診斷和用量數(shù)據(jù)到itunes草娜，來(lái)幫助開(kāi)發(fā)者分析崩潰.

• 2如何獲取崩潰日志
  2.1 連接設(shè)備獲取崩潰日志
  設(shè)備與電腦上的ITunes Store同步后, 會(huì)將崩潰日志保存在電腦上,崩潰日志保存在以下位置:

Mac OS X:   ~/Library/Logs/CrashReporter/MobileDevice/
可以看到所有和該電腦同步過(guò)的設(shè)備的崩潰日志(.crash文件)

iOS設(shè)備上的崩潰日志

2.2 通過(guò)Xcode獲取崩潰日志
打開(kāi)Xcode, 菜單欄上選擇Window ->Devices，選中設(shè)備痒筒，點(diǎn)擊View Device Logs -> All logs可以看到所有的崩潰日志宰闰。
選中某一個(gè)崩潰日志，點(diǎn)擊Export Log可導(dǎo)出崩潰日志(.crash文件)

Xcode 查看崩潰日志

2.3 通過(guò)iTunes Connect獲取使用者上傳的崩潰日志
登錄iTunes Connect, 選中APP, 點(diǎn)擊可供銷售的APP(即當(dāng)前最新版本), 在最下面選中額外信息下的崩潰報(bào)告, 可以看到所有iOS版本下的崩潰報(bào)告簿透。

iTunes Connect 崩潰日志

二移袍、iOS 崩潰日志分析

首先來(lái)看一份崩潰日志

iOS崩潰日志

(1)Incident Identifier: 是崩潰報(bào)告的唯一標(biāo)識(shí)符。
(2)CrashReporter Key: 是與設(shè)備標(biāo)識(shí)相對(duì)應(yīng)的唯一鍵值老充。雖然它不是真正的設(shè)備標(biāo)識(shí)符咐容，但也是一個(gè)非常有用的情報(bào):如果你看到100個(gè)崩潰日志的CrashReporter Key值都是相同的，或者只有少數(shù)幾個(gè)不同的CrashReport值蚂维，說(shuō)明這不是一個(gè)普遍的問(wèn)題戳粒，只發(fā)生在一個(gè)或少數(shù)幾個(gè)設(shè)備上。
(3)Hardware Model: 標(biāo)識(shí)設(shè)備類型虫啥。 如果很多崩潰日志都是來(lái)自相同的設(shè)備類型蔚约，說(shuō)明應(yīng)用只在某特定類型的設(shè)備上有問(wèn)題。上面的日志里涂籽，崩潰日志產(chǎn)生的設(shè)備是iPhone 6(但是顯示的是iPhone7,2? 暫時(shí)不清楚原因)苹祟。
(4)Process 是應(yīng)用名稱。中括號(hào)里面的數(shù)字是閃退時(shí)應(yīng)用的進(jìn)程ID评雌。
(5)Version: App版本號(hào)
最重要的兩部分
(1)Exception Type:EXC_CRASH (SIGABRT)
(2)Last Exception Backtrace(即發(fā)生崩潰的原因树枫，也是我們要研究的重點(diǎn))

Xcode會(huì)自動(dòng)符號(hào)化代碼, 翻譯成明文, 如下:

Crash Logs

可以看到發(fā)生崩潰的代碼位于［SCHomePageVC viewDidLoad]方法中第408行。
崩潰的代碼是[NSArrayM insertObject:atIndex:]景东。
找到該行代碼,可以看到崩潰日志中所描述的崩潰發(fā)生的位置砂轻，代碼都和時(shí)機(jī)代碼一致。

崩潰的代碼

崩潰的原因是: The object to add to the array's content. This value must not be nil.

三斤吐、如何通過(guò).crash文件反編譯得到明文的crash文件

步驟如下:

• Step1: 在桌面上創(chuàng)建一個(gè)空的文件夾, 我將其命名為 DebugTest , 然后將三個(gè)文件放入該文件夾 "MyApp.app" , "MyApp.app.dSYM", "MyApp_2016_4_1.crash"搔涝。
• Step2 : 打開(kāi)Applications文件夾,找到 symbolicatecrash 文件, Xcode和Xcode以上，文件位置

//終端中輸入以下命令：
cd /Applications/Xcode.app/Contents/SharedFrameworks/DTDeviceKitBase.framework/Versions/A/Resources

然后你會(huì)發(fā)現(xiàn)symbolicatecrash文件和措，長(zhǎng)這個(gè)樣子庄呈，將其拷貝到DebugTest文件夾中

symbolicatecrash

到這一步，你的DebugTest目錄機(jī)構(gòu)應(yīng)該是這樣
(1MyAPP.app
(2)MyApp.app.dSYM
(3)MyApp_2016_4_1.crash
(4)symbolicatecrash

• Step3: 在終端中輸入以下3條命令

//第一條命令(其中Yourname 應(yīng)該是你的用戶名)
 cd /Users/Yourname/Desktop/DebugTest
// 第二條命令
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
//第三條命令(二選一)
(Xcode6.3和之前版本輸入以下命令)
./symbolicatecrash -A -v MYApp_2016-4-1.crash MyApp.app.dSYM
(Xcode6.4和之前版本輸入以下命令)
./symbolicatecrash  -v MYApp_2016-4-1.crash MyApp.app.dSYM

然后用控制臺(tái)打開(kāi)你的MyApp_2016_4_1.crash文件, 你就會(huì)看到編譯后的crash文件, 同Xcode看到的崩潰日志一致派阱。通過(guò)查看崩潰日志诬留，可以輕易的找到崩潰原因并修正。

Crash Logs

四、如何在程序崩潰時(shí)手動(dòng)捕捉到崩潰

   當(dāng)我們debug的時(shí)候, 發(fā)生崩潰后可以在控制臺(tái)上看到崩潰的堆棧信息和崩潰日志文兑。上面三種方法都是我們獲取.crash文件后解析的辦法, 那么如果用戶不發(fā)送崩潰日志到iTunes Connect時(shí)傀广，我們?nèi)绾潍@取崩潰信息呢？(盡可能的獲取崩潰信息有助于熱修復(fù)時(shí)定位代碼)彩届。當(dāng)然伪冰，友盟支持搜集崩潰日志，那我們是否也可以在程序崩潰時(shí)樟蠕，將崩潰信息寫(xiě)入本地贮聂，APP再次啟動(dòng)時(shí)，將崩潰信息上傳到我們的服務(wù)器寨辩。這里就要用到apple的一個(gè)函數(shù):NSSetUncaughtExceptionHandler吓懈。上代碼:

//application didFinishLaunchingWithOptions中調(diào)用 [self catchCrashLogs];
  
- (void)catchCrashLogs{
    NSSetUncaughtExceptionHandler(&UncaughtExceptionHandler);
}
void UncaughtExceptionHandler(NSException *exception){
    if (exception ==nil)return;
    NSArray *array = [exception callStackSymbols];
    NSString *reason = [exception reason];
    NSString *name  = [exception name];
    NSDictionary *dict = @{@"appException":@{@"exceptioncallStachSymbols":array,@"exceptionreason":reason,@"exceptionname":name}};
    if([SDFileToolClass writeCrashFileOnDocumentsException:dict]){
        NSLog(@"Crash logs write ok!");
    }
}
//寫(xiě)入緩存中: 以下提供三個(gè)API，分別是：寫(xiě)入靡狞，獲取耻警，清空
NSString * const SDCrashFileDirectory = @"SDMapHomeCrashFileDirectory"; //你的項(xiàng)目中自定義文件夾名
+ (NSString *)sd_getCachesPath{
    return [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];
}
+ (BOOL)writeCrashFileOnDocumentsException:(NSDictionary *)exception{
    NSString *time = [[NSDate date] formattedDateWithFormat:@"yyyyMMddHHmmss" locale:[NSLocale currentLocale]];
    NSDictionary *infoDictionary = [[NSBundle mainBundle] infoDictionary];
    NSString *crashname = [NSString stringWithFormat:@"%@_%@Crashlog.plist",time,infoDictionary[@"CFBundleName"]];
    NSString *crashPath = [[self sd_getCachesPath] stringByAppendingPathComponent:SDCrashFileDirectory];
    NSFileManager *manager = [NSFileManager defaultManager];
    //設(shè)備信息
    NSMutableDictionary *deviceInfos = [NSMutableDictionary dictionary];
    [deviceInfos setObject:[infoDictionary objectForKey:@"DTPlatformVersion"] forKey:@"DTPlatformVersion"];
    [deviceInfos setObject:[infoDictionary objectForKey:@"CFBundleShortVersionString"] forKey:@"CFBundleShortVersionString"];
    [deviceInfos setObject:[infoDictionary objectForKey:@"UIRequiredDeviceCapabilities"] forKey:@"UIRequiredDeviceCapabilities"];
    
    BOOL isSuccess = [manager createDirectoryAtPath:crashPath withIntermediateDirectories:YES attributes:nil error:nil];
    if (isSuccess) {
        NSLog(@"文件夾創(chuàng)建成功");
        NSString *filepath = [crashPath stringByAppendingPathComponent:crashname];
        NSMutableDictionary *logs = [NSMutableDictionary dictionaryWithContentsOfFile:filepath];
        if (!logs) {
            logs = [[NSMutableDictionary alloc] init];
        }
        //日志信息
        NSDictionary *infos = @{@"Exception":exception,@"DeviceInfo":deviceInfos};
        [logs setObject:infos forKey:[NSString stringWithFormat:@"%@_crashLogs",infoDictionary[@"CFBundleName"]]];
        BOOL writeOK = [logs writeToFile:filepath atomically:YES];
        NSLog(@"write result = %d,filePath = %@",writeOK,filepath);
        return writeOK;
    }else{
        return NO;
    }
}
+ (nullable NSArray *)sd_getCrashLogs{
     NSString *crashPath = [[self sd_getCachesPath] stringByAppendingPathComponent:SDCrashFileDirectory];
     NSFileManager *manager = [NSFileManager defaultManager];
     NSArray *array = [manager contentsOfDirectoryAtPath:crashPath error:nil];
     NSMutableArray *result = [NSMutableArray array];
    if (array.count == 0) return nil;
    for (NSString *name in array) {
        NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:[crashPath stringByAppendingPathComponent:name]];
        [result addObject:dict];
    }
    return result;
}
+ (BOOL)sd_clearCrashLogs{
     NSString *crashPath = [[self sd_getCachesPath] stringByAppendingPathComponent:SDCrashFileDirectory];
    NSFileManager *manager = [NSFileManager defaultManager];
    if (![manager fileExistsAtPath:crashPath]) return YES; //如果不存在,則默認(rèn)為刪除成功
    NSArray *contents = [manager contentsOfDirectoryAtPath:crashPath error:NULL];
    if (contents.count == 0) return YES;
    NSEnumerator *enums = [contents objectEnumerator];
    NSString *filename;
    BOOL success = YES;
    while (filename = [enums nextObject]) {
        if(![manager removeItemAtPath:[crashPath stringByAppendingPathComponent:filename] error:NULL]){
            success = NO;
            break;
        }
    }
    return success;
}

Well done!

五、結(jié)論: 為了更好的分析崩潰原因甸怕，在每次上架APP的時(shí)候甘穿，應(yīng)該保留對(duì)應(yīng)的app文件和dsym文件。

六梢杭、參考鏈接：

• Steps to excute crash logs
• iOS Crash Analyse