百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT知识 > 正文

零基础小白也能学会!手把手教你用Electron打包网页为桌面应用

liuian 2025-04-24 03:39 46 浏览



一、引言

Electron 是一款由 GitHub 开发的开源框架,允许开发者使用 HTML、CSS 和 JavaScript 构建跨平台的桌面应用程序。无论你是 Web 开发者,还是想将现有网页项目转化为桌面应用,Electron 都能轻松实现。本教程将带领你从零开始,完成从环境搭建到打包发布的完整流程。


二、环境准备

1. 安装 Node.js 和 npm

  • 访问 Node.js 官网 下载并安装 LTS 版本(推荐 v16.x 或更高)。
  • 安装完成后,打开终端输入以下命令验证是否成功:
node -v  # 查看 Node.js 版本  
npm -v   # 查看 npm 版本  
  • 提示:若版本号未显示,请重启终端或检查环境变量配置。

2. 安装 Electron

在终端中执行以下命令,将 Electron 安装为开发依赖:

npm install --save-dev electron  

注:后续教程中所有命令均需在项目根目录下执行。


三、创建项目结构

1. 初始化项目

mkdir my-electron-app  
cd my-electron-app  
npm init -y  # 生成默认的 package.json 文件  

2. 创建核心文件

  • main.js(主进程文件,控制应用窗口):
const { app, BrowserWindow } = require('electron');
const path = require('path');

function createWindow() {
  const win = new BrowserWindow({
    width: 1200,
    height: 800,
    webPreferences: {
      nodeIntegration: true,  // 允许 Node.js 集成(可选)
      contextIsolation: false  // 关闭上下文隔离(可选)
    }
  });

  // 加载本地 HTML 文件(或远程网页)
  win.loadFile('index.html'); 
  // 若需加载远程网页(如 GitHub Pages),改用:
  // win.loadURL('https://your-page-url.com');
}

app.whenReady().then(createWindow);

app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') {
    app.quit();
  }
});
  • 代码说明:
    • BrowserWindow 定义窗口尺寸和加载内容。
    • app.whenReady() 确保 Electron 完全初始化后再创建窗口。
  • index.html(前端页面文件):
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>我的桌面应用</title>
  <style>
    body { margin: 0; padding: 20px; font-family: Arial; }
  </style>
</head>
<body>
  <h1>欢迎使用 Electron 打包应用!</h1>
  <p>这是一个由前端页面转化的桌面程序。</p>
</body>
</html>

四、运行与调试

1. 启动应用

在终端执行:

npm start  

效果: 应用窗口将显示 index.html 的内容。

2. 调试技巧

  • 打开开发者工具:在 main.js 中添加 win.webContents.openDevTools()
  • 热重载:安装 electron-reloader 后,在 main.js 引入:
require('electron-reloader')(module);

五、打包为可执行文件

1. 安装打包工具

推荐使用 electron-packager(简单易用)或 electron-builder(功能更强大)。

npm install --save-dev electron-packager  # 或 electron-builder

2. 配置 package.json

scripts 中添加打包命令:

"scripts": {
  "package-win": "electron-packager . MyAppName --platform=win32 --arch=x64 --icon=assets/icons/win/icon.ico --overwrite",
  "package-mac": "electron-packager . MyAppName --platform=darwin --arch=x64 --icon=assets/icons/mac/icon.icns --overwrite",
  "package-linux": "electron-packager . MyAppName --platform=linux --arch=x64 --icon=assets/icons/png/icon.png --overwrite"
}

参数说明:

  • --platform:目标平台(win32/macOS/linux)。
  • --arch:CPU 架构(x64/arm64 等)。
  • --icon:应用图标路径(需准备 .ico/.icns/.png 格式)。

3. 执行打包命令

npm run package-win  # 打包 Windows 版本

输出路径:
release-builds/MyAppName-win32-x64/

4. 使用 electron-builder(进阶)

package.json 中配置:

"build": {
  "appId": "com.example.myapp",
  "win": {
    "target": "nsis",  // 生成安装包
    "icon": "assets/icons/win/icon.ico"
  },
  "nsis": {
    "oneClick": false,  // 允许自定义安装路径
    "allowToChangeInstallationDirectory": true
  }
}

执行命令:

npm run dist  # 生成 .exe/.dmg/.deb 等安装包

六、常见问题解决

1. 打包时报错:Node.js 版本过高

package.jsonscripts 中添加环境变量:

"scripts": {
  "package-win": "SET NODE_OPTIONS=--openssl-legacy-provider && electron-packager . MyAppName ...",
  "package-mac": "NODE_OPTIONS=--openssl-legacy-provider electron-packager . MyAppName ...",
  "package-linux": "NODE_OPTIONS=--openssl-legacy-provider electron-packager . MyAppName ..."
}

2. 应用图标不显示

  • 使用工具 icofx.ro 将图片转换为 .ico/.icns 格式。
  • 确保图标路径与 --icon 参数一致。

3. 路由模式冲突(Vue 项目)

若前端使用 Vue Router 的 history 模式,打包后可能白屏。修改为 hash 模式:

const router = new VueRouter({
  mode: 'hash',  // 关键修改
  routes: [...]
});

七、结束了


经由本教程,您已然熟稔了将前端网页借助 Electron 打包成桌面应用的核心技艺。

