/qBreakpad

Cross-platform Qt crash handler, implemented as wrapper around google-breakpad

Primary LanguageC++GNU Lesser General Public License v3.0LGPL-3.0

#qBreakpad

Build status

qBreakpad is Qt library to use google-breakpad crash reporting facilities (and using it conviniently). Supports

  • Windows (but crash dump decoding will not work with MinGW compiler)
  • Linux
  • MacOS X

How to use

  • Clone repository recursively
$ git clone --recursive https://github.com/buzzySmile/qBreakpad.git
  • Build qBreakpad static library (qBreakpad/handler/)
  • Include "qBreakpad-handler.pri" to your target Qt project
include(libs/qBreakpad/qBreakpad-handler.pri)
  • Setup linking with "qBreakpad-handler" library
QMAKE_LIBDIR += $$OUT_PWD/submodules/breakpad/handler
LIBS += -lqBreakpad-handler
  • Use QBreakpadHandler singleton class to enable automatic crash dumps generation on any failure; example:
#include <QBreakpadHandler.h>

int main(int argc, char* argv[])
{
    ...
    QBreakpadInstance.setDumpPath(QLatin1String("crashes"));
    ...
}
  • Read Google Breakpad documentation to know further workflow

Getting started with Google Breakpad

https://chromium.googlesource.com/breakpad/breakpad/+/master/docs/getting_started_with_breakpad.md

Detail description about integration qBreakpad into your system and platform you could find in Wiki.