From 7ca54e148f9a25e4c08082582268de0ff9d1a4b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8D=89=E9=9E=8B=E6=B2=A1=E5=8F=B7?= <308487730@qq.com> Date: Wed, 20 Jul 2022 08:56:39 +0800 Subject: [PATCH 1/4] chore(deps): bump vite-plugin-electron to 0.8.0 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 15fa70d..723013e 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "sass": "^1.53.0", "typescript": "^4.7.4", "vite": "^2.9.14", - "vite-plugin-electron": "^0.7.5" + "vite-plugin-electron": "^0.8.0" }, "env": { "VITE_DEV_SERVER_HOST": "127.0.0.1", From 6fc1e5fd9b43ff7a12e19ca394ef3f53732c9fae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8D=89=E9=9E=8B=E6=B2=A1=E5=8F=B7?= <308487730@qq.com> Date: Wed, 20 Jul 2022 08:57:24 +0800 Subject: [PATCH 2/4] docs: update --- README.md | 34 +++++++++++++--------------------- README.zh-CN.md | 40 ++++++++++++++-------------------------- 2 files changed, 27 insertions(+), 47 deletions(-) diff --git a/README.md b/README.md index a90f92d..97f494f 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ npm create electron-vite ```tree ├── electron Electron-related code │ ├── main Main-process source code -│ ├── preload Preload-script source code +│ ├── preload Preload-scripts source code │ └── resources Resources for the production build │ ├── icon.icns Icon for the application on macOS │ ├── icon.ico Icon for the application @@ -52,28 +52,20 @@ npm create electron-vite └── src Renderer source code, your React application ``` -## 🚨 `dependencies` vs `devDependencies` +## 🚨 -**Put Node.js packages in `dependencies`** +By default, this template integrates Node.js in the Renderer process. If you don't need it, you just remove the option below. [Because it will modify the default config of Vite](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated). -**e.g.** `electron-store` `sqlite3` `serilaport` `mongodb` ...others +```diff +# vite.config.ts -**Put Web packages in `devDependencies`** +electron({ +- renderer: {} +}) +``` -**e.g.** `react` `react-dom` `react-router` `mobx` `zustand` `antd` `axios` ...others +## FAQ -See more 👉 [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron-renderer#dependencies-vs-devdependencies) - -## 🚨 Node.js ESM packages - -**e.g.** `node-fetch` `execa` `got` ... - -[👉 Using Node.js ESM packages in Electron-Renderer](https://github.com/electron-vite/vite-plugin-electron-renderer#-nodejs-esm-packages) - - +- [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#dependencies-vs-devdependencies) +- [Using C/C++ native addons in Electron-Renderer](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#load-nodejs-cc-native-modules) +- [Node.js ESM packages](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#nodejs-esm-packages) (e.g. `execa` `node-fetch`) diff --git a/README.zh-CN.md b/README.zh-CN.md index d7c196e..2429bb1 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -11,7 +11,7 @@ ## 概述 📦 开箱即用 -🎯 基于 [react-ts](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) 模板, 低侵入性 +🎯 基于官方的 [react-ts](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) 模板, 低侵入性 🌱 结构清晰,可塑性强 💪 支持在渲染进程中使用 Electron、Node.js API 🔩 支持 C/C++ 模块 @@ -36,7 +36,7 @@ npm create electron-vite ```tree ├── electron Electron 源码文件夹 │ ├── main Main-process 源码 -│ ├── preload Preload-script 源码 +│ ├── preload Preload-scripts 源码 │ └── resources 应用打包的资源文件夹 │ ├── icon.icns 应用图标(macOS) │ ├── icon.ico 应用图标 @@ -52,33 +52,21 @@ npm create electron-vite └── src 渲染进程源码、React代码 ``` -## 🚨 依赖放到 dependencies 还是 devDependencies -**Node.js 包放到 `dependencies` 中** +## 🚨 -**e.g.** `electron-store` `sqlite3` `serilaport` `mongodb` ...others +默认情况下,该模板在渲染进程中集成了 Node.js,如果你不需要它,你只需要删除下面的选项. [因为它会修改 Vite 默认的配置](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated). -**Web 包放到 in `devDependencies` 中** +```diff +# vite.config.ts -**e.g.** `react` `react-dom` `react-router` `mobx` `zustand` `antd` `axios` ...others +electron({ +- renderer: {} +}) +``` -看看这 👉 [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron-renderer#dependencies-vs-devdependencies) +## FAQ - -## 🚨 Node.js ESM packages - -**e.g.** `node-fetch` `execa` `got` ... - -[👉 在 Electron-Renderer 中使用 Node.js ESM 包](https://github.com/electron-vite/vite-plugin-electron-renderer#-nodejs-esm-packages) - - +- [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#dependencies-vs-devdependencies) +- [Using C/C++ native addons in Electron-Renderer](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#load-nodejs-cc-native-modules) +- [Node.js ESM packages](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#nodejs-esm-packages) (e.g. `execa` `node-fetch`) From c90d0b90cda618c9afa9bec9aa31d5956473295d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8D=89=E9=9E=8B=E6=B2=A1=E5=8F=B7?= <308487730@qq.com> Date: Wed, 20 Jul 2022 19:07:54 +0800 Subject: [PATCH 3/4] Update README.zh-CN.md --- README.zh-CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.zh-CN.md b/README.zh-CN.md index 2429bb1..dd30b6d 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -53,7 +53,7 @@ npm create electron-vite ``` -## 🚨 +## 🚨 这需要留神 默认情况下,该模板在渲染进程中集成了 Node.js,如果你不需要它,你只需要删除下面的选项. [因为它会修改 Vite 默认的配置](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated). From c3060c0315cb42c51ae954a916853a607fb76fe7 Mon Sep 17 00:00:00 2001 From: Paul <40315177+PAXANDDOS@users.noreply.github.com> Date: Wed, 20 Jul 2022 14:16:34 +0300 Subject: [PATCH 4/4] docs: add heading --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 97f494f..2df0a8e 100644 --- a/README.md +++ b/README.md @@ -52,7 +52,7 @@ npm create electron-vite └── src Renderer source code, your React application ``` -## 🚨 +## 🚨 Be aware By default, this template integrates Node.js in the Renderer process. If you don't need it, you just remove the option below. [Because it will modify the default config of Vite](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated).