macOS 上的调试

如果您遇到了 Electron 中的崩溃或问题，并且您认为这些问题不是由您的 JavaScript 应用程序引起的，而是由 Electron 本身引起的，那么调试起来可能有点棘手，尤其是对于不习惯原生/C++ 调试的开发人员来说。但是，使用 lldb 和 Electron 源代码，您可以启用在 Electron 源代码内部设置断点的单步调试。如果您喜欢使用图形界面，也可以使用 XCode 进行调试。

要求

Electron 的测试版本：最简单的方法通常是从源代码构建它，您可以按照构建说明中的说明进行操作。虽然您可以直接下载 Electron 并附加和调试它，但您会发现它经过了高度优化，这使得调试变得更加困难。在这种情况下，调试器将无法显示所有变量的内容，并且执行路径可能看起来很奇怪，因为存在内联、尾调用和其他编译器优化。
Xcode：除了 Xcode 之外，您还应该安装 Xcode 命令行工具。它们包含 LLDB，这是 macOS 上 Xcode 中的默认调试器。它支持在桌面和 iOS 设备和模拟器上调试 C、Objective-C 和 C++。

.lldbinit：创建或编辑 ~/.lldbinit 以允许正确地对 Chromium 代码进行源映射。

# e.g: ['~/electron/src/tools/lldb']
script sys.path[:0] = ['<...path/to/electron/src/tools/lldb>']
script import lldbinit

附加到 Electron 并进行调试

要启动调试会话，请打开终端并启动 lldb，并将 Electron 的非发布版本作为参数传递。

$ lldb ./out/Testing/Electron.app
(lldb) target create "./out/Testing/Electron.app"
Current executable set to './out/Testing/Electron.app' (x86_64).

设置断点

LLDB 是一款功能强大的工具，支持多种代码检查策略。对于这个基本介绍，让我们假设您正在从 JavaScript 调用一个行为不正常的命令 - 因此您希望在 Electron 源代码内部的该命令的 C++ 对应项上中断。

相关的代码文件可以在 ./shell/ 中找到。

假设您想要调试 app.setName()，它在 browser.cc 中定义为 Browser::SetName()。使用 breakpoint 命令设置断点，指定要中断的文件和行

(lldb) breakpoint set --file browser.cc --line 117
Breakpoint 1: where = Electron Framework`atom::Browser::SetName(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&) + 20 at browser.cc:118, address = 0x000000000015fdb4

然后，启动 Electron

(lldb) run

该应用程序将立即暂停，因为 Electron 在启动时设置了应用程序的名称

(lldb) run
Process 25244 launched: '/Users/fr/Code/electron/out/Testing/Electron.app/Contents/MacOS/Electron' (x86_64)
Process 25244 stopped
* thread #1: tid = 0x839a4c, 0x0000000100162db4 Electron Framework`atom::Browser::SetName(this=0x0000000108b14f20, name="Electron") + 20 at browser.cc:118, queue = 'com.apple.main-thread', stop reason = breakpoint 1.1
    frame #0: 0x0000000100162db4 Electron Framework`atom::Browser::SetName(this=0x0000000108b14f20, name="Electron") + 20 at browser.cc:118
   115 	}
   116
   117 	void Browser::SetName(const std::string& name) {
-> 118 	  name_override_ = name;
   119 	}
   120
   121 	int Browser::GetBadgeCount() {
(lldb)

要显示当前帧的参数和局部变量，请运行 frame variable（或 fr v），这将显示应用程序当前将名称设置为“Electron”。

(lldb) frame variable
(atom::Browser *) this = 0x0000000108b14f20
(const string &) name = "Electron": {
    [...]
}

要在当前选定线程中进行源级单步操作，请执行 step（或 s）。这将带您进入 name_override_.empty()。要继续执行并进行单步执行，请运行 next（或 n）。

(lldb) step
Process 25244 stopped
* thread #1: tid = 0x839a4c, 0x0000000100162dcc Electron Framework`atom::Browser::SetName(this=0x0000000108b14f20, name="Electron") + 44 at browser.cc:119, queue = 'com.apple.main-thread', stop reason = step in
    frame #0: 0x0000000100162dcc Electron Framework`atom::Browser::SetName(this=0x0000000108b14f20, name="Electron") + 44 at browser.cc:119
   116
   117 	void Browser::SetName(const std::string& name) {
   118 	  name_override_ = name;
-> 119 	}
   120
   121 	int Browser::GetBadgeCount() {
   122 	  return badge_count_;

注意：如果您在应该看到源代码时没有看到源代码，则可能没有添加上面的 ~/.lldbinit 文件。

要在此处完成调试，请运行 process continue。您也可以继续执行，直到在该线程中命中某个特定行（thread until 100）。此命令将运行当前帧中的线程，直到它到达该帧中的第 100 行，或者如果它离开当前帧则停止。

现在，如果您打开 Electron 的开发者工具并调用 setName，您将再次命中断点。

进一步阅读

LLDB 是一款功能强大的工具，拥有完善的文档。要了解有关它的更多信息，请参考 Apple 的调试文档，例如 LLDB 命令结构参考或将 LLDB 用作独立调试器的介绍。

您还可以查看 LLDB 的出色手册和教程，其中将解释更复杂的调试场景。

要求​

附加到 Electron 并进行调试​

设置断点​

进一步阅读​

要求

附加到 Electron 并进行调试

设置断点

进一步阅读