mirror of
https://github.com/alex8088/electron-vite.git
synced 2026-06-14 10:38:22 +08:00
With build.bytecode enabled, apps crash at launch on Electron 42 (V8 14.8) with "Invalid or incompatible cached data (cachedDataRejected)". Electron 41 (V8 14.6) is unaffected, on the same machine and arch. On V8 14.8 the code cache is bound to a per-process-type snapshot/isolate checksum AND flag hash (electron/electron#51831 gives each process type its own Node startup snapshot), and vm.Script no longer runs a cache when the loader supplies a placeholder source. Fix: compile each chunk in the Electron process type that will consume it, via vm.compileFunction: - main chunks -> the browser (main) process - preload chunks -> a renderer process (a hidden window whose sandbox:false preload compiles the chunk) Load via vm.compileFunction under --no-lazy, which runs the cache and ignores the placeholder body (made unique per file to avoid V8 compilation-cache collisions). No header bytes are patched, so an incompatible cache fails loudly instead of corrupting execution. Note: bytecode compilation now spawns Electron processes (a main process, and a hidden window for the preload). On Windows this works without an interactive desktop (e.g. over SSH); on Linux a display may be required (e.g. xvfb).
electron-vite
Next generation Electron build tooling based on Vite
Documentation | Getting Started | create-electron
Features
- ⚡️ Vite powered and use the same way.
- 🛠 Pre-configure with sensible defaults optimized for Electron.
- 💡 Optimize asset handling for Electron main process.
- 🚀 Fast HMR & hot reloading.
- 🔥 Isolated build for multi-entry application development.
- ✨ Simplify multi-threading development.
- 🔒 Compile code to v8 bytecode to protect source code.
- 🔌 Easy to debug in IDEs such as VSCode or WebStorm.
- 📦 Out-of-the-box support for TypeScript, Vue, React, Svelte, SolidJS and more.
Usage
Install
npm i electron-vite -D
Development & Build
In a project where electron-vite is installed, you can use electron-vite binary directly with npx electron-vite or add the npm scripts to your package.json file like this:
{
"scripts": {
"start": "electron-vite preview",
"dev": "electron-vite dev",
"prebuild": "electron-vite build"
}
}
Configuration
When running electron-vite from the command line, electron-vite will automatically try to resolve a config file named electron.vite.config.js inside project root. The most basic config file looks like this:
// electron.vite.config.js
export default {
main: {
// vite config options
},
preload: {
// vite config options
},
renderer: {
// vite config options
}
}
Getting Started
Clone the electron-vite-boilerplate or use the create-electron tool to scaffold your project.
npm create @quick-start/electron@latest
Currently supported template presets include:
| JavaScript | TypeScript |
|---|---|
| vanilla | vanilla-ts |
| vue | vue-ts |
| react | react-ts |
| svelte | svelte-ts |
| solid | solid-ts |
Contribution
See Contributing Guide.
License
MIT © alex.wei
Languages
TypeScript
95.4%
JavaScript
4.6%