一、简述
在上一篇 Qt 使用 Google Breakpad 捕获程序崩溃报告(dump文件) 中,我们用实例来演示了如何使用Google Breakpad 来捕获程序崩溃报告,主要引用三个lib文件以及一些头文件。实际写的代码很简单,下面简单介绍一下捕捉程序异常对象。
二、代码简解
#include "breakpadtest.h"
#include <QtWidgets/QApplication>
#include "client/windows/handler/exception_handler.h"
#include <QDebug>
// 程序崩溃回调函数;
bool callback(const wchar_t *dump_path, const wchar_t *id,
void *context, EXCEPTION_POINTERS *exinfo,
MDRawAssertionInfo *assertion,
bool succeeded)
{
if (succeeded)
{
qDebug() << "Create dump file success";
}
else
{
qDebug() << "Create dump file failed";
}
return succeeded;
}
int main(int argc, char *argv[])
{
// 创建捕捉程序异常对象;
google_breakpad::ExceptionHandler eh(
L".", NULL, callback, NULL,
google_breakpad::ExceptionHandler::HANDLER_ALL);
QApplication a(argc, argv);
BreakPadTest w;
w.show();
return a.exec();
}
我们使用google_breakpad::ExceptionHandler 创建了一个捕捉异常的对象,我们先看一下构造方法。在exception_handler.h 文件中。
const wstring& dump_path : 第一个参数指定了dmp文件生成的路径,在给定值时请确保路径存在,如果不存在,不会生成dmp文件。
FilterCallback filter : 程序崩溃后的回调函数,在生成dmp文件之前调用,并且FilterCallback 的返回值决定了Breakpad是否会生成dmp文件,返回true则继续处理异常,并写入dump文件,返回false,则停止处理,并且不会写入dump文件。下面为FilterCallback 回调函数的参数形式以及介绍。
MinidumpCallback callback : 程序崩溃后的回调函数,在生成dmp文件之后调用。其返回值表示当前是否已处理异常。返回true,说明当前已经处理完异常,不会再让其他处理者再对此异常进行处理、返回false,说明异常未处理,并且允许其他处理者进行处理。下面为MinidumpCallback 回调函数的参数形式以及介绍。
void* callback_context : 设备上下文,作为回调函数的参数,在回调函数中使用。
int handler_types : 捕捉异常的类型,通过HandlerType 来区分 当前处理程序应该捕获何种类型的异常。
注释中讲到了 HANDLER_NONE 不会捕获任何异常,但是如果手动调用 WriteMinidump 处理程序仍然会被触发,而HANDLER_ALL会捕捉所以的异常。
其实我们看到 ExceptionHandler 类还有其他两个构造函数,如下图,而这两个构造函数与上面相比多了三个参数,而区别是上面那个是进程内生成dmp文件,而下面两个构造函数用于进程外生成dmp文件。
尾
关于代码我们就简单介绍到这里,想要深入了解的小伙伴可以尝试查看Google Breakpad的源码。