无论是仅仅用于简单地展示页面,比如基础的信息呈现、产品介绍等,还是致力于开发极为复杂的应用,例如涉及多个交互模块、大量数据处理以及复杂逻辑运算的应用程序,Electron 都能够给予强有力的支持。

若想要对应用进行进一步的优化,就可以去探索 asar 打包这一方式,它能够有效地隐藏源码,增强应用的安全性和保密性。此外,自动更新功能也是一个值得深入研究的方向。比如,当应用有新的版本发布时,自动更新功能能够及时提醒用户并在后台自动完成更新,为用户提供最新、最完善的使用体验,避免了用户手动查找和更新的繁琐过程。


感谢点赞关注收藏:)

相关推荐

2023年最新微信小程序抓包教程(微信小程序 抓包)

声明:本公众号大部分文章来自作者日常学习笔记,部分文章经作者授权及其他公众号白名单转载。未经授权严禁转载。如需转载,请联系开百。请不要利用文章中的相关技术从事非法测试。由此产生的任何不良后果与文...

测试人员必看的软件测试面试文档(软件测试面试怎么说)

前言又到了毕业季,我们将会迎来许多需要面试的小伙伴,在这里呢笔者给从事软件测试的小伙伴准备了一份顶级的面试文档。1、什么是bug?bug由哪些字段(要素)组成?1)将在电脑系统或程序中,隐藏着的...

复活,视频号一键下载,有手就会,长期更新(2023-12-21)

视频号下载的话题,也算是流量密码了。但也是比较麻烦的问题,频频失效不说,使用方法也难以入手。今天,奶酪就来讲讲视频号下载的新方案,更关键的是,它们有手就会有用,最后一个方法万能。实测2023-12-...

新款HTTP代理抓包工具Proxyman(界面美观、功能强大)

不论是普通的前后端开发人员,还是做爬虫、逆向的爬虫工程师和安全逆向工程,必不可少会使用的一种工具就是HTTP抓包工具。说到抓包工具,脱口而出的肯定是浏览器F12开发者调试界面、Charles(青花瓷)...

使用Charles工具对手机进行HTTPS抓包

本次用到的工具:Charles、雷电模拟器。比较常用的抓包工具有fiddler和Charles,今天讲Charles如何对手机端的HTTS包进行抓包。fiddler抓包工具不做讲解,网上有很多fidd...

苹果手机下载 TikTok 旧版本安装包教程

目前苹果手机能在国内免拔卡使用的TikTok版本只有21.1.0版本,而AppStore是高于21.1.0版本,本次教程就是解决如何下载TikTok旧版本安装包。前期准备准备美区...

【0基础学爬虫】爬虫基础之抓包工具的使用

大数据时代,各行各业对数据采集的需求日益增多,网络爬虫的运用也更为广泛,越来越多的人开始学习网络爬虫这项技术,K哥爬虫此前已经推出不少爬虫进阶、逆向相关文章,为实现从易到难全方位覆盖,特设【0基础学爬...

防止应用调试分析IP被扫描加固实战教程

防止应用调试分析IP被扫描加固实战教程一、概述在当今数字化时代,应用程序的安全性已成为开发者关注的焦点。特别是在应用调试过程中,保护应用的网络安全显得尤为重要。为了防止应用调试过程中IP被扫描和潜在的...

一文了解 Telerik Test Studio 测试神器

1.简介TelerikTestStudio(以下称TestStudio)是一个易于使用的自动化测试工具,可用于Web、WPF应用的界面功能测试,也可以用于API测试,以及负载和性能测试。Te...

HLS实战之Wireshark抓包分析(wireshark抓包总结)

0.引言Wireshark(前称Ethereal)是一个网络封包分析软件。网络封包分析软件的功能是撷取网络封包,并尽可能显示出最为详细的网络封包资料。Wireshark使用WinPCAP作为接口,直接...

信息安全之HTTPS协议详解(加密方式、证书原理、中间人攻击 )

HTTPS协议详解(加密方式、证书原理、中间人攻击)HTTPS协议的加密方式有哪些?HTTPS证书的原理是什么?如何防止中间人攻击?一:HTTPS基本介绍:1.HTTPS是什么:HTTPS也是一个...

Fiddler 怎么抓取手机APP:抖音、小程序、小红书数据接口

使用Fiddler抓取移动应用程序(APP)的数据接口需要进行以下步骤:首先,确保手机与计算机连接在同一网络下。在计算机上安装Fiddler工具,并打开它。将手机的代理设置为Fiddler代理。具体方...

python爬虫教程:教你通过 Fiddler 进行手机抓包

今天要说说怎么在我们的手机抓包有时候我们想对请求的数据或者响应的数据进行篡改怎么做呢?我们经常在用的手机手机里面的数据怎么对它抓包呢?那么...接下来就是学习python的正确姿势我们要用到一款强...

Fiddler入门教程全家桶,建议收藏

学习Fiddler工具之前,我们先了解一下Fiddler工具的特点,Fiddler能做什么?如何使用Fidder捕获数据包、修改请求、模拟客户端向服务端发送请求、实施越权的安全性测试等相关知识。本章节...

fiddler如何抓取https请求实现手机抓包(100%成功解决)

一、HTTP协议和HTTPS协议。(1)HTTPS协议=HTTP协议+SSL协议,默认端口:443(2)HTTP协议(HyperTextTransferProtocol):超文本传输协议。默认...