Google Breakpad Android 使用详解
1.概述
最近在学习极客时间Android开发高手课老师推荐了Breakpad开源库来采集native 的crash日志,自己参照老师的讲解和Demo做了个封装库Android_Breakpad,方便以后使用。该库主要是在发生native crash的时候生成文件保存到sd卡,而后分析文件,定位问题。
在我们开发过程中Android JNI层Crash问题是个比较头疼的问题。
相对Java层来说,因为c/c++造成的crash没有输出好像Java的Exception Strace,所以定位问题是个比较艰难的事情。
Google Breakpad是一套完整的工具集,从crash的捕获到crash的dump,都提供了相对应的工具。
Breakpad是一个库和工具套件可以让你发布的应用程序(把编译器提供的调试信息剥离掉的)给客户,记录了崩溃紧凑的“dump”文件,发送回您的服务器,并从这些minidump产生C和C++堆栈踪迹。Breakpad可以根据请求使没有崩溃的程序也可以写出minidump
Breakpad有三个主要组件:
图片来源网络,侵删
- 用户端:是一个库,包含在您的应用程序中。 它可以获取当前线程的状态和当前加载的可执行文件和共享库的ID写转储文件。您可以配置用户端发生了崩溃时写入一个minidump时,或者明确要求时。
- 符号卸载器:是一个程序,读取由编译器产生的调试信息,并生成一个使用Breakpad格式的符号文件 。
- 解决器(minidump processor):是一个程序,读取一个minidump文件,找到相应的版本的符号文件的(可执行文件和共享库的转储提到的),并产生了一个人可读的C / C + +堆栈跟踪。
Breakpad是一个跨平台的开源库,我们也可以在其 Breakpad Github上下载自己编译。接下来就是讲解如何自己下载编译,引用到项目中,方便以后的项目中使用。
2. 源码下载和编译
如上文所说,我们从github上的地址自行下载下来源码。具体编译过程可以参照其README文件。整个过程是在mac下进行,其余平台可能略微时间,但也是可以的。在这个仓库中有一个关于android平台如何引用的说明可以参照
Android_README
其中主要是要注意“Android.mk”文件依赖关系。我采用的是“CMakeLists.txt”和“Android.mk”大同小异,只是语法问题,具体可以参照NDK。
整个编译过程相对来说算复杂的,由于中间涉及到很多知识点需要去掌握和查看,特别是对jni开发掌握不够的程序员,不过也可以趁机理解学习一下jni相关知识。
3.项目结构
整个项目如下图所示:
breakpad.png
可以看出是一个普通项目和library。我们先看libary:其gradle文件如下
apply plugin: 'com.android.library'android { compileSdkVersion 28 defaultConfig { minSdkVersion 14 targetSdkVersion 28 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" ndk { abiFilters "armeabi-v7a", "arm64-v8a", "x86" } } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } externalNativeBuild { cmake { path "src/main/cpp/CMakeLists.txt" } }}dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) implementation 'com.android.support:appcompat-v7:28.0.0' testImplementation 'junit:junit:4.12' androidTestImplementation 'com.android.support.test:runner:1.0.2' androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'}
可以从中看到src/main/cpp/CMakeLists.txt
指向编译配置文件,查看该文件
cmake_minimum_required(VERSION 3.4.1)project(breakpad-core)set(ENABLE_INPROCESS ON)set(ENABLE_OUTOFPROCESS ON)set(ENABLE_LIBCORKSCREW ON)set(ENABLE_LIBUNWIND ON)set(ENABLE_LIBUNWINDSTACK ON)set(ENABLE_CXXABI ON)set(ENABLE_STACKSCAN ON)if (${ENABLE_INPROCESS}) add_definitions(-DENABLE_INPROCESS)endif ()if (${ENABLE_OUTOFPROCESS}) add_definitions(-DENABLE_OUTOFPROCESS)endif ()set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Werror=implicit-function-declaration")set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 ")# breakpadinclude_directories(external/libbreakpad/src external/libbreakpad/src/common/android/include)add_subdirectory(external/libbreakpad)list(APPEND LINK_LIBRARIES breakpad)add_library(breakpad-core SHARED breakpad.cpp)target_link_libraries(breakpad-core ${LINK_LIBRARIES} log)
关于cmake相关的语法可以网上查得。对于只想使用该项目的来说指导这里就基本上可以理解到整个项目的流程了,其余的不做深入讲解。
4. 使用在项目中应用该libary或者者引用该libary打包出来的aar就可,进行初始化就行。如下:
apply plugin: 'com.android.application'android { compileSdkVersion 28 defaultConfig { applicationId "com.android.zone" minSdkVersion 21 targetSdkVersion 28 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" externalNativeBuild { cmake { cppFlags "-std=c++11" } } ndk { abiFilters "armeabi-v7a", "arm64-v8a", "x86" } } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } externalNativeBuild { cmake { path "CMakeLists.txt" } }}dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) implementation 'com.android.support:appcompat-v7:28.0.0' implementation 'com.android.support.constraint:constraint-layout:1.1.3' testImplementation 'junit:junit:4.12' androidTestImplementation 'com.android.support.test:runner:1.0.2' androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2' implementation project(":breakpad-build")}
在application中初始化就行
BreakpadInit.initBreakpad(externalReportPath.getAbsolutePath());
测试的代码具体可以查看github上的项目Android_Breakpad。
生成crash之后倒出对应的dump文件,采用上文 Breakpad Github编译出的工具来解析该文件。
也就是本文tools下的工具,不同平台需要自行编译。
./tools/mac/minidump_stackwalk crashDump/***.dmp >1.txt
得出日志结果过长,大体如下:
Operating system: Android 0.0.0 Linux 3.10.73-gd7193540482 #1 SMP PREEMPT Wed Dec 6 22:19:12 UTC 2017 aarch64CPU: arm64 8 CPUsGPU: UNKNOWNCrash reason: SIGSEGV /SEGV_MAPERRCrash address: 0x0Process uptime: not availableThread 0 (crashed) 0 libnative-lib.so + 0x6fe0 x0 = 0x0000007e4d8cb1c0 x1 = 0x0000007fd17ceb14 x2 = 0x0000007fd17ceba0 x3 = 0x0000007e4d43ea74 x4 = 0x0000007fd17ceda0 x5 = 0x0000007ecef7aa58 x6 = 0x0000007fd17ce990 x7 = 0x0000007e4dcbe34c x8 = 0x0000000000000001 x9 = 0x0000000000000000 x10 = 0x0000000000430000 x11 = 0x0000007e4d7d97a8 x12 = 0x0000007ed1f3f790 x13 = 0x697871c6dea5b553 x14 = 0x0000007ed2036000 ······
根据文章Android 平台 Native 代码的崩溃捕获机制及实现
的详情,我们可知“Crash reason: SIGSEGV /SEGV_MAPERR
”代表哪种类型的错误:
SIGSEGV 是当一个进程执行了一个无效的内存引用,或者发生段错误时发送给它的信号。Thread 0 (crashed) //crash 发生时候的线程0 libnative-lib.so + 0x6fe0 //发生 crash 的位置和寄存器信息
有了具体的寄存器信息,我们进行符号解析:
符号解析,可以使用 ndk 中提供的addr2line来根据地址进行一个符号反解的过程,该工具在$NDK_HOME/toolchains/arm-linux-androideabi-4.9/prebuilt/darwin-x86_64/bin/arm-linux-androideabi-addr2line
输出结果如下:
arm-linux-androideabi-addr2line -f -C -e sample/build/intermediates/transforms/mergeJniLibs/debug/0/lib/armeabi-v7a/libcrash-lib.so 0x77e //输出结果如下Crash()
得出该崩溃为Crash方法所致,接下来就需要去修改该方法是后话了。
以上是一次学习的总结,结合相关demo,自己动手封装出一个工作中可以用到的公共库。
纸上得来终觉浅,绝知此事要躬行。
参考内容:
·https://time.geekbang.org/column/article/70602
· AndroidAdvanceWithGeektime/Chapter01
· google/breakpad
· google/breakpad
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » Google Breakpad Android 使用详解