crash-reports - 如何将 google crashpad 与我的应用程序集成？

Question

breakpad 项目将替换为 google crashpad项目。如何将新的崩溃报告器与我在 Mac 上的应用程序集成？

Answer 1

首先您需要设置 depot_tools为了构建 Crashpad。

接下来，您必须获取 Crashpad source 的副本.

使用 gn 和 ninja 构建 Crashpad，其中 gn 生成构建配置，ninja 执行实际操作 build 。提供有关如何构建 Crashpad 的完整说明 here .

对于 MacOS，您需要链接到 libclient.a、libutil.a、libbase.a 和所有 >.o 文件在 out/Default/obj/out/Default/gen/util/mach 如果你想生成小型转储并将它们上传到远程服务器。此外，您需要将 crashpad_handler 与您的应用程序一起打包，并确保它在运行时可用。

通过 configuring 将 Crashpad 与您的应用程序集成Crashpad 处理程序并将其指向能够接收 Crashpad 崩溃报告的服务器。

#include "client/crashpad_client.h"
#include "client/crash_report_database.h"
#include "client/settings.h"

#if defined(OS_POSIX)
typedef std::string StringType;
#elif defined(OS_WIN)
typedef std::wstring StringType;
#endif

using namespace base;
using namespace crashpad;
using namespace std;

bool initializeCrashpad(void);
StringType getExecutableDir(void);

bool initializeCrashpad() {
  // Get directory where the exe lives so we can pass a full path to handler, reportsDir and metricsDir
  StringType exeDir = getExecutableDir();

  // Ensure that handler is shipped with your application
  FilePath handler(exeDir + "/path/to/crashpad_handler");

  // Directory where reports will be saved. Important! Must be writable or crashpad_handler will crash.
  FilePath reportsDir(exeDir + "/path/to/crashpad");

  // Directory where metrics will be saved. Important! Must be writable or crashpad_handler will crash.
  FilePath metricsDir(exeDir + "/path/to/crashpad");

  // Configure url with BugSplat’s public fred database. Replace 'fred' with the name of your BugSplat database.
  StringType url = "https://fred.bugsplat.com/post/bp/crash/crashpad.php";

  // Metadata that will be posted to the server with the crash report map
  map<StringType, StringType> annotations;
  annotations["format"] = "minidump";          // Required: Crashpad setting to save crash as a minidump
  annotations["product"] = "myCrashpadCrasher" // Required: BugSplat appName
  annotations["version"] = "1.0.0";            // Required: BugSplat appVersion
  annotations["key"] = "Sample key";           // Optional: BugSplat key field
  annotations["user"] = "fred@bugsplat.com";   // Optional: BugSplat user email
  annotations["list_annotations"] = "Sample comment"; // Optional: BugSplat crash description

  // Disable crashpad rate limiting so that all crashes have dmp files
  vector<StringType> arguments; 
  arguments.push_back("--no-rate-limit");

  // Initialize Crashpad database
  unique_ptr<CrashReportDatabase> database = CrashReportDatabase::Initialize(reportsDir);
  if (database == NULL) return false;

  // Enable automated crash uploads
  Settings *settings = database->GetSettings();
  if (settings == NULL) return false;
  settings->SetUploadsEnabled(true);

  // Start crash handler
  CrashpadClient *client = new CrashpadClient();
  bool status = client->StartHandler(handler, reportsDir, metricsDir, url, annotations, arguments, true, true);
  return status;
}

您还需要使用 dump_syms 生成 sym 文件.您可以使用 symupload 将 sym 文件上传到远程服务器。 .最后，您可以使用 minidump_stackwalk 符号化小型转储。 .