首页 > 其他分享 >Electron学习笔记(二)Hello World

Electron学习笔记(二)Hello World

时间:2024-07-30 18:55:11浏览次数:11  
标签:createWindow const 窗口 app js BrowserWindow Electron World Hello

目录

前言

运行主进程

创建界面

使用窗口打开界面

管理窗口的生命周期

关闭所有窗口时退出应用 (Windows & Linux)​

如果没有窗口打开则打开一个窗口 (macOS)

使用预加载脚本访问渲染器的Node.js

添加你自己的功能

完整代码展示

效果展示


前言

接上一篇文章

Electron学习笔记(一)基础环境-CSDN博客

这一篇文章我们开始做第一个小demo

运行主进程

上一篇文章我们在根目录配置了package.json文件

任何 Electron 应用程序的入口都是 main 字段对应文件。 这个文件控制了主进程,它运行在一个完整的Node.js环境中,负责控制应用的生命周期,显示原生界面,执行特殊操作并管理渲染器进程(稍后详细介绍)。

执行期间,Electron 将依据应用中 package.json配置下main字段中配置的值查找此文件。

我们在上一篇中配置了scripts字段中的start。此时我们可以执行以下命令来开始运行程序:

npm start

此时会弹窗并报错,提示你找不到main.js文件。

要初始化这个main文件,需要在项目的根目录下创建一个名为main.js的空文件。

创建完成后再次执行,效果如下

注意:这一次运行start命令,应用将不再抛出任何错误! 然而,它不会做任何事因为我们还没有在main.js中添加任何代码。

创建界面

在为我们的应用创建窗口前,我们需要先创建加载进该窗口的内容。 在Electron中,各个窗口显示的内容可以是本地HTML文件,也可以是一个远程url。

我们这里使用本地的HTML文件。

在项目根目录下创建一个名为index.html的文件,内容如下:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <!-- https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP -->
    <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'">
    <title>Hello World!</title>
  </head>
  <body>
    <h1>Hello World!</h1>
    We are using Node.js <span id="node-version"></span>,
    Chromium <span id="chrome-version"></span>,
    and Electron <span id="electron-version"></span>.
  </body>
</html>

注意:在这个HTML文本中,你会发现主体文本中丢失了版本编号。 稍后我们将使用 JavaScript 动态插入它们。

使用窗口打开界面

现在我们有了一个页面,下面需要将它加载进应用窗口中。 要做到这一点,你需要 两个Electron模块:

  • app 模块,它控制应用程序的事件生命周期。
  • BrowserWindow 模块,它创建和管理应用程序 窗口。

因为主进程通过Node.js运行,所以我们需要在 main.js文件开头import这些模块。

const { app, BrowserWindow } = require('electron')

然后,添加一个createWindow()方法来将index.html加载进一个新的BrowserWindow实例。

const createWindow = () => {
  const win = new BrowserWindow({
    width: 800,
    height: 600
  })

  win.loadFile('index.html')
}

接着,调用createWindow()函数来打开您的窗口。

在 Electron 中,只有在 app 模块的 ready 事件被激发后才能创建浏览器窗口。 您可以通过使用 app.whenReady() API来监听此事件。 在whenReady()成功后调用createWindow()

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

到这里,整个main.js文件应该是这样的

const { app, BrowserWindow } = require('electron')

const createWindow = () => {
    const win = new BrowserWindow({
      width: 800,
      height: 600
    })
  
    win.loadFile('index.html')
}

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

保存后,在cmd中运行上面提到的开始命令:

npm start

此时你的“Hello World”窗口应该已经可以成功打开了。

管理窗口的生命周期

虽然我们现在可以打开一个浏览器窗口,但你还需要一些额外的模板代码使其看起来更像是各平台原生的应用。 应用程序窗口在每个OS下有不同的行为,Electron将在app中实现这些约定的责任交给开发者们。

一般而言,你可以使用 进程 全局的 platform 属性来专门为某些操作系统运行代码。

关闭所有窗口时退出应用 (Windows & Linux)

在Windows和Linux上,关闭所有窗口通常会完全退出一个应用程序。

