electron-quickstart

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
electron-quickstart [2026/11/03 23:47] – 创建快速开始页面骨架 张叶安electron-quickstart [2026/11/03 23:50] (当前版本) – 追加简化的 index.html 示例 张叶安
行 19: 行 19:
  
 能打印出版本号,说明 Electron 的二进制已正确下载安装。若卡在下载环节,可先配置镜像再重试。 能打印出版本号,说明 Electron 的二进制已正确下载安装。若卡在下载环节,可先配置镜像再重试。
 +
 +===== 二、最小工程的四个文件 =====
 +
 +<code>
 +my-electron-demo/
 +├─ package.json
 +├─ main.js        主进程
 +├─ preload.js     桥接层
 +├─ index.html     界面
 +└─ renderer.js    界面脚本
 +</code>
 +
 +==== package.json ====
 +
 +关键是 ''main'' 与 ''start'' 两个字段。不要加 type 为 module 的声明,保持 CommonJS 最省事。
 +
 +<code json>
 +{
 +  "name": "my-electron-demo",
 +  "version": "1.0.0",
 +  "main": "main.js",
 +  "scripts": {
 +    "start": "electron ."
 +  },
 +  "devDependencies": {
 +    "electron": "^33.0.0"
 +  }
 +}
 +</code>
 +
 +==== main.js ====
 +
 +主进程:创建窗口、注册 IPC 处理函数、管理应用生命周期。安全相关的三个选项保持安全取值。
 +
 +<code js>
 +const { app, BrowserWindow, ipcMain } = require('electron')
 +const path = require('node:path')
 +
 +function createWindow () {
 +  const win = new BrowserWindow({
 +    width: 1000,
 +    height: 700,
 +    show: false,
 +    webPreferences: {
 +      preload: path.join(__dirname, 'preload.js'),
 +      contextIsolation: true,
 +      nodeIntegration: false,
 +      sandbox: true
 +    }
 +  })
 +
 +  win.once('ready-to-show', () => win.show())   // 避免白屏闪烁
 +  win.loadFile('index.html')
 +}
 +
 +// 最典型的 IPC:渲染进程请求,主进程应答
 +ipcMain.handle('ping', () => 'pong from main')
 +
 +app.whenReady().then(() => {
 +  createWindow()
 +  app.on('activate', () => {
 +    if (BrowserWindow.getAllWindows().length === 0) createWindow()
 +  })
 +})
 +
 +app.on('window-all-closed', () => {
 +  if (process.platform !== 'darwin') app.quit()
 +})
 +</code>
 +
 +==== preload.js ====
 +
 +只通过 ''contextBridge'' 暴露最小粒度的 API,绝不整体暴露 ''ipcRenderer''。
 +
 +<code js>
 +const { contextBridge, ipcRenderer } = require('electron')
 +
 +contextBridge.exposeInMainWorld('api', {
 +  ping: () => ipcRenderer.invoke('ping'),
 +  electronVersion: process.versions.electron
 +})
 +</code>
 +
 +==== renderer.js ====
 +
 +这是普通网页脚本,拿不到 ''fs'' 等 Node 模块,需要系统能力时一律走 IPC。
 +
 +<code js>
 +document.getElementById('btn').addEventListener('click', async () => {
 +  const pong = await window.api.ping()
 +  document.getElementById('out').textContent =
 +    `${pong} / Electron ${window.api.electronVersion}`
 +})
 +</code>
 +
 +==== index.html ====
 +
 +用普通脚本标签引入同目录的 renderer.js,并声明一条基础 CSP,禁止内联脚本。
 +
 +<code html>
 +<!doctype html>
 +<h1>Hello Electron</h1>
 +<button id="btn">Ping 主进程</button>
 +<pre id="out"></pre>
 +</code>
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • electron-quickstart.1793720854.txt.gz
  • 最后更改: 2026/11/03 23:47
  • 由 张叶安