vscode调试Electron+ts

调试Electron+js

调试Electron+js: https://www.electronjs.org/zh/docs/latest/tutorial/debugging-vscode


调试Electron+ts

首先看一下,我的目录结构。目录结构决定了launch.json中的路径部分。我将在项目根目录下进行调试,项目根目录下包含electron代码部分,和src等前端代码部分。
在这里插入图片描述

1.创建.vscode,创建launch.json。调试Electron+ts代码部分。

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Main",
      "runtimeExecutable": "${workspaceRoot}/electron/node_modules/.bin/electron",	// 我的electron外部库放在./electron/node_modules下面。如果你的放在./根目录下,改成'${workspaceRoot}/node_modules/.bin/electron'
      "runtimeArgs": [
        "./electron",	// 这里也是,我的electron的入口文件main.ts放在./electron目录下。如果你的在根目录./,改成'.'
        // this args for attaching render process
        "--remote-debugging-port=9222"
      ],
      "windows": {
        "runtimeExecutable": "${workspaceRoot}/electron/node_modules/.bin/electron.cmd"
      },
      "protocol": "legacy"
    }
  ]
}

2.设置如下tsconfig.json(重要,且我的tsconfig.json在./electron/目录下)

{
  "compilerOptions": {
    "module": "commonjs",
    "target": "es2015",
    "noImplicitAny": false,
    "sourceMap": true,	// 经过试验,这个一定要开启
    "moduleResolution": "node",
    "lib": ["es2016", "dom"],
    "baseUrl": "."
  }
}

3.经过以上配置后,如下的的main.ts文件,经过ts编译后(cd electron && tsc --module commonjs),ts将被编译到./electron/dist-electron中。查看dist-electron中,是否有.sourcemap后缀的文件,如果有应该就没有问题了。ts中打个断点,试一下。

import { app, BrowserWindow } from 'electron/main'
import path from 'node:path'

// 🚧 Use ['ENV_NAME'] avoid vite:define plugin - Vite@2.x
const VITE_DEV_SERVER_URL = 'http://localhost:8080/'

const createWindow = () => {
  const win = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js')
    }
  })

  if (!app.isPackaged) {
    win.loadURL('https://www.baidu.com')
  } else {
    win.loadFile(path.resolve(__dirname, '../dist-vite/index.html'))
  }
}

app.whenReady().then(() => {
  createWindow()

  app.on('activate', () => {
    if (BrowserWindow.getAllWindows().length === 0) {
      createWindow()
    }
  })
})

app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') {
    app.quit()
  }
})

在这里插入图片描述


如何调试渲染进程

1.更改launch.json为如下内容。

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Main",
      "runtimeExecutable": "${workspaceRoot}/electron/node_modules/.bin/electron",
      "runtimeArgs": [
        "./electron",
        // this args for attaching render process
        "--remote-debugging-port=9222"
      ],
      "windows": {
        "runtimeExecutable": "${workspaceRoot}/electron/node_modules/.bin/electron.cmd"
      },
      "protocol": "legacy"
    },
    {
      "type": "chrome",
      "request": "attach",
      "name": "Renderer",
      "port": 9222,
      "webRoot": "${workspaceRoot}"	// Renderer 配置中的 webRoot 参数直接使用了 ${workspaceFolder},是因为在这个工程中,HTML 引用的静态资源位于根目录下。
    }
  ],
  "compounds": [	// configurations 中的两项分别对应主进程和渲染进程。compounds 中指定了一个组合会话 All,选择 All 将会同时启动这两个会话。
    {
      "name": "All",
      "configurations": ["Main", "Renderer"]
    }
  ]
}

2.在渲染进程中打一个断点。
在这里插入图片描述
3.启动前端调试服务器。根目录下直接启动Vite服务器(重要,不然前端代码无法执行到断点)。

npm run dev

4.新建一个cmd,选择debug标签页下的All,再按F5,启动两个调试器。
在这里插入图片描述
5.这个时候,前段代码中的断点可能没法打到(因为服务器已经启动了,已经过了断点的执行点了)。此时,刷新前段代码,就可以执行到了。
在这里插入图片描述


完整代码参考

Electron-vite-template


参考

VS Code debug specs - Electron Java Script & Type Script
Electron 应用调试指南

### 设置 VSCode 中的 Electron 和 Node.js 开发环境 #### 配置开发环境 为了在 Visual Studio Code (VSCode) 中高效地使用 Electron 和 Node.js 进行开发,需先确保已安装必要的组件。Node.js 是 JavaScript 的运行时环境,允许开发者编写服务器端代码[^3]。 对于 Electron 应用来说,其核心在于将 Chromium 浏览器引擎与 Node.js 结合起来,从而能够创建跨平台桌面应用程序。因此,在开始之前要确认本地已经正确设置了 Node.js 环境,并通过 npm 安装了 Electron 工具链[^4]。 #### 创建项目结构 初始化一个新的 Node.js 项目并安装 Electron: ```bash mkdir my-electron-app && cd $_ npm init -y npm install --save-dev electron ``` 这会建立基本的应用框架以及下载所需的依赖项。 #### 编辑 `package.json` 文件 更新项目的 package.json 来指定 main script 并添加启动脚本: ```json { "name": "my-electron-app", "version": "1.0.0", "main": "main.js", "scripts": { "start": "electron ." }, ... } ``` 这样就可以利用 npm scripts 启动应用了。 #### 主进程文件 (`main.js`) 定义主进程中的一些逻辑,例如窗口管理和加载网页等内容: ```javascript const { app, BrowserWindow } = require('electron'); let mainWindow; function createWindow() { mainWindow = new BrowserWindow({ width: 800, height: 600, webPreferences: { nodeIntegration: true } }); mainWindow.loadFile('index.html'); // 加载HTML页面 } app.on('ready', createWindow); ``` #### 渲染进程 HTML 页面 (`index.html`) 准备简单的 HTML 文档作为渲染层的一部分: ```html <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>My First Electron App</title> </head> <body> <h1>Hello from Electron!</h1> <script src="./renderer.js"></script> </body> </html> ``` #### 渲染进程脚本 (`renderer.js`) 如果需要的话还可以加入额外的客户端侧业务逻辑: ```javascript console.log('Renderer process started.'); // Your code here... ``` #### 调试配置 最后一步是在 `.vscode/launch.json` 中设定调试选项以便更好地支持断点调试等功能[^5]: ```json { "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch via NPM", "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron", "args" : ["."] } ] } ``` 现在应该可以在 VSCode 内部直接按下 F5 或者选择对应的 Debug Configuration 来启动和调试整个 Electron 应用了。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值