当前位置：首页 > news >正文

Electron 入门指南

news 来源：原创 2025/4/29 5:57:41

Electron 入门指南

Electron 是一个使用 JavaScript、HTML 和 CSS 构建跨平台桌面应用的框架。通过 Electron，你可以利用 Web 技术开发出功能强大的桌面应用程序，并且能够运行在 Windows、Mac 和 Linux 系统上。

本文将带你从零开始构建一个简单的 Electron 应用程序，并介绍一些基本概念和技巧。

1. 安装 Node.js 和 npm

首先，你需要确保你的机器上已经安装了 Node.js。Electron 是基于 Node.js 构建的，因此需要 Node.js 环境来运行。

你可以访问 Node.js 官网下载并安装最新版本的 Node.js。安装过程中会一并安装 npm（Node Package Manager），这是一个用于管理 JavaScript 包的强大工具。

2. 创建项目结构

接下来，创建一个新目录作为你的 Electron 应用程序的工作空间，并在该目录中初始化一个新的 Node.js 项目：

mkdir my-electron-app
cd my-electron-app
npm init -y

执行 npm init 命令会生成一个 package.json 文件，这是 Node.js 项目的配置文件。

3. 安装 Electron

在你的项目目录中安装 Electron：

npm install electron --save-dev

这行命令将在你的开发依赖项中添加 Electron。此外，你还需要更新 scripts 部分的 package.json 文件，以便能够通过 npm 脚本运行 Electron 应用程序。

4. 编写基本的 HTML 和 JavaScript

在项目根目录下创建一个 index.html 文件作为你的应用程序主界面：

<!-- index.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Electron App</title>
</head>
<body><h1>Hello, Electron!</h1><button id="click-me">Click Me</button><script src="./main.js"></script>
</body>
</html>

接下来，创建一个 main.js 文件作为你的应用程序的入口点：

// main.js
document.getElementById('click-me').addEventListener('click', () => {alert('Button Clicked!');
});

5. 编写主进程代码

在 Electron 中，每个应用都有一个 主进程 和一个或多个 渲染进程。主进程负责创建和管理窗口，而渲染进程则运行在每一个窗口中。

创建一个 main.js 文件作为主进程入口文件：

// main.js (主进程)
const { app, BrowserWindow } = require('electron');function createWindow() {const win = new BrowserWindow({width: 800,height: 600,webPreferences: {nodeIntegration: true // 允许在渲染进程中使用 Node.js API}});win.loadFile('index.html');
}app.whenReady().then(createWindow);app.on('window-all-closed', () => {if (process.platform !== 'darwin') {app.quit();}
});app.on('activate', () => {if (BrowserWindow.getAllWindows().length === 0) {createWindow();}
});

6. 更新 package.json

更新 package.json 文件以包含启动应用的脚本：

{"name": "my-electron-app","version": "1.0.0","main": "main.js","scripts": {"start": "electron ."},"dependencies": {},"devDependencies": {"electron": "^23.0.0" // 确保使用正确的版本}
}