@@ -263,18 +263,19 @@ options.
263263
264264### Prepared server bytecode
265265
266- Native desktop artifact builds generate server bytecode with the packaged Electron executable,
267- after ASAR creation and before signing. Cross-platform and cross-architecture builds skip this
268- step explicitly. CLI, SEA and WSL runtimes keep their existing behavior; only desktop backend
269- imports covered by generation receive prepared bytecode. Worker-only modules compile normally.
266+ Native macOS and Windows desktop artifact builds generate server bytecode with the packaged
267+ Electron executable, after ASAR creation and before signing. Linux builds skip generation until
268+ native packaging and relocated AppImage reuse have been validated. Cross-platform and
269+ cross-architecture builds also skip generation explicitly. CLI, SEA and WSL runtimes keep their
270+ existing behavior; only desktop backend imports covered by generation receive prepared bytecode.
271+ Worker-only modules compile normally.
270272
271273Electron's Node 24 cache has no read-only option and includes the producer UID in its directory
272274name. The backend links individual prepared files into its writable cache with keys for the
273275installed module paths. Node replaces files atomically, so regeneration cannot write through those
274276links into signed resources. Windows uses hard links and falls back to normal caching when volumes
275277differ or resource permissions prevent linking. Protected installations therefore may not reuse
276- prepared bytecode. No cache bytes are copied during startup. AppImage backends discard their links
277- on normal exit because each mount changes module paths.
278+ prepared bytecode. No cache bytes are copied during startup.
278279
279280The key calculation follows Node's internal portable ESM format. Generation checks that the
280281packaged engine produced the expected CLI entry and fails the build if that format changes.
0 commit comments