mirror of
https://github.com/Pandipipas/scoreko-electron-dev.git
synced 2026-06-06 05:32:06 +00:00
Pandipipas
41e4e91c4b
- Update .gitignore and .prettierignore to exclude additional cache and configuration files. - Revise README.md for clarity on build processes and runtime behavior. - Improve architecture documentation to reflect changes in startup flow and module responsibilities. - Modify troubleshooting guide to address common runtime issues and installation steps. - Enhance ESLint configuration to ignore more directories. - Update package.json scripts for better build and distribution processes. - Introduce build-scoreko-bundle.mjs for building the Scoreko bundle. - Implement prepare-nodecg-runtime.mjs for managing NodeCG runtime installation and updates. - Add runtime-provisioner.ts to handle user-specific NodeCG runtime provisioning. - Create tests for runtime provisioning to ensure correct behavior. - Refactor process-manager.ts and main.ts to integrate new runtime management logic.
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
# Troubleshooting
|
|
|
|
## `The packaged NodeCG runtime is incomplete`
|
|
|
|
- Run `npm run prepare:runtime` from `scoreko-electron-dev`.
|
|
- If the parent bundle is not installed yet, run `pnpm install` from the repository root first.
|
|
|
|
## `NodeCG is present but internal dependencies are missing`
|
|
|
|
- Recreate the runtime with `npm run prepare:runtime`.
|
|
- If native SQLite errors appear during launch, run `npm run rebuild:native` before packaging.
|
|
|
|
## `No read/write permissions on NodeCG`
|
|
|
|
- Installed builds run NodeCG from the user's app data folder, so this usually means the local development copy is locked.
|
|
- Close any running Scoreko/NodeCG process and run `npm run start` again.
|
|
|
|
## `Port <PORT> is already in use`
|
|
|
|
- Free the port or set `NODECG_PORT` in `.env`.
|
|
- Use `npm run doctor` to validate availability before startup.
|
|
|
|
## `Timeout while waiting for NodeCG`
|
|
|
|
- Check the Electron/NodeCG output in the terminal.
|
|
- Increase `NODECG_STARTUP_TIMEOUT_MS` if the environment is slow.
|
|
- Recreate the runtime with `npm run prepare:runtime` if the bundle changed.
|
|
|
|
## macOS build fails because of icon
|
|
|
|
- The configuration expects `static/icons/icon.icns`.
|
|
- Create that file before running macOS packaging.
|