Google Breakpad 捕获程序崩溃报告代码简解

一、简述

在上一篇 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的源码。相关资料已经上传，小伙伴们可以通过下方链接下载查看。

---

相关文件下载

google_breakpad 源码

Google Breakpad 使用实例

GoogleBreakpad捕获崩溃文件需要的文件，包括lib库文件及头文件