为了实现这一点,你需要监听 app 模块的 'window-all-closed' 事件。如果用户不是在 macOS(darwin) 上运行程序,则调用 app.quit()

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

如果没有窗口打开则打开一个窗口 (macOS)

当 Linux 和 Windows 应用在没有窗口打开时退出了,macOS 应用通常即使在没有打开任何窗口的情况下也继续运行,并且在没有窗口可用的情况下激活应用时会打开新的窗口。

为了实现这一特性,监听 app 模块的 activate 事件。如果没有任何浏览器窗口是打开的,则调用 createWindow() 方法。

因为窗口无法在 ready 事件前创建,你应当在你的应用初始化后仅监听 activate 事件。 通过在您现有的 whenReady() 回调中附上您的事件监听器来完成这个操作。

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

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

使用预加载脚本访问渲染器的Node.js

这个步骤我们演示的是输出Electron的版本号和它的依赖项到你的web页面上。

通过 Node 的全局进程对象在主进程中访问这些信息非常简单。 然而,你不能直接在主进程中编辑DOM,因为它无法访问渲染器的document上下文。 它们存在于完全不同的进程!

英文参考文档:Process Model | Electron (electronjs.org)

这时我们要用到预加载脚本。预加载脚本在渲染器进程加载之前加载,并有权访问两个渲染器全局 (例如 window 和 document) 和 Node.js 环境。

在根目录创建一个名为 preload.js 的新脚本如下:

window.addEventListener('DOMContentLoaded', () => {
  const replaceText = (selector, text) => {
    const element = document.getElementById(selector)
    if (element) element.innerText = text
  }

  for (const dependency of ['chrome', 'node', 'electron']) {
    replaceText(`${dependency}-version`, process.versions[dependency])
  }
})

上面的代码访问 Node.js的 process.versions 对象,并运行一个基本的 replaceText 辅助函数将版本号插入到 HTML 文档中。

要将此脚本附加到渲染器流程,请在你现有的 BrowserWindow 构造器中将路径中的预加载脚本传入 webPreferences.preload 选项。修改后如下:

const { app, BrowserWindow } = require('electron')
// 在你文件顶部导入 Node.js 的 path 模块
const path = require('node:path')

// 修改已有的 createWindow() 方法
const createWindow = () => {
  const win = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js')
    }
  })

  win.loadFile('index.html')
}
// ...

这里使用了两个Node.js概念:

  • __dirname 字符串指向当前正在执行脚本的路径 (在本例中,它指向你的项目的根文件夹)。
  • path.join API 将多个路径联结在一起,创建一个跨平台的路径字符串。

使用相对路径的方法在开发和打包时同样有效。

添加你自己的功能

此刻,你可能想知道如何为应用程序添加更多功能。

对于任何与 Web 内容的交互,需要将脚本添加到渲染器进程中。由于渲染器在正常的 Web 环境中运行,因此可以在 index.html 文件的结束标记 </body> 之前添加 <script> 标记,以包含您想要的任意脚本,例如:

<script src="./renderer.js"></script>

renderer.js 中包含的代码可以在接下来使用与前端开发相同的 JavaScript API 和工具。例如使用 webpack 打包并最小化您的代码,或者使用 React 来管理您的用户界面。

完整代码展示

main.js

const { app, BrowserWindow } = require('electron')
// 在你文件顶部导入 Node.js 的 path 模块
const path = require('node:path')

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

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

preload.js

window.addEventListener('DOMContentLoaded', () => {
    const replaceText = (selector, text) => {
      const element = document.getElementById(selector)
      if (element) element.innerText = text
    }
  
    for (const dependency of ['chrome', 'node', 'electron']) {
      replaceText(`${dependency}-version`, process.versions[dependency])
    }
})

index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <!-- https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP -->
    <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'">
    <title>Hello World!</title>
  </head>
  <body>
    <h1>Hello World!</h1>
    We are using Node.js <span id="node-version"></span>,
    Chromium <span id="chrome-version"></span>,
    and Electron <span id="electron-version"></span>.
    
    <script src="./renderer.js"></script>
  </body>
