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

  • Post author:
  • Post category:其他


一、简述

在上一篇

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库文件及头文件



版权声明:本文为GoForwardToStep原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。