为什么捐赠
API 资源管理器
升级指南
NEW!
quasar.config 文件
转换为 CLI with Webpack
浏览器兼容性
支持 TypeScript
目录结构
命令列表
CSS 预处理器
路由
延迟加载 - 代码分割
处理资源
启动文件
预取功能
API 代理
处理 Webpack
处理 process.env
使用 Pinia 进行状态管理
使用 Vuex 进行状态管理
代码风格检查
测试 & 审计
开发移动应用
Ajax 请求
向公众开放开发服务器
Quasar CLI 与 Webpack - @quasar/app-webpack
Electron 准备工作

在我们深入实际开发之前,我们需要做一些准备工作。

步骤 1:添加 Quasar Electron 模式

为了开发/构建一个 Quasar Electron 应用,我们需要在 Quasar 项目中添加 Electron 模式。这会做的是 yarn/npm/pnpm/bun 安装一些 Electron 包,并在 /src-electron 文件夹中创建。

$ quasar mode add electron

每个 Electron 应用都有两个线程:主线程(处理窗口和初始化代码 - 来自新建文件夹 /src-electron)和渲染线程(处理来自 /src 的实际应用内容)。

新文件夹具有以下结构

icon.icns
# Darwin(MacOS)平台的图标文件
icon.ico
# win32(Windows)平台的图标文件
icon.png
# 所有平台(特别是 Linux)的托盘图标文件
electron-preload.js
# (或 .ts)Electron 预加载脚本(将 Node.js 内容注入到渲染线程)
electron-main.js
# (或 .ts)主线程代码

Windows 用户注意事项

如果您在 npm install 期间遇到有关 node-gyp 的错误,那么您很可能没有在系统上安装正确的构建工具。构建工具包括 Python 和 Visual Studio 等项目。幸运的是,有一些软件包可以帮助简化此过程。

我们需要检查的第一项是 npm 版本,并确保它没有过时。可以使用 npm-windows-upgrade 完成此操作。如果您使用的是 yarn,则可以跳过此检查。

完成后,我们可以继续设置所需的构建工具。使用 windows-build-tools,大部分脏活累活都帮我们做好了。在全局范围内安装它将依次设置 Visual C++ 包、Python 等。

注意:2019 年 4 月

在 Powershell.exe(以管理员身份运行)中,npm install --global windows-build-tools 目前似乎会失败,并显示指向 python2 和 vctools 的错误。您可以使用 Chocolatey 来解决此问题。一键安装

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString(‘https://chocolatey.org/install.ps1’))

然后运行 choco upgrade python2 visualstudio2017-workload-vctools

此时,事情应该能够成功安装,但如果失败,则需要重新安装 Visual Studio。请注意,这些不是 Quasar 的问题,而是与 NPM 和 Windows 相关的问题。

步骤 2:开始开发

如果您想直接开始开发,可以使用“quasar mode”命令跳过上一步并发出

$ quasar dev -m electron

# passing extra parameters and/or options to
# underlying "electron" executable:
$ quasar dev -m electron -- --no-sandbox --disable-setuid-sandbox
# when on Windows and using Powershell:
$ quasar dev -m electron '--' --no-sandbox --disable-setuid-sandbox

这将自动添加 Electron 模式(如果缺失)。它将打开一个 Electron 窗口,该窗口将渲染您的应用,并同时打开开发者工具。