使用 VsCode调试

本指南将介绍如何使用 VSCode debugging 为您自己的 Electron 项目和 native Electron 代码库(Electron codebase)调试。

调试您的 Electron 应用

主进程

1. Open an Electron project in VSCode.

  1. $ git clone git@github.com:electron/electron-quick-start.git
  2. $ code electron-quick-start

2. 添加文件 .vscode/launch.json,内容为

  1. {
  2. "version": "0.2.0",
  3. "configurations": [
  4. {
  5. "name": "Debug Main Process",
  6. "type": "node",
  7. "request": "launch",
  8. "cwd": "${workspaceFolder}",
  9. "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
  10. "windows": {
  11. "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd"
  12. },
  13. "args" : ["."]
  14. }
  15. ]
  16. }

3. Debugging

main.js 中设置一些断点,并在 调试视图 中开始调试. 您应该能够点击断点。

这是一个预先配置好了的项目,你可以下载并直接在 VSCode 中调试:https://github.com/octref/vscode-electron-debug/tree/master/electron-quick-start

调试 Electron 代码库(Electron codebase)

如果您想从源代码构建 Electron 并修改 native Electron 代码库,本节将帮助您测试您的修改。

对于那些不确定在哪里获得代码或如何构建它, Electron 的构建工具 自动化并解释此过程的大部分。 如果你想手动设置环境,你可以使用这些 构建指令

Windows (C++)

1. Open an Electron project in VSCode.

  1. $ git clone git@github.com:electron/electron-quick-start.git
  2. $ code electron-quick-start

2. 添加文件 .vscode/launch.json,内容为

  1. {
  2. "version": "0.2.0",
  3. "configurations": [
  4. {
  5. "name": "(Windows) Launch",
  6. "type": "cppvsdbg",
  7. "request": "launch",
  8. "program": "${workspaceFolder}\\out\\your-executable-location\\electron.exe",
  9. "args": ["your-electron-project-path"],
  10. "stopAtEntry": false,
  11. "cwd": "${workspaceFolder}",
  12. "environment": [
  13. {"name": "ELECTRON_ENABLE_LOGGING", "value": "true"},
  14. {"name": "ELECTRON_ENABLE_STACK_DUMPING", "value": "true"},
  15. {"name": "ELECTRON_RUN_AS_NODE", "value": ""},
  16. ],
  17. "externalConsole": false,
  18. "sourceFileMap": {
  19. "o:\\": "${workspaceFolder}",
  20. },
  21. },
  22. ]
  23. }

配置说明

  • cppvsdbg 需要启用 内置的 C/C++ 扩展
  • ${workspaceFolder} 是 Chromium 的 的完整路径。
  • your-executable-location 将是以下几项之一:
    • Testing:如果您使用的是默认的 Electron 构建工具 设置,或默认的 从源端构建 的设置。
    • Release:如果你构建了一个发布版本,而不是测试版本。
    • your-directory-name:如果你在构建过程中修改, 这将是你指定的。
  • args 数组字符串 "your electron-project-path" 应为您正在用于测试的 Electron 项目或 main.js 的绝对路径。 在本示例中,它应该是您的 electron-quick-start 的路径。

3. Debugging

在你选择的原始 Electron C++ 代码中的 .cc 文件中设置一些断点,并在 Debug View 中开始调试。