</html>

package.json

{
  "name": "项目名称",
  "version": "1.0.0",
  "main": "main.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
	  "start": "electron ."
  },
  "author": "你的名字",
  "license": "ISC",
  "description": "你的项目描述"
}

效果展示

执行上面的提到的start命令开始程序,结果如下:

 快捷键 ctrl+shift+i 打开控制台,如下:

下一篇文章将项目打包成发布版本

标签:createWindow,const,窗口,app,js,BrowserWindow,Electron,World,Hello
From: https://blog.csdn.net/weixin_44339850/article/details/140799555

相关文章

  • 快速开启react+electron应用,搭建启动问题
    注意:React本地启动在3000端口Electron在创建BrowserWindow的时候,可以读取本地的文件或者是url开发环境读取localhost:3000生产环境需要加载本地成型以后的本地文件,打包的时候再考虑一react脚手架create-react-app快速搭建reactnpxcreate-react-appmy-ap......
  • 论文阅读:Borrowing wisdom from world: modeling rich external knowledge for Chines
    问题定义由于词级中文NER存在第三方解析器分割的边界错误,因此考虑将字符级NER作为默认设置。使用'BMES'标记方案进行字符级NER,将标记表述为序列标记问题。即,对于句子\(s={c_1,...,c_n}\)中的每个字符\(c_i\),使用标签集中的标签进行标记\(L={B,M,E,S,O}\)。O:非实体元素B:实......
  • QOJ7899 Say Hello to the Future
    考虑先求出原序列的方案数设\(f_i\)表示\(1\simi\)被划分为若干区间的方案数,若一段区间合法当且仅当\(r-l+1\ge\max\{a_{l\simr}\}\),可以发现数据结构难以维护且由于不是最优性问题,考虑\(\texttt{cdq}\)分治优化对于每个分治中心\(m\),令\(mxL_i=\max\{a_{i\si......
  • 【Blog1】PyCharm写hello world
    创建项目选择项目类型和项目目录设置python编译器选择编译器新建Python文件编写代码并运行运行运行结果......
  • 最长的Hello, World!(C++)
    最长的Hello,World!(C++)#include<iostream>#include<string>#include<vector>#include<memory>#include<random>_<typenameT>classNode{public:Tdata;std::shared_ptr<Node<T>>next;Node(......
  • 最长的Hello, World!(Python)
    最长的Hello,World!(Python)(lambda_,__,___,____,_____,______,_______,________:getattr(__import__(True.__class__.__name__[_]+[].__class__.__name__[__]),().__class__.__eq__.__class__.__name__[:__]+().__iter__().__cla......
  • Hello World
    1.第一个代码helloworld1.随便建立一个文件夹,用来存放代码2.新建一个Java文件。文件后缀名是.java例如Hello.Java注意如果修改不起点击文件上方的查看,把文件扩展名勾选上。3.编写代码publicclassHello{ publicstaticvoidmain(String[]args){ System.out.print("......
  • oracle EF core hello world
    在oracle数据库里建一个表CREATETABLEstudent(numintnotnull,namevarchar2(200)notnull,PRIMARYKEY(num));通过vsstudio2022建一个"控制台应用"类型的项目.通过vsstudio上的nuget下载Oracle.EntityFrameworkCore,Microsoft.EntityFrameworkCore......
  • 虚拟机编译安装 dpdk--运行helloworld
    DPDK技术介绍一,版本信息DPDK版本:dpdk-22.07操作系统:Ubuntu22.04.1LTS二、虚拟机ubuntu添加网卡1.2.显卡由enssx改为ethxsudonano/etc/default/grub找到GRUB_CMDLINE_LINUX=""改为GRUB_CMDLINE_LINUX="net.ifnames=0biosdevname=0"然后执行如下指令sudogr......
  • 解决npm安装electron失败的问题
    1.问题描述使用npm创建项目后,添加electron依赖npminstallelectron--save-dev一直报错,部分报错日志如下484sillyauditerror[objectObject][email protected]{code:1,signal:null}487verbosestac......