技术指南：使用 Breakpad 捕获 Native 崩溃，轻松掌握 Android 故障排查技巧

2023-09-27 12:16:42

在 Android 开发中，应用程序经常会遇到各种崩溃问题，这些问题可能源自于代码缺陷、第三方库问题、内存泄漏或其他原因。当应用程序崩溃时，通常会产生一个崩溃日志，帮助我们分析问题所在。然而，对于 Native 代码崩溃，由于其与 Java 代码运行在不同的进程中，传统的 Java 崩溃日志无法捕获到 Native 崩溃信息，这给故障排查带来了很大的挑战。

为了解决这个问题，我们可以使用 Breakpad 库来捕获 Native 崩溃。Breakpad 是一个开源的崩溃报告库，可以帮助我们捕获并生成崩溃报告，以便我们进行分析和修复。

Breakpad 简介

Breakpad 是一个开源的崩溃报告库，它最初由 Google 开发，用于捕获和报告崩溃。它支持多种平台，包括 Linux、macOS、Windows 和 Android。Breakpad 库使用了一种称为“堆栈回溯”的技术来捕获崩溃信息。当应用程序崩溃时，Breakpad 库会捕获应用程序的堆栈回溯信息，并将其存储在一个文件中。这个文件被称为崩溃转储文件。

使用 Breakpad 捕获 Native 崩溃

在 Android 中使用 Breakpad 捕获 Native 崩溃，需要以下步骤：

在 Android Studio 中打开您的项目，然后在 build.gradle 文件中添加 Breakpad 库的依赖：

dependencies {
    debugImplementation 'com.google.breakpad:breakpad-core:1.3.4'
    releaseImplementation 'com.google.breakpad:breakpad-release:1.3.4'
}

在 AndroidManifest.xml 文件中添加 Breakpad 权限：

<manifest ... >
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  ...
</manifest>

在 C++ 代码中初始化 Breakpad 库：

#include <android/log.h>
#include "breakpad/client/linux/handler/handler.h"

namespace {

void Dump(const std::string& dump_path,
         const std::string& minidump_id,
         void* context,
         bool succeeded) {
  if (succeeded) {
    __android_log_print(ANDROID_LOG_INFO, "breakpad",
                        "Dump succeeded: %s", minidump_id.c_str());
  } else {
    __android_log_print(ANDROID_LOG_ERROR, "breakpad",
                        "Dump failed: %s", minidump_id.c_str());
  }
}

}  // namespace

bool InitBreakpad(const std::string& dump_path) {
  google_breakpad::MinidumpDescriptor descriptor(dump_path);
  // Register the callback that Breakpad will call when it writes a minidump.
  google_breakpad::MinidumpCallback callback = &Dump;
  // Install the exception handler.
  google_breakpad::ExceptionHandler eh(descriptor, callback, nullptr, true,
                                     -1);
  // Tell Breakpad where to dump the crash report.
  eh.set_dump_path(dump_path);
  return true;
}

在应用程序的 main() 函数中调用 InitBreakpad() 函数来初始化 Breakpad 库：

int main() {
  ...
  // Initialize Breakpad.
  if (!InitBreakpad(dump_path)) {
    return -1;
  }
  ...
}

当应用程序崩溃时，Breakpad 库会自动捕获崩溃信息并生成崩溃转储文件。该文件通常存储在 /data/data/package_name/cache/native_crash 目录下。
要查看崩溃转储文件，可以使用 Breakpad 工具集中的 minidump_stackwalk 工具。该工具可以将崩溃转储文件转换为可读的堆栈回溯信息。