Breakpad
No description available
Install / Use
/learn @devzhan/BreakpadREADME
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.项目结构
整个项目如下图所示:
可以看出是一个普通项目和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 ")
# breakpad
include_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 aarch64
CPU: arm64
8 CPUs
GPU: UNKNOWN
Crash reason: SIGSEGV /SEGV_MAPERR
Crash address: 0x0
Process uptime: not available
Thread 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 ·https://github.com/AndroidAdvanceWithGeektime/Chapter01 ·https://github.com/google/breakpad
Related Skills
node-connect
344.1kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
96.8kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
344.1kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
344.1kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
