diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..ed02e20 --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,16 @@ +{ + "permissions": { + "allow": [ + "Bash(dir:*)", + "Bash(\"build/extraResources/jre/bin/java.exe\" -version)", + "Bash(npm run build-frontend:*)", + "Bash(taskkill:*)", + "Bash(iconv:*)", + "Bash(powershell:*)", + "Bash(del:*)", + "Bash(git -C \"c:\\code\\gitea\\NPQS-9100\\pqs-9100_client\" log -1 --oneline)" + ], + "deny": [], + "ask": [] + } +} diff --git a/build/NPQS9100.bat b/build/NPQS9100.bat new file mode 100644 index 0000000..7ee6675 --- /dev/null +++ b/build/NPQS9100.bat @@ -0,0 +1,18 @@ +@echo off +chcp 65001 >nul + +REM 获取当前批处理文件所在目录 +cd /d "%~dp0" + +REM 检查是否有管理员权限 +net session >nul 2>&1 +if %errorlevel% == 0 ( + REM 已有管理员权限，直接启动 + start "" "NPQS9100.exe" + exit +) else ( + REM 没有管理员权限，使用 PowerShell 以管理员身份启动（隐藏窗口） + powershell -WindowStyle Hidden -Command "Start-Process '%~dp0NPQS9100.exe' -Verb RunAs" + exit +) + diff --git a/build/README-升级回滚.txt b/build/README-升级回滚.txt new file mode 100644 index 0000000..c2dfac0 --- /dev/null +++ b/build/README-升级回滚.txt @@ -0,0 +1,46 @@ +======================================== +NPQS-9100 升级与回滚说明 +======================================== + +一、升级步骤（超简单！） +---------------------------------------- +1. 双击 upgrade.bat（首次会自动创建 upgrade 文件夹） +2. 将升级文件放入 upgrade/ 目录： + - app.asar （前端升级包 - 文件） + - app.asar.unpacked\ （前端升级包 - 文件夹） + - entrance.jar （后端升级包） +3. 再次双击 upgrade.bat 开始升级 +4. 等待完成后重启应用 + +二、回滚步骤 +---------------------------------------- +如果升级后出现问题： +1. 双击 rollback.bat +2. 选择是否回滚数据库（谨慎！） +3. 等待完成后重启应用 + +三、重要提示 +---------------------------------------- +✓ 升级前会自动备份到 backup/ 目录 +✓ 数据库会自动备份到 mysql/data_backup/ +✓ 升级日志保存在 logs/upgrade.log +✓ 多次升级时，backup/ 保存最后一次升级前的版本 + +四、紧急情况 +---------------------------------------- +如果脚本无法运行，请手动操作： + +【恢复前端】 +copy /Y backup\app.asar resources\app.asar +xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y + +【恢复后端】 +copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar + +【恢复数据库】（慎用！） +xcopy mysql\data_backup mysql\data\ /E /I /Y + +======================================== +详细文档请参考：doc/绿色包升级指南.md +======================================== + diff --git a/build/app.manifest b/build/app.manifest new file mode 100644 index 0000000..d45cca9 --- /dev/null +++ b/build/app.manifest @@ -0,0 +1,29 @@ + + + + NPQS-9100自动检测平台 + + + + + + + + + + + + + + + + + + + + diff --git a/build/build.bat b/build/build.bat new file mode 100644 index 0000000..3556ad8 --- /dev/null +++ b/build/build.bat @@ -0,0 +1,59 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo 清理并重新打包 +echo ======================================== +echo. + +echo [1/4] 删除 out 目录... +cd /d "%~dp0.." +if exist out ( + rmdir /s /q out 2>nul + if exist out ( + echo 删除失败，请手动删除 out 目录 + pause + exit /b 1 + ) else ( + echo out 目录已删除 + ) +) else ( + echo out 目录不存在 +) +echo. + +echo [2/4] 构建前端代码... +call npm run build-frontend +if %errorlevel% neq 0 ( + echo 前端构建失败 + pause + exit /b 1 +) +echo 前端代码构建完成 +echo. + +echo [3/4] 构建 electron 代码... +call npm run build-electron +if %errorlevel% neq 0 ( + echo electron 构建失败 + pause + exit /b 1 +) +echo electron 代码构建完成 +echo. + +echo [4/4] 打包 Windows 版本（包含代码加密）... +call npm run build-w +if %errorlevel% neq 0 ( + echo 打包失败 + pause + exit /b 1 +) +echo. + +echo ======================================== +echo 打包完成！ +echo 输出目录: out\win-unpacked\ +echo ======================================== +echo. +pause + diff --git a/build/clean-and-build.bat b/build/clean-and-build.bat index 2bd9ac8..39a3020 100644 --- a/build/clean-and-build.bat +++ b/build/clean-and-build.bat @@ -9,40 +9,6 @@ echo [1/5] 结束所有相关进程... echo 正在停止 NPQS9100... taskkill /F /IM NPQS9100.exe 2>nul -echo 正在停止 MySQL... -taskkill /F /IM mysqld.exe 2>nul -timeout /t 2 /nobreak >nul - -REM 验证 MySQL 是否真的停止了 -tasklist | find /I "mysqld.exe" >nul 2>&1 -if %errorlevel% equ 0 ( - echo ! MySQL 进程还在运行，再次尝试... - taskkill /F /IM mysqld.exe 2>nul - timeout /t 2 /nobreak >nul - - REM 再次验证 - tasklist | find /I "mysqld.exe" >nul 2>&1 - if %errorlevel% equ 0 ( - echo ! MySQL 进程仍在运行，使用强制方法... - REM 找出所有 mysqld.exe 的 PID 并逐个杀死 - for /f "tokens=2" %%a in ('tasklist ^| find /I "mysqld.exe"') do ( - echo 强制结束 PID: %%a - taskkill /F /PID %%a 2>nul - ) - timeout /t 2 /nobreak >nul - ) -) - -REM 最终验证 -tasklist | find /I "mysqld.exe" >nul 2>&1 -if %errorlevel% equ 0 ( - echo ✗ 警告：MySQL 进程可能仍在运行 - echo 请手动运行 build\extraResources\mysql\kill-running-port.bat - pause -) else ( - echo ✓ MySQL 已完全停止 -) - echo 正在停止 Java... taskkill /F /IM java.exe 2>nul taskkill /F /IM javaw.exe 2>nul @@ -101,4 +67,3 @@ echo 输出目录: out\win-unpacked\ echo ======================================== echo. pause - diff --git a/build/diagnose-startup.bat b/build/diagnose-startup.bat new file mode 100644 index 0000000..f02c786 --- /dev/null +++ b/build/diagnose-startup.bat @@ -0,0 +1,69 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo NPQS9100 启动诊断工具 +echo ======================================== +echo. + +echo [1] 检查运行中的进程... +echo. +echo NPQS9100 进程: +tasklist | findstr /i "NPQS9100.exe" +if %errorlevel% neq 0 echo 未找到 +echo. + +echo MySQL 进程: +tasklist | findstr /i "mysqld.exe" +if %errorlevel% neq 0 echo 未找到 +echo. + +echo Java 进程: +tasklist | findstr /i "java.exe" +if %errorlevel% neq 0 echo 未找到 +echo. + +echo [2] 检查端口占用... +echo. +echo 3306 端口: +netstat -ano | findstr ":3306" | findstr "LISTENING" +if %errorlevel% neq 0 echo 未占用 +echo. + +echo 18092 端口: +netstat -ano | findstr ":18092" | findstr "LISTENING" +if %errorlevel% neq 0 echo 未占用 +echo. + +echo 7777 端口: +netstat -ano | findstr ":7777" | findstr "LISTENING" +if %errorlevel% neq 0 echo 未占用 +echo. + +echo [3] 查看最新日志... +echo. +set LOGDIR=%APPDATA%\NQPS9100\logs +echo 日志目录: %LOGDIR% +if exist "%LOGDIR%" ( + echo. + echo 最新日志文件: + dir /b /o-d "%LOGDIR%\*.log" 2>nul + echo. +) else ( + echo 日志目录不存在 +) +echo. + +echo [4] 检查 MySQL 服务... +sc query mysql9100 >nul 2>&1 +if %errorlevel% equ 0 ( + echo MySQL 服务存在 + sc query mysql9100 | findstr "STATE" +) else ( + echo MySQL 服务不存在 +) +echo. + +echo ======================================== +echo 诊断完成 +echo ======================================== +pause diff --git a/build/extraResources/dll/myDllDemo.dll b/build/extraResources/dll/myDllDemo.dll deleted file mode 100644 index ffd5446..0000000 Binary files a/build/extraResources/dll/myDllDemo.dll and /dev/null differ diff --git a/build/extraResources/java/.gitignore b/build/extraResources/java/.gitignore deleted file mode 100644 index 70572cc..0000000 --- a/build/extraResources/java/.gitignore +++ /dev/null @@ -1,10 +0,0 @@ -# 自动生成的配置文件 -application.yml - -# 运行时端口记录 -.running-port - -# 日志文件 -logs/ -*.log - diff --git a/build/extraResources/java/README.txt b/build/extraResources/java/README.txt index da00319..96a5cb1 100644 --- a/build/extraResources/java/README.txt +++ b/build/extraResources/java/README.txt @@ -1,71 +1,20 @@ ========================================== - NPQS9100 Java 后端服务说明 + NPQS9100 Java 后端服务 ========================================== -一、目录结构 +目录说明 ---------------------------------------- entrance.jar - Spring Boot 应用程序 application.yml - 应用配置文件（自动生成） application.yml.template - 配置模板 -kill-java-port.bat - 智能清理Java端口占用（紧急用） -.running-port - 运行时端口记录（自动生成，勿删除） -二、自动管理 +服务管理 ---------------------------------------- -正常情况下，Java 后端服务由主应用自动管理： -- 应用启动时自动启动 Java 服务 -- 应用关闭时自动停止 Java 服务 -- 无需手动操作 - - -三、端口智能管理 ----------------------------------------- -- Java 服务默认使用端口：18092 -- 如果 18092 被占用，自动尝试：18093, 18094, ... -- 启动成功后会记录实际端口到 .running-port 文件 -- kill-java-port.bat 会自动识别正确的端口进行清理 - - -四、手动清理工具 ----------------------------------------- -如果应用异常退出，Java 进程可能残留，导致： -- 端口被占用，无法再次启动 -- 可以运行 kill-java-port.bat 清理残留进程 - -使用方法： -1. 双击运行：kill-java-port.bat -2. 脚本会自动识别实际使用的端口 -3. 清理完成后即可重新启动应用 - - -五、安全说明 ----------------------------------------- -⚠️ 进程停止安全性： -- 应用自动停止时，只会停止应用自己启动的 Java 进程 -- 通过进程引用精确停止，不会影响其他 Java 应用 -- kill-java-port.bat 只清理占用特定端口的进程 -- 完全不会影响您电脑上的其他 Java 程序 - -⭐ 端口冲突处理： -- 如果您的电脑上有其他应用占用了 18092 端口 -- 本应用会自动切换到其他端口（18093, 18094...） -- kill-java-port.bat 会自动识别实际端口，精确清理 - - -六、常见问题 ----------------------------------------- -Q: Java 服务无法启动？ -A: 运行 kill-java-port.bat 清理残留进程 - -Q: 端口被占用怎么办？ -A: 应用会自动切换端口，无需手动处理 - -Q: 如何查看 Java 日志？ -A: 启动应用后，日志窗口会实时显示 Java 输出 - -Q: 配置文件在哪里？ -A: application.yml 由应用自动生成，请勿手动修改 +Java 后端服务由主应用自动管理： +- 应用启动时自动启动 +- 应用关闭时自动停止 +- 默认端口：18092（如被占用会自动切换） ========================================== diff --git a/build/extraResources/java/entrance.jar b/build/extraResources/java/entrance.jar index 4dd6ea9..0ce735f 100644 Binary files a/build/extraResources/java/entrance.jar and b/build/extraResources/java/entrance.jar differ diff --git a/build/extraResources/java/kill-java-port.bat b/build/extraResources/java/kill-java-port.bat deleted file mode 100644 index b96b371..0000000 --- a/build/extraResources/java/kill-java-port.bat +++ /dev/null @@ -1,115 +0,0 @@ -@echo off -chcp 65001 >nul -color 0E -title 清理NPQS9100 Java端口占用 -cls -echo ========================================== -echo 清理 NPQS9100 Java 端口占用 -echo ========================================== -echo. - -REM 获取Java目录（脚本所在目录） -set JAVA_HOME=%~dp0 -cd /d "%JAVA_HOME%" - -REM 读取实际运行的端口 -set PORT_FILE=.running-port -set JAVA_PORT= - -if exist "%PORT_FILE%" ( - set /p JAVA_PORT=<"%PORT_FILE%" - echo [√] 检测到运行记录：端口 %JAVA_PORT% - echo. -) else ( - echo [!] 未找到运行记录文件，使用默认端口 18092 - echo. - set JAVA_PORT=18092 -) - -echo [1] 检查端口 %JAVA_PORT% 占用情况... -echo. - -REM 查找占用该端口的连接 -netstat -ano | findstr ":%JAVA_PORT%" > "%TEMP%\java_port.txt" - -if %errorlevel% equ 0 ( - echo 发现以下端口 %JAVA_PORT% 连接： - echo ---------------------------------------- - type "%TEMP%\java_port.txt" - echo ---------------------------------------- - echo. - - echo [2] 提取进程ID并结束进程... - echo. - - REM 提取所有LISTENING状态的PID - for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%JAVA_PORT%" ^| findstr "LISTENING"') do ( - if not "%%a"=="0" ( - echo 正在结束进程 PID: %%a - taskkill /F /PID %%a 2>nul - if errorlevel 1 ( - echo [失败] 无法结束进程 %%a - ) else ( - echo [成功] 已结束进程 %%a - ) - ) - ) - - REM 如果还有其他状态的连接，也尝试结束 - for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%JAVA_PORT%" ^| findstr /V "LISTENING"') do ( - if not "%%a"=="0" ( - echo 正在结束进程 PID: %%a - taskkill /F /PID %%a 2>nul - if errorlevel 1 ( - echo [已结束或无权限] 进程 %%a - ) else ( - echo [成功] 已结束进程 %%a - ) - ) - ) - - echo. - echo [3] 清理完成 - - REM 等待2秒让进程完全释放 - timeout /t 2 /nobreak >nul - - echo. - echo [4] 再次检查端口 %JAVA_PORT%... - netstat -ano | findstr ":%JAVA_PORT%" - if errorlevel 1 ( - echo [√] 端口 %JAVA_PORT% 已完全释放 - - REM 删除端口记录文件 - if exist "%PORT_FILE%" ( - del "%PORT_FILE%" - echo [√] 已清理端口记录文件 - ) - ) else ( - echo [!] 仍有连接存在（可能是TIME_WAIT状态，会自动释放） - ) - -) else ( - echo [√] 没有发现占用端口 %JAVA_PORT% 的进程 - - REM 删除端口记录文件 - if exist "%PORT_FILE%" ( - del "%PORT_FILE%" - echo [√] 已清理端口记录文件 - ) -) - -REM 清理临时文件 -if exist "%TEMP%\java_port.txt" del "%TEMP%\java_port.txt" - -echo. -echo ========================================== -echo 清理完成 -echo ========================================== -echo. -echo 说明： -echo - 此脚本只清理 NPQS9100 应用使用的 Java 端口 -echo - 不会影响您电脑上的其他 Java 应用 -echo. -pause - diff --git a/build/extraResources/mysql/README.txt b/build/extraResources/mysql/README.txt index a1eaaeb..0bb5d53 100644 --- a/build/extraResources/mysql/README.txt +++ b/build/extraResources/mysql/README.txt @@ -1,85 +1,33 @@ ========================================== - NPQS9100 MySQL 免安装版使用说明 + NPQS9100 MySQL 数据库 ========================================== -一、快速开始 +目录说明 ---------------------------------------- -1. 启动 MySQL: - 双击运行: startup.bat - (注意：不要关闭窗口，关闭会停止MySQL) - -2. 首次使用，如需重置密码和权限: - 双击运行: reset-root-password.bat - -3. 停止 MySQL: - 双击运行: stop.bat +bin/ - MySQL 可执行文件 +data/ - 数据库数据目录 +share/ - 共享资源文件 +my.ini - MySQL 配置文件 -二、连接信息 +服务管理 ---------------------------------------- -主机: 127.0.0.1 (或 localhost) +MySQL 服务由主应用自动管理： +- 应用启动时自动启动 +- 应用关闭时自动停止 +- 默认端口：3306（如被占用会自动切换） + + +连接信息 +---------------------------------------- +主机: 127.0.0.1 端口: 3306 用户: root 密码: njcnpqs 字符集: utf8mb4 -三、脚本说明 ----------------------------------------- -startup.bat - 启动 MySQL 服务 -stop.bat - 正常停止 MySQL 服务 -reset-root-password.bat - 重置root密码和权限（解决1130错误） -kill-running-port.bat - 智能清理应用实际使用的端口（自动识别3306/3307/...） -my.ini - MySQL 配置文件 -.running-port - 运行时端口记录（自动生成，勿删除） - -bin/ - MySQL 可执行文件 -data/ - 数据库数据目录 -share/ - 共享资源 - -⚠️ 安全说明： -- 应用自动停止MySQL时，只会停止应用自己启动的MySQL进程 -- 不会影响您电脑上安装的其他MySQL服务 -- kill-running-port.bat 会读取 .running-port 文件，精确清理实际使用的端口 -- 如果3306被占用，应用会自动使用3307，kill-running-port.bat 会智能识别 - -⚙️ 停止机制： -- 应用关闭时会自动使用 mysqladmin shutdown 优雅停止MySQL -- 如果优雅停止失败，会自动尝试强制停止 -- 整个停止过程最多12秒，确保MySQL完全关闭 - -⭐ 端口智能管理： -- 应用启动时自动检测可用端口（3306 → 3307 → 3308...） -- 启动成功后会记录实际端口到 .running-port 文件 -- 使用 kill-running-port.bat 可自动清理正确的端口 - - -四、注意事项 ----------------------------------------- -1. 启动后不要关闭命令行窗口，关闭窗口会停止 MySQL -2. 正常停止请使用 stop.bat -3. 如果出现 1130 或密码错误，运行 reset-root-password.bat -4. 如果端口被占用无法启动，运行 kill-3306.bat -5. 默认密码是 njcnpqs，不要随意修改 - - -五、常见问题 ----------------------------------------- -Q: 连接提示 1130 错误或密码错误？ -A: 运行 reset-root-password.bat 重置权限 - -Q: 启动失败或端口被占用？ -A: 运行 kill-running-port.bat 清理端口（自动识别正确端口） - -Q: 如何重置密码？ -A: 运行 reset-root-password.bat（密码会重置为 njcnpqs） - -Q: 数据在哪里？ -A: 所有数据库数据在 data/ 目录下 - - ========================================== 南京灿能电气自动化有限公司 2025 ========================================== - diff --git a/build/extraResources/mysql/init_pwd.bat b/build/extraResources/mysql/init_pwd.bat new file mode 100644 index 0000000..d20bbb4 --- /dev/null +++ b/build/extraResources/mysql/init_pwd.bat @@ -0,0 +1,34 @@ +@echo off +chcp 65001 >nul +cd /d %~dp0 + +taskkill /F /IM mysqld.exe 2>nul +timeout /t 2 /nobreak >nul + +rmdir /s /q data 2>nul +mkdir data + +echo 初始化数据库... +bin\mysqld.exe --defaults-file=my.ini --initialize-insecure --console + +echo 启动 MySQL... +start /B bin\mysqld.exe --defaults-file=my.ini +timeout /t 8 /nobreak >nul + +echo 设置密码... +bin\mysql.exe -h 127.0.0.1 -P 3306 -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'njcnpqs'; CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY 'njcnpqs'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; FLUSH PRIVILEGES;" + +if %errorlevel% NEQ 0 ( + echo 第一次失败，重试... + timeout /t 3 /nobreak >nul + bin\mysql.exe -h localhost -P 3306 -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'njcnpqs'; CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY 'njcnpqs'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; FLUSH PRIVILEGES;" +) + +taskkill /F /IM mysqld.exe 2>nul + +echo. +echo ========================================== +echo 完成！密码: njcnpqs +echo ========================================== +pause + diff --git a/build/extraResources/mysql/kill-running-port.bat b/build/extraResources/mysql/kill-running-port.bat deleted file mode 100644 index 25c70a3..0000000 --- a/build/extraResources/mysql/kill-running-port.bat +++ /dev/null @@ -1,115 +0,0 @@ -@echo off -chcp 65001 >nul -color 0C -title 清理NPQS9100 MySQL端口占用 -cls -echo ========================================== -echo 清理 NPQS9100 MySQL 端口占用 -echo ========================================== -echo. - -REM 获取MySQL目录（脚本所在目录） -set MYSQL_HOME=%~dp0 -cd /d "%MYSQL_HOME%" - -REM 读取实际运行的端口 -set PORT_FILE=.running-port -set MYSQL_PORT= - -if exist "%PORT_FILE%" ( - set /p MYSQL_PORT=<"%PORT_FILE%" - echo [√] 检测到运行记录：端口 %MYSQL_PORT% - echo. -) else ( - echo [!] 未找到运行记录文件，使用默认端口 3306 - echo. - set MYSQL_PORT=3306 -) - -echo [1] 检查端口 %MYSQL_PORT% 占用情况... -echo. - -REM 查找占用该端口的连接 -netstat -ano | findstr ":%MYSQL_PORT%" > "%TEMP%\mysql_port.txt" - -if %errorlevel% equ 0 ( - echo 发现以下端口 %MYSQL_PORT% 连接： - echo ---------------------------------------- - type "%TEMP%\mysql_port.txt" - echo ---------------------------------------- - echo. - - echo [2] 提取进程ID并结束进程... - echo. - - REM 提取所有LISTENING状态的PID - for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%MYSQL_PORT%" ^| findstr "LISTENING"') do ( - if not "%%a"=="0" ( - echo 正在结束进程 PID: %%a - taskkill /F /PID %%a 2>nul - if errorlevel 1 ( - echo [失败] 无法结束进程 %%a - ) else ( - echo [成功] 已结束进程 %%a - ) - ) - ) - - REM 如果还有其他状态的连接，也尝试结束 - for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%MYSQL_PORT%" ^| findstr /V "LISTENING"') do ( - if not "%%a"=="0" ( - echo 正在结束进程 PID: %%a - taskkill /F /PID %%a 2>nul - if errorlevel 1 ( - echo [已结束或无权限] 进程 %%a - ) else ( - echo [成功] 已结束进程 %%a - ) - ) - ) - - echo. - echo [3] 清理完成 - - REM 等待2秒让进程完全释放 - timeout /t 2 /nobreak >nul - - echo. - echo [4] 再次检查端口 %MYSQL_PORT%... - netstat -ano | findstr ":%MYSQL_PORT%" - if errorlevel 1 ( - echo [√] 端口 %MYSQL_PORT% 已完全释放 - - REM 删除端口记录文件 - if exist "%PORT_FILE%" ( - del "%PORT_FILE%" - echo [√] 已清理端口记录文件 - ) - ) else ( - echo [!] 仍有连接存在（可能是TIME_WAIT状态，会自动释放） - ) - -) else ( - echo [√] 没有发现占用端口 %MYSQL_PORT% 的进程 - - REM 删除端口记录文件 - if exist "%PORT_FILE%" ( - del "%PORT_FILE%" - echo [√] 已清理端口记录文件 - ) -) - -REM 清理临时文件 -if exist "%TEMP%\mysql_port.txt" del "%TEMP%\mysql_port.txt" - -echo. -echo ========================================== -echo 清理完成 -echo ========================================== -echo. -echo 说明： -echo - 此脚本只清理 NPQS9100 应用使用的 MySQL 端口 -echo - 不会影响您电脑上的其他 MySQL 服务 -echo. -pause - diff --git a/build/extraResources/mysql/reset-init.sql b/build/extraResources/mysql/reset-init.sql deleted file mode 100644 index 8fb7075..0000000 --- a/build/extraResources/mysql/reset-init.sql +++ /dev/null @@ -1,6 +0,0 @@ -ALTER USER IF EXISTS 'root'@'localhost' IDENTIFIED BY 'njcnpqs'; -CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY 'njcnpqs'; -GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; -CREATE USER IF NOT EXISTS 'root'@'%' IDENTIFIED BY 'njcnpqs'; -GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; -FLUSH PRIVILEGES; diff --git a/build/extraResources/mysql/reset-root-password.bat b/build/extraResources/mysql/reset-root-password.bat deleted file mode 100644 index e36bdfe..0000000 --- a/build/extraResources/mysql/reset-root-password.bat +++ /dev/null @@ -1,66 +0,0 @@ -@echo off -chcp 65001 >nul -color 0B -title Reset MySQL Root Password -cls -echo ========================================== -echo Reset MySQL Root Password -echo ========================================== -echo. -echo This script will reset root password and grant 127.0.0.1 access -echo. -echo IMPORTANT: Close any running MySQL windows first! -echo. -pause - -set MYSQL_HOME=%cd% -set password=njcnpqs - -echo. -echo [1] Stopping MySQL... -taskkill /F /IM mysqld.exe >nul 2>&1 -timeout /t 2 >nul -echo Done. - -echo. -echo [2] Creating init file... -( -echo ALTER USER IF EXISTS 'root'@'localhost' IDENTIFIED BY '%password%'; -echo CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY '%password%'; -echo GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; -echo CREATE USER IF NOT EXISTS 'root'@'%%' IDENTIFIED BY '%password%'; -echo GRANT ALL PRIVILEGES ON *.* TO 'root'@'%%' WITH GRANT OPTION; -echo FLUSH PRIVILEGES; -) > "%MYSQL_HOME%\reset-init.sql" -echo Done. - -echo. -echo [3] Starting MySQL with init-file... -echo This will take about 30 seconds... -echo. - -cd /d "%MYSQL_HOME%" -"%MYSQL_HOME%\bin\mysqld.exe" --defaults-file="%MYSQL_HOME%\my.ini" --init-file="%MYSQL_HOME%\reset-init.sql" --console - -REM The above command runs in foreground and will exit when you press Ctrl+C - -echo. -echo MySQL has stopped. -echo. -if exist "%MYSQL_HOME%\reset-init.sql" del "%MYSQL_HOME%\reset-init.sql" - -echo. -echo ========================================== -echo Password reset completed! -echo ========================================== -echo. -echo Connection info: -echo Host: 127.0.0.1 -echo Port: 3306 -echo User: root -echo Password: %password% -echo. -echo Now you can run startup.bat to start MySQL normally -echo. -pause - diff --git a/build/icons/icon-original-backup.png b/build/icons/icon-original-backup.png new file mode 100644 index 0000000..802a3e1 Binary files /dev/null and b/build/icons/icon-original-backup.png differ diff --git a/build/icons/icon-square-256.png b/build/icons/icon-square-256.png new file mode 100644 index 0000000..dd02cdb Binary files /dev/null and b/build/icons/icon-square-256.png differ diff --git a/build/icons/icon-square-512.png b/build/icons/icon-square-512.png new file mode 100644 index 0000000..a9a59e4 Binary files /dev/null and b/build/icons/icon-square-512.png differ diff --git a/build/icons/icon.png b/build/icons/icon.png index 802a3e1..dd02cdb 100644 Binary files a/build/icons/icon.png and b/build/icons/icon.png differ diff --git a/build/remove-mysql-service.bat b/build/remove-mysql-service.bat new file mode 100644 index 0000000..4775b5e --- /dev/null +++ b/build/remove-mysql-service.bat @@ -0,0 +1,81 @@ +@echo off +chcp 65001 >nul +title 检查并清除 MySQL9100 服务 +color 0E + +echo ======================================== +echo 检查并清除 MySQL9100 服务 +echo ======================================== +echo. + +REM 检查是否有管理员权限 +net session >nul 2>&1 +if %errorlevel% neq 0 ( + echo [错误] 需要管理员权限来操作 Windows 服务 + echo. + echo 请右键点击此脚本，选择"以管理员身份运行" + echo. + pause + exit /b 1 +) + +echo [✓] 已具有管理员权限 +echo. + +REM 检查服务是否存在 +echo [1/4] 检查 mysql9100 服务是否存在... +sc query mysql9100 >nul 2>&1 +if %errorlevel% equ 0 ( + echo [✓] 发现 mysql9100 服务 + echo. + + REM 显示服务状态 + echo [2/4] 服务状态信息: + sc query mysql9100 + echo. + + REM 停止服务 + echo [3/4] 正在停止 mysql9100 服务... + sc stop mysql9100 >nul 2>&1 + if %errorlevel% equ 0 ( + echo [✓] 服务已停止 + ) else ( + echo [!] 服务可能已经停止或停止失败（继续删除） + ) + + REM 等待服务完全停止 + timeout /t 2 /nobreak >nul + echo. + + REM 删除服务 + echo [4/4] 正在删除 mysql9100 服务... + sc delete mysql9100 + if %errorlevel% equ 0 ( + echo [✓] 服务已成功删除 + echo. + echo ======================================== + echo 清除完成！ + echo ======================================== + ) else ( + echo [✗] 删除服务失败 + echo. + echo 可能的原因： + echo 1. 服务仍在运行中（请重启电脑后重试） + echo 2. 权限不足 + echo 3. 服务被其他程序锁定 + echo. + pause + exit /b 1 + ) +) else ( + echo [!] 未发现 mysql9100 服务 + echo. + echo 系统中没有名为 mysql9100 的服务，无需清除。 +) + +echo. +echo 提示：如果需要完全清理，还可以： +echo 1. 删除 MySQL 数据目录（mysql/data） +echo 2. 删除 MySQL 配置文件（mysql/my.ini） +echo. +pause diff --git a/build/rollback.bat b/build/rollback.bat new file mode 100644 index 0000000..b164571 --- /dev/null +++ b/build/rollback.bat @@ -0,0 +1,143 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo NPQS9100 回滚工具 +echo ======================================== +echo. +echo 【重要提示】 +echo 本工具用于回滚上次升级的内容 +echo 回滚后将恢复到升级前的状态 +echo. +pause +echo. + +echo [1/5] 停止 NPQS9100 进程... +taskkill /F /IM NPQS9100.exe 2>nul +if %errorlevel% equ 0 ( + echo NPQS9100 已停止 + timeout /t 2 /nobreak >nul +) else ( + echo NPQS9100 未运行 +) +echo. + +echo [2/5] 检查备份文件... +set hasBackup=0 + +if exist backup\app.asar ( + echo 发现前端备份（app.asar） + set hasBackup=1 +) + +if exist backup\app.asar.unpacked ( + echo 发现前端备份（app.asar.unpacked） + set hasBackup=1 +) + +if exist backup\entrance.jar ( + echo 发现后端备份 + set hasBackup=1 +) + +if exist mysql\data_backup ( + echo 发现数据库备份 + set hasBackup=1 +) + +if %hasBackup%==0 ( + echo 未发现任何备份文件！ + echo 无法执行回滚操作 + pause + exit /b 1 +) +echo. + +echo [3/5] 回滚前端... +set frontendRollback=0 + +REM 回滚 app.asar +if exist backup\app.asar ( + echo 正在恢复 app.asar... + copy /Y backup\app.asar resources\app.asar >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar 已回滚 + set frontendRollback=1 + ) else ( + echo app.asar 回滚失败 + pause + exit /b 1 + ) +) + +REM 回滚 app.asar.unpacked +if exist backup\app.asar.unpacked ( + echo 正在恢复 app.asar.unpacked... + if exist resources\app.asar.unpacked ( + rmdir /s /q resources\app.asar.unpacked 2>nul + ) + xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar.unpacked 已回滚 + set frontendRollback=1 + ) else ( + echo app.asar.unpacked 回滚失败 + pause + exit /b 1 + ) +) + +if %frontendRollback%==0 ( + echo 无前端备份，跳过 +) +echo. + +echo [4/5] 回滚后端... +if exist backup\entrance.jar ( + echo 正在恢复 JAR 文件... + copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1 + if %errorlevel% equ 0 ( + echo 后端已回滚 + ) else ( + echo 后端回滚失败 + pause + exit /b 1 + ) +) else ( + echo 无后端备份，跳过 +) +echo. + +echo [5/5] 回滚数据库... +if exist mysql\data_backup ( + echo 是否回滚数据库？（数据库回滚会丢失升级后的数据！） + echo [Y] 是 [N] 否 + choice /C YN /N /M "请选择：" + if errorlevel 2 ( + echo 已跳过数据库回滚 + ) else ( + echo 正在回滚数据库... + if exist mysql\data ( + rmdir /s /q mysql\data 2>nul + ) + xcopy mysql\data_backup mysql\data\ /E /I /Y /Q >nul 2>&1 + if %errorlevel% equ 0 ( + echo 数据库已回滚 + ) else ( + echo 数据库回滚失败 + pause + exit /b 1 + ) + ) +) else ( + echo 无数据库备份，跳过 +) +echo. + +echo ======================================== +echo 回滚完成！ +echo ======================================== +echo. +echo 您现在可以启动 NPQS9100 了 +echo. +pause + diff --git a/build/upgrade.bat b/build/upgrade.bat new file mode 100644 index 0000000..ebe79c4 --- /dev/null +++ b/build/upgrade.bat @@ -0,0 +1,227 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo NPQS9100 升级工具 +echo ======================================== +echo. + +REM 检查并创建 upgrade 目录 +if not exist upgrade ( + mkdir upgrade + echo 【首次使用】已自动创建 upgrade 目录 + echo. + echo 请将升级文件放入 upgrade 目录： + echo - app.asar （前端升级包 - 文件） + echo - app.asar.unpacked\ （前端升级包 - 文件夹） + echo - entrance.jar （后端升级包） + echo. + echo 放置完成后，重新运行本脚本即可升级 + echo. + pause + exit /b 0 +) + +REM 检查是否有升级文件 +set hasUpgrade=0 +if exist upgrade\app.asar set hasUpgrade=1 +if exist upgrade\app.asar.unpacked set hasUpgrade=1 +if exist upgrade\entrance.jar set hasUpgrade=1 + +if %hasUpgrade%==0 ( + echo 【提示】upgrade 目录为空！ + echo. + echo 请将升级文件放入 upgrade 目录： + echo - app.asar （前端升级包 - 文件） + echo - app.asar.unpacked\ （前端升级包 - 文件夹） + echo - entrance.jar （后端升级包） + echo. + echo 放置完成后，重新运行本脚本即可升级 + echo. + pause + exit /b 0 +) + +echo 【检测到升级文件】 +if exist upgrade\app.asar echo - 前端升级（asar文件）： upgrade\app.asar +if exist upgrade\app.asar.unpacked echo - 前端升级（unpacked文件夹）： upgrade\app.asar.unpacked\ +if exist upgrade\entrance.jar echo - 后端升级： upgrade\entrance.jar +echo. +echo 【重要提示】 +echo 1. 升级前会自动备份当前版本 +echo 2. 如升级失败可运行 rollback.bat 回滚 +echo 3. 数据库会自动备份到 mysql\data_backup\ +echo. +pause +echo. + +echo [1/6] 停止 NPQS9100 进程... +taskkill /F /IM NPQS9100.exe 2>nul +if %errorlevel% equ 0 ( + echo NPQS9100 已停止 + timeout /t 2 /nobreak >nul +) else ( + echo NPQS9100 未运行 +) +echo. + +echo [2/6] 备份当前版本（用于回滚）... +if not exist backup mkdir backup + +REM 备份前端（app.asar 和 app.asar.unpacked） +if exist resources\app.asar ( + echo 正在备份前端 app.asar... + if not exist backup mkdir backup + copy /Y resources\app.asar backup\app.asar >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar 备份完成 + ) else ( + echo app.asar 备份失败 + ) +) + +if exist resources\app.asar.unpacked ( + echo 正在备份前端 app.asar.unpacked... + if exist backup\app.asar.unpacked ( + rmdir /s /q backup\app.asar.unpacked 2>nul + ) + xcopy resources\app.asar.unpacked backup\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar.unpacked 备份完成 + ) else ( + echo app.asar.unpacked 备份失败 + ) +) + +REM 备份后端 +if exist resources\extraResources\java\entrance.jar ( + echo 正在备份后端... + copy /Y resources\extraResources\java\entrance.jar backup\entrance.jar >nul 2>&1 + if %errorlevel% equ 0 ( + echo 后端备份完成 + ) else ( + echo 后端备份失败 + ) +) + +REM 备份数据库 +if exist mysql\data ( + echo 正在备份数据库... + if exist mysql\data_backup ( + rmdir /s /q mysql\data_backup 2>nul + ) + xcopy mysql\data mysql\data_backup\ /E /I /Y /Q >nul 2>&1 + if %errorlevel% equ 0 ( + echo 数据库备份完成 + ) else ( + echo 数据库备份失败，请手动备份后继续 + pause + exit /b 1 + ) +) +echo. + +echo [3/6] 记录版本信息... +if not exist backup\version.txt ( + echo 备份时间: %date% %time% > backup\version.txt + echo 升级前版本备份 >> backup\version.txt +) else ( + echo 上次备份时间: %date% %time% >> backup\version.txt +) +echo 版本信息已记录 +echo. + +echo [4/6] 升级前端... +set frontendUpgraded=0 + +REM 升级 app.asar +if exist upgrade\app.asar ( + echo 正在替换 app.asar... + copy /Y upgrade\app.asar resources\app.asar >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar 升级完成 + set frontendUpgraded=1 + ) else ( + echo app.asar 升级失败，正在回滚... + if exist backup\app.asar ( + copy /Y backup\app.asar resources\app.asar >nul 2>&1 + echo 已回滚到升级前版本 + ) + pause + exit /b 1 + ) +) + +REM 升级 app.asar.unpacked +if exist upgrade\app.asar.unpacked ( + echo 正在替换 app.asar.unpacked... + if exist resources\app.asar.unpacked ( + rmdir /s /q resources\app.asar.unpacked 2>nul + ) + xcopy upgrade\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1 + if %errorlevel% equ 0 ( + echo app.asar.unpacked 升级完成 + set frontendUpgraded=1 + ) else ( + echo app.asar.unpacked 升级失败，正在回滚... + if exist backup\app.asar.unpacked ( + rmdir /s /q resources\app.asar.unpacked 2>nul + xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1 + echo 已回滚到升级前版本 + ) + pause + exit /b 1 + ) +) + +if %frontendUpgraded%==0 ( + echo 无前端升级包，跳过 +) +echo. + +echo [5/6] 升级后端... +if exist upgrade\entrance.jar ( + echo 正在替换 JAR 文件... + copy /Y upgrade\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1 + if %errorlevel% equ 0 ( + echo 后端升级完成 + ) else ( + echo 后端升级失败，正在回滚... + if exist backup\entrance.jar ( + copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1 + echo 已回滚到升级前版本 + ) + pause + exit /b 1 + ) +) else ( + echo 无后端升级包，跳过 +) +echo. + +echo [6/6] 记录升级日志... +if not exist logs mkdir logs +echo ========================================== >> logs\upgrade.log +echo 升级时间: %date% %time% >> logs\upgrade.log +if exist upgrade\dist ( + echo 升级内容: 前端 >> logs\upgrade.log +) +if exist upgrade\entrance.jar ( + echo 升级内容: 后端 >> logs\upgrade.log +) +echo ========================================== >> logs\upgrade.log +echo 升级日志已记录 +echo. + +echo ======================================== +echo 升级完成！ +echo ======================================== +echo. +echo 【提示】 +echo 1. 如需回滚，请运行 rollback.bat +echo 2. 升级文件已使用，可删除 upgrade 目录 +echo. +echo 您现在可以启动 NPQS9100 应用。 +echo. +pause + + diff --git a/cmd/builder.json b/cmd/builder.json index 7d7581b..8e161e5 100644 --- a/cmd/builder.json +++ b/cmd/builder.json @@ -35,6 +35,10 @@ "from": "build/extraResources/read.txt", "to": "extraResources/read.txt" }, + { + "from": "build/extraResources/使用说明.txt", + "to": "extraResources/使用说明.txt" + }, { "from": "scripts/", "to": "scripts", @@ -51,9 +55,33 @@ "from": "build/extraResources/jre", "to": "jre", "filter": ["**/*"] + }, + { + "from": "build/NPQS9100.bat", + "to": "NPQS9100.bat" + }, + { + "from": "build/extraResources/使用说明.txt", + "to": "使用说明.txt" + }, + { + "from": "build/upgrade.bat", + "to": "upgrade.bat" + }, + { + "from": "build/rollback.bat", + "to": "rollback.bat" + }, + { + "from": "build/README-升级回滚.txt", + "to": "README-升级回滚.txt" } ], "win": { + "icon": "public/images/icon.png", + "requestedExecutionLevel": "requireAdministrator", + "signAndEditExecutable": false, + "verifyUpdateCodeSignature": false, "artifactName": "${productName}-${os}-${version}-${arch}.${ext}", "target": [ { @@ -63,4 +91,4 @@ ] }, "compression": "store" -} \ No newline at end of file +} diff --git a/doc/NPQS-9100绿色包完整指南.md b/doc/NPQS-9100绿色包完整指南.md new file mode 100644 index 0000000..5a246ee --- /dev/null +++ b/doc/NPQS-9100绿色包完整指南.md @@ -0,0 +1,874 @@ +# NPQS-9100 绿色包完整指南 + +本指南包含绿色包的打包、使用、升级和维护的完整说明。 + +--- + +## 📋 目录 + +- [一、产品说明](#一产品说明) +- [七、用户关心的文件](#七用户关心的文件重要)⭐ +- [二、打包指南](#二打包指南) +- [三、启动流程](#三启动流程) +- [四、升级指南](#四升级指南) +- [五、测试清单](#五测试清单) +- [六、常见问题](#六常见问题) + +--- + +## 一、产品说明 + +### 📦 产品特性 + +绿色包是一个**免安装便携版**，包含： +- ✅ 应用本体（Electron + Vue 3） +- ✅ MySQL 数据库（免安装版，支持动态端口） +- ✅ Java 运行环境（JRE 8） +- ✅ Spring Boot 后端服务（entrance.jar） +- ✅ 智能启动流程（端口检测、Loading界面） +- ✅ **一键升级回滚机制** ⭐ + +**用户体验**：解压即用，双击启动，无需任何配置 + +--- + +### 🎯 核心功能 + +#### **1. 智能端口检测** +- MySQL 端口：从 3306 开始自动检测（最多 100 个） +- Java 端口：从 18092 开始自动检测（最多 100 个） +- 自动更新配置文件 + +#### **2. 盘符自动识别** +- 应用在 C 盘 → 数据目录：`C:\NPQS9100_Data\` +- 应用在 D 盘 → 数据目录：`D:\NPQS9100_Data\` +- 自动创建所有必要的子目录 + +#### **3. Loading 界面** +- 紫色渐变背景 +- 流畅的进度条动画（0% → 100%） +- 实时状态文字更新 +- 显示检测到的端口号和数据目录路径 + +#### **4. 热更新机制** ⭐ +- 前端可独立升级 +- 后端可独立升级 +- 自动备份，支持一键回滚 +- 数据库数据完全保留 + +#### **5. 简化配置管理** +- 基于环境变量的配置方案 +- 需要修改配置时重新打包前端（upgrade.bat 升级） +- 保证稳定性和可靠性 + +--- + +### 📁 目录结构 + +``` +win-unpacked/ # 绿色版目录（约 650-800 MB） +├── NPQS9100.exe # 主程序（双击运行）⭐ +├── NPQS9100-启动器.bat # 管理员启动器（备用） +├── upgrade.bat # 升级工具 ⭐ +├── rollback.bat # 回滚工具 ⭐ +├── uninstall-mysql-service.bat # MySQL 服务卸载工具 +├── 使用说明.txt # 使用手册 +├── README-升级回滚.txt # 升级说明 +├── upgrade/ # 升级包目录（首次使用自动创建） +├── backup/ # 自动备份目录 +│ ├── dist/ # 前端备份 +│ ├── entrance.jar # 后端备份 +│ └── version.txt # 版本记录 +├── resources/ +│ ├── app.asar # Electron 主代码（加密） +│ ├── app.asar.unpacked/ +│ │ └── public/ +│ │ └── dist/ # 前端代码 ⭐ 可替换 +│ └── extraResources/ +│ ├── dll/ +│ └── java/ +│ ├── entrance.jar # 后端 JAR ⭐ 可替换 +│ ├── application.yml.template +│ └── application.yml # 运行时生成 +├── scripts/ # 启动管理脚本（⚠️ 不要修改） +│ ├── config-generator.js +│ ├── java-runner.js +│ ├── mysql-service-manager.js +│ ├── port-checker.js +│ └── startup-manager.js +├── mysql/ # MySQL 数据库 +│ ├── bin/ +│ ├── data/ # 数据库数据 ⚠️ 不要动 +│ ├── data_backup/ # 自动备份 +│ ├── my.ini # 运行时生成 +│ └── README.txt +├── jre/ # Java 运行环境（⚠️ 不要修改） +│ ├── bin/ +│ └── lib/ +└── logs/ # 应用日志 + ├── startup-YYYYMMDD.log + └── upgrade.log + +用户数据目录（首次运行自动创建）： +X:\NPQS9100_Data\ (X 是应用所在盘符) +├── logs/ # Spring Boot 日志 +├── template/ # 报告模板 +├── report/ # 生成的报告 +└── data/ # 应用数据 +``` + +--- + +## 七、用户关心的文件（重要！）⭐ + +### 📌 可以使用的工具 + +| 文件 | 功能 | 使用场景 | +|------|------|---------| +| **NPQS9100.exe** | 主程序 | 日常启动 | +| **NPQS9100-启动器.bat** | 管理员启动器 | 首次运行或权限问题时 | +| **upgrade.bat** | 升级工具 | 收到升级包时使用 | +| **rollback.bat** | 回滚工具 | 升级后出问题时使用 | +| **uninstall-mysql-service.bat** | MySQL 服务卸载 | 完全卸载应用时使用 | +| **使用说明.txt** | 使用手册 | 遇到问题时参考 | +| **README-升级回滚.txt** | 升级说明 | 升级前阅读 | + +--- + +### ⚠️ 不要修改的文件/目录 + +| 路径 | 说明 | 误修改后果 | +|------|------|----------| +| **resources/** | 应用核心代码 | 应用无法启动 | +| **scripts/** | 启动管理脚本 | 启动流程失败 | +| **jre/** | Java 运行环境 | Java 服务无法启动 | +| **mysql/bin/** | MySQL 可执行文件 | 数据库无法启动 | +| **mysql/my.ini** | MySQL 配置 | 运行时自动生成，手动修改会被覆盖 | + +--- + +### 📂 需要保护的数据 + +| 路径 | 说明 | 备份建议 | +|------|------|---------| +| **mysql/data/** | 数据库数据 | ⚠️ 定期备份！ | +| **backup/** | 升级备份 | 自动管理，无需手动操作 | +| **X:\NPQS9100_Data/** | 用户数据目录 | 包含日志、模板、报告 | + +--- + +## 二、打包指南 + +### 🏗️ 打包步骤 + +#### **步骤 1：清理并打包** + +```bash +cd build +clean-and-build.bat +``` + +**打包过程**： +1. 停止 NPQS9100 进程 +2. 删除 out 目录 +3. 构建前端代码（Vue 3） +4. 编译 Electron 主进程代码 +5. 复制 MySQL、JRE、Java 资源 +6. 生成 win-unpacked 绿色版目录 + +**等待时间**：约 5-15 分钟 + +--- + +#### **步骤 2：测试运行** + +```bash +cd out\win-unpacked +NPQS9100.exe +``` + +**观察**： +- ✅ Loading 界面正常显示（不在任务栏显示） +- ✅ 启动进度正常更新（9个步骤） +- ✅ MySQL 自动启动 +- ✅ Spring Boot 连接成功 +- ✅ 顺利进入主界面 + +--- + +#### **步骤 3：压缩发布包** + +```powershell +cd out +Compress-Archive -Path win-unpacked -DestinationPath "NPQS9100-v1.0.0-绿色版.zip" -Force +``` + +**压缩后大小**：约 350-450 MB + +--- + +## 三、启动流程 + +### 🔄 完整启动流程 + +``` +用户解压 zip 并双击 NPQS9100.exe + ↓ +显示 Loading 界面（不在任务栏显示） + ↓ +[0%] 正在初始化应用... + ↓ +[15%] 检测 MySQL 端口 (3306 → 3307 → ...) + ├─ 找到可用端口（如 3307） + ↓ +[30%] 启动 MySQL 数据库（端口 3307） + ├─ 首次运行：自动初始化数据库 + ├─ 自动设置 root 密码：njcnpqs + ├─ 自动授权 127.0.0.1 访问 + ↓ +[45%] 等待 MySQL 就绪 + ├─ 监听端口是否打开 + ├─ 超时时间：30 秒 + ↓ +[60%] 检测 Java 端口 (18092 → 18093 → ...) + ├─ 找到可用端口（如 18093） + ↓ +[70%] 检测应用所在盘符并生成配置文件 + ├─ MySQL 连接：localhost:3307 + ├─ MySQL 密码：njcnpqs ⭐ 自动写入 + ├─ Java 端口：18093 + ├─ 数据路径：C:\NPQS9100_Data\ + ├─ 创建所有必要目录（logs、template、report、data） + ↓ +[80%] 启动 Spring Boot 后端 + ├─ 使用内置 JRE 8 + ├─ 加载生成的配置文件 + ├─ 连接 MySQL 数据库 + ↓ +[90%] 等待 Spring Boot 就绪 + ├─ 监听 18093 端口 + ├─ 超时时间：60 秒 + ↓ +[100%] 启动完成！ + ├─ 等待 1.5 秒显示完成状态 + ↓ +销毁 Loading 窗口（使用 destroy() 确保完全释放） + ↓ +显示主应用界面（任务栏只显示1个图标） +``` + +**预计启动时间**： +- 首次运行：30-45 秒（需初始化 MySQL） +- 后续启动：15-25 秒 + +--- + +### 🚪 关闭流程 + +``` +用户关闭应用（点击X或托盘退出） + ↓ +显示退出确认对话框 + ↓ +用户确认退出 + ↓ +停止 Spring Boot 进程（通过PID和端口精确清理） + ↓ +停止 MySQL 服务（如果是服务模式） + ↓ +清理资源 + ↓ +应用退出 +``` + +--- + +## 四、升级指南 + +### 🎯 升级流程概览 + +#### **升级流程** +``` +1. 双击 upgrade.bat（首次自动创建 upgrade/ 目录） +2. 将升级包放入 upgrade/ 目录 +3. 再次运行 upgrade.bat（自动备份 + 升级） +4. 重启应用测试 +``` + +#### **回滚流程** +``` +1. 双击 rollback.bat +2. 自动从 backup/ 恢复旧版本 +3. 重启应用 +``` + +--- + +### 🔧 升级操作步骤 + +#### **方法 1：使用升级脚本（推荐）⭐** + +**第 1 步：准备升级包** + +1. 双击 `upgrade.bat` +2. 脚本自动创建 `upgrade/` 文件夹并提示 +3. 将升级文件放入 `upgrade/` 目录： + - `dist/` - 前端升级包（可选） + - `entrance.jar` - 后端升级包（可选） +4. 再次双击 `upgrade.bat` 开始升级 + +**第 2 步：自动升级** + +脚本会自动： +- ✅ 停止 NPQS9100 进程 +- ✅ **自动备份当前版本到 `backup/` 目录** +- ✅ 备份数据库到 `mysql/data_backup/` +- ✅ 替换前端文件（如果有） +- ✅ 替换后端 JAR（如果有） +- ✅ 记录升级日志到 `logs/upgrade.log` + +**第 3 步：重启应用** + +升级完成后，双击 `NPQS9100.exe` 启动应用。 + +--- + +#### **方法 2：手动升级** + +如果升级脚本失败，可以手动操作： + +**升级前端**： +```batch +taskkill /F /IM NPQS9100.exe +rmdir /s /q resources\app.asar.unpacked\public\dist +xcopy upgrade\dist resources\app.asar.unpacked\public\dist\ /E /I /Y +``` + +**升级后端**： +```batch +taskkill /F /IM NPQS9100.exe +copy /Y upgrade\entrance.jar resources\extraResources\java\entrance.jar +``` + +--- + +### 🔄 回滚操作 + +#### **方法 1：使用回滚脚本（推荐）⭐** + +如果升级后出现问题，直接双击 `rollback.bat`： + +脚本会自动： +- ✅ 停止 NPQS9100 +- ✅ 恢复前端（从 `backup/dist/`） +- ✅ 恢复后端（从 `backup/entrance.jar`） +- ✅ 询问是否恢复数据库（⚠️ 会丢失升级后的数据） + +#### **方法 2：手动回滚** + +```batch +# 恢复前端 +rmdir /s /q resources\app.asar.unpacked\public\dist +xcopy backup\dist resources\app.asar.unpacked\public\dist\ /E /I /Y + +# 恢复后端 +copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar + +# 恢复数据库（⚠️ 谨慎！） +rmdir /s /q mysql\data +xcopy mysql\data_backup mysql\data\ /E /I /Y +``` + +--- + +### 📋 升级清单 + +| 升级类型 | 升级包来源 | 客户放置位置 | 最终替换位置 | +|---------|-----------|-------------|-------------| +| **前端** | `out/win-unpacked/resources/app.asar` + `app.asar.unpacked/` | `upgrade/app.asar` + `upgrade/app.asar.unpacked/` | `resources/app.asar` + `resources/app.asar.unpacked/` | +| **后端** | `out/win-unpacked/resources/extraResources/java/entrance.jar` | `upgrade/entrance.jar` | `resources/extraResources/java/entrance.jar` | +| **数据库** | ⚠️ **不升级，自动保留** | - | `mysql/data/` | + +--- + +### 🛠️ 开发者升级流程（完整版） + +#### **前端升级完整流程** + +```bash +# ============================================ +# 开发侧操作 +# ============================================ + +# 1️⃣ 修改前端代码 +# 编辑 frontend/src/ 下的任何文件 + +# 2️⃣ 如需修改配置（可选） +# 编辑 frontend/.env +VITE_API_URL=http://192.168.1.100:18092 # 修改 API 地址 + +# 3️⃣ 构建前端 +npm run build-frontend + +# 4️⃣ 打包应用 +npm run build-w +# 输出: out/win-unpacked/ + +# 5️⃣ 准备升级包 +# 从 out/win-unpacked/resources/ 复制以下文件： +# - app.asar （文件） +# - app.asar.unpacked/ （整个文件夹） +# +# 压缩成: NPQS9100-前端-v1.0.1.zip + +# 6️⃣ 发给客户 + + +# ============================================ +# 客户侧操作 +# ============================================ + +# 1️⃣ 解压升级包 +# 解压 NPQS9100-前端-v1.0.1.zip +# 得到: +# - app.asar +# - app.asar.unpacked/ + +# 2️⃣ 复制到升级目录 +# 将两个文件都放到：win-unpacked/upgrade/ +# - upgrade/app.asar +# - upgrade/app.asar.unpacked/ + +# 3️⃣ 运行升级脚本 +# 双击: upgrade.bat + +# 4️⃣ 重启应用 +# 双击: NPQS9100.exe +``` + +#### **后端升级完整流程** + +```bash +# ============================================ +# 开发侧操作 +# ============================================ + +# 1️⃣ 获取新的 JAR 文件 +# 从后端开发人员获取新版本的 entrance.jar + +# 2️⃣ 替换 JAR 文件 +# 将新的 entrance.jar 复制到: +# build/extraResources/java/entrance.jar + +# 3️⃣ 打包升级包 +# 直接压缩 entrance.jar 文件 +# 重命名为: NPQS9100-后端-v1.0.1.zip + +# 4️⃣ 发给客户 +# 发送 NPQS9100-后端-v1.0.1.zip + + +# ============================================ +# 客户侧操作 +# ============================================ + +# 1️⃣ 解压升级包 +# 解压 NPQS9100-后端-v1.0.1.zip +# 得到 entrance.jar 文件 + +# 2️⃣ 复制到升级目录 +# 将 entrance.jar 复制到: +# win-unpacked/upgrade/entrance.jar + +# 3️⃣ 运行升级脚本 +# 双击: upgrade.bat + +# 4️⃣ 重启应用 +# 双击: NPQS9100.exe +``` + +#### **前后端同时升级** + +```bash +# 开发侧：准备升级包 +NPQS9100-升级-v1.1.0.zip +├── app.asar # 前端升级包（文件） +├── app.asar.unpacked/ # 前端升级包（文件夹） +└── entrance.jar # 后端升级包 + +# 客户侧：复制到 +win-unpacked/upgrade/ +├── app.asar +├── app.asar.unpacked/ +└── entrance.jar + +# 运行 upgrade.bat 即可一次性升级前后端 +``` + +--- + +## 五、测试清单 + +### ✅ 打包验证 + +- [ ] `out/win-unpacked` 目录存在 +- [ ] 目录大小约 650-800 MB +- [ ] NPQS9100.exe 存在 +- [ ] NPQS9100-启动器.bat 存在 +- [ ] upgrade.bat 存在 +- [ ] rollback.bat 存在 +- [ ] uninstall-mysql-service.bat 存在 +- [ ] 使用说明.txt 存在 +- [ ] README-升级回滚.txt 存在 +- [ ] mysql/ 目录完整 +- [ ] jre/ 目录完整 + +--- + +### ✅ 基础功能测试 + +- [ ] 双击 NPQS9100.exe 能正常启动 +- [ ] Loading 界面正常显示 +- [ ] **Loading 窗口不在任务栏显示** ⭐ +- [ ] 进度条流畅更新（0% → 100%） +- [ ] 状态文字正确显示 +- [ ] 主界面正常显示 +- [ ] **任务栏只有1个窗口预览** ⭐ + +--- + +### ✅ 端口检测测试 + +- [ ] 手动占用 3306，应用自动使用 3307 +- [ ] 手动占用 18092，应用自动使用 18093 +- [ ] Loading 界面显示检测到的端口号 +- [ ] 日志中显示正确的端口信息 + +--- + +### ✅ MySQL 测试 + +- [ ] MySQL 自动启动成功 +- [ ] **首次运行自动初始化数据库** ⭐ +- [ ] 可以用 Navicat 连接（密码：njcnpqs） +- [ ] 可以从 127.0.0.1 连接（不报 1130 错误）⭐ +- [ ] 数据库操作正常 +- [ ] 关闭应用后 MySQL 自动停止 + +--- + +### ✅ Spring Boot 测试 + +- [ ] 后端服务自动启动 +- [ ] **能连接到 MySQL（不报密码错误）** ⭐ +- [ ] 日志无错误："HikariPool-1 - Start completed" +- [ ] API 接口正常响应 +- [ ] 关闭应用后 Java 进程停止 + +--- + +### ✅ 配置生成测试 + +- [ ] application.yml 自动生成 +- [ ] **MySQL 密码正确写入（njcnpqs）** ⭐ +- [ ] MySQL 端口正确 +- [ ] Java 端口正确 +- [ ] 数据路径正确（对应盘符） + +--- + +### ✅ 数据目录测试 + +- [ ] 数据目录在正确的盘符下创建 +- [ ] 所有子目录都自动创建 +- [ ] 配置文件路径正确 +- [ ] 日志文件正常写入 + +--- + +### ✅ 便携性测试 + +- [ ] 可以解压到任意目录运行 +- [ ] 可以移动到其他目录运行 +- [ ] 可以在不同电脑上运行 +- [ ] 可以在不同盘符上运行（C/D/E...） +- [ ] 删除目录即可完全卸载 +- [ ] **压缩成 zip 后用户可正常解压使用** ⭐ + +--- + +### ✅ 升级回滚测试 + +- [ ] upgrade.bat 首次运行自动创建 upgrade/ 目录 +- [ ] upgrade.bat 检测到升级文件后正常升级 +- [ ] 升级前自动备份到 backup/ 目录 +- [ ] 升级后应用正常运行 +- [ ] 升级后数据库数据保留 +- [ ] rollback.bat 能正确回滚前端 +- [ ] rollback.bat 能正确回滚后端 +- [ ] 回滚后应用恢复正常 + +--- + +### ✅ 性能测试 + +- [ ] 首次启动 < 45 秒 +- [ ] 后续启动 < 30 秒 +- [ ] Loading 界面流畅无卡顿 +- [ ] 内存占用合理（< 1GB） +- [ ] CPU 占用正常 + +--- + +### ✅ 错误处理测试 + +- [ ] 端口全部占用时显示友好错误 +- [ ] MySQL 启动失败时显示错误信息 +- [ ] Spring Boot 启动失败时不崩溃 +- [ ] 升级失败时自动回滚 +- [ ] 托盘图标显示正常 +- [ ] 退出确认对话框正常工作 + +--- + +## 六、常见问题 + +### Q1: Loading 界面一直卡在某个步骤？ + +**A**: 查看日志定位问题： +``` +C:\Users\[用户名]\AppData\Roaming\NQPS9100\logs\ +├── 9100-YYYYMMDD.log # 应用日志 +├── 9100-core-YYYYMMDD.log # 核心日志 +└── 9100-error-YYYYMMDD.log # 错误日志 +``` + +常见原因： +- MySQL 启动失败 → 检查端口是否可用 +- Java 启动失败 → 检查 JRE 是否完整 +- 配置生成失败 → 检查磁盘权限 + +--- + +### Q2: 显示"无法找到可用端口"错误？ + +**A**: +- 检查是否有大量端口被占用 +- 尝试关闭其他占用端口的程序 +- 或修改起始端口（见开发者指南） + +--- + +### Q3: MySQL 连接失败或提示 1130 错误？ + +**A**: +- 确认 MySQL 已启动（任务管理器查看 mysqld.exe） +- 确认端口正确（看 Loading 界面显示的端口） +- 确认密码正确（njcnpqs，已自动配置） +- 检查是否有杀毒软件拦截 +- 如有问题，重启应用即可（MySQL 会自动重新配置） + +--- + +### Q4: 后端 API 无法访问？ + +**A**: +- 确认 Spring Boot 已启动 +- 确认端口正确（看 Loading 界面） +- 检查防火墙设置 + +--- + +### Q5: 打包后体积太大？ + +**A**: 预期体积： +- **解压后**：650-800 MB +- **压缩后 (zip)**：350-450 MB + +主要组成： +- 应用本体：~150 MB +- MySQL 8.0：~400 MB +- JRE 8：~100 MB + +优化建议： +- 考虑使用 7z 格式（压缩率更高） +- 可以精简 MySQL 的不必要组件 + +--- + +### Q6: 任务栏显示2个窗口预览？ + +**A**: 已修复！现在 Loading 窗口使用 `skipTaskbar: true`，不会在任务栏显示。 + +--- + +### Q7: 升级后前端显示旧版本？ + +**A**: 清除浏览器缓存，或强制刷新（Ctrl + F5） + +--- + +### Q8: 升级后数据丢失？ + +**A**: 检查 `mysql/data/` 目录是否完整，如有备份，从 `mysql/data_backup/` 恢复 + +--- + +### Q9: 升级脚本报错？ + +**A**： +1. 检查 `upgrade` 文件夹路径是否正确 +2. 手动执行升级步骤 +3. 查看 `logs/upgrade.log` 日志 + +--- + +### Q10: 回滚后还是有问题？ + +**A**： +1. 检查 `backup/` 目录是否有备份文件 +2. 查看 `backup/version.txt` 确认备份版本 +3. 手动执行回滚步骤（参考本文档） + +--- + +### Q11: 多次升级后，backup 目录的内容是什么版本？ + +**A**: `backup/` 目录保存的是**最后一次升级前**的版本（每次升级都会覆盖） + +--- + +### Q12: 点击 X 关闭后，Java 进程还在运行？ + +**A**: 已修复！现在使用精确的进程清理机制： +- 通过 PID 清理（如果有进程引用） +- 通过端口号清理（精确定位） +- **不会误杀 IDEA 等其他 Java 进程** ⭐ + +--- + +### Q13: 如何修改 API 或 WebSocket 地址？ + +**A**: +1. 修改 `frontend/.env` 文件中的 `VITE_API_URL` +2. 重新构建前端：`npm run build-frontend` +3. 将 `public/dist/` 打包为升级包 +4. 使用 `upgrade.bat` 升级 + +**示例**： +```env +# frontend/.env +VITE_API_URL=http://192.168.1.100:18092 +``` + +**注意**： +- 配置修改需要重新打包前端 +- 使用升级机制保证数据安全 + +--- + +### Q14: MySQL 服务如何卸载？ + +**A**: +**方法 1：使用卸载脚本（推荐）** +```batch +双击: uninstall-mysql-service.bat +``` + +**方法 2：手动卸载** +```batch +# 停止服务 +net stop mysql9100 + +# 删除服务 +sc delete mysql9100 +``` + +**注意**： +- 卸载服务不会删除数据库数据 +- 数据保存在 `mysql/data/` 目录 +- 下次启动应用会重新安装服务 + +--- + +## 📚 相关文档 + +**用户文档**（随应用发布）： +- `使用说明.txt` - 用户使用手册 +- `README-升级回滚.txt` - 简明升级说明 + +**开发者文档**（doc/ 目录）： +- `doc/NPQS-9100绿色包完整指南.md` - 本文档（完整指南） +- `doc/打包前检查清单.md` - 逐项检查 +- `doc/管理员权限说明.md` - 权限问题处理 +- `doc/MySQL服务化方案说明.md` - MySQL 服务管理 + +--- + +## 📊 技术架构 + +### 核心模块 + +- `scripts/port-checker.js` - 端口检测工具 +- `scripts/startup-manager.js` - 启动状态管理 +- `scripts/config-generator.js` - 配置文件生成 +- `scripts/mysql-service-manager.js` - MySQL 服务管理器 +- `scripts/java-runner.js` - Java 运行器 +- `scripts/log-window-manager.js` - 日志窗口管理 +- `electron/preload/lifecycle.js` - 生命周期管理 +- `public/html/loading.html` - Loading 界面 + +### 启动流程架构 + +``` +lifecycle.js (入口) + ↓ 创建 +StartupManager (显示 Loading) + ↓ 调用 +PortChecker (检测端口) + ↓ 调用 +MySQLServiceManager (管理 MySQL 服务) + ↓ 调用 +ConfigGenerator (生成配置) + ↓ 调用 +JavaRunner (启动 Spring Boot) +``` + +--- + +## 🎉 最新改进 + +### 用户体验提升 +- ✅ **任务栏只显示1个图标** - Loading 窗口不在任务栏显示 +- ✅ **纯绿色版** - 只生成 win-unpacked 目录，压缩成 zip 即可发布 +- ✅ **一键解压即用** - 用户解压后双击即可运行 +- ✅ **热更新机制** - 前后端可独立升级，支持一键回滚 + +### 技术改进 +- ✅ **MySQL 密码自动配置** - 配置生成器自动写入密码 +- ✅ **权限自动授权** - 支持 localhost 和 127.0.0.1 访问 +- ✅ **MySQL 服务化** - 使用 Windows 服务管理，开机自启 +- ✅ **窗口管理优化** - 使用 destroy() 确保窗口完全释放 +- ✅ **精确进程清理** - 不会误杀其他 Java 进程 +- ✅ **自动备份机制** - 升级前自动备份，支持回滚 +- ✅ **热更新机制** - 前后端独立升级，无需重装 + +### 文档完善 +- ✅ **使用说明.txt** - 为用户提供详细的使用指南 +- ✅ **README-升级回滚.txt** - 简明升级操作说明 +- ✅ **完整指南** - 打包、启动、升级三合一文档 + +--- + +## 📞 技术支持 + +如遇问题，请联系技术支持并提供： +- 应用版本号 +- 错误日志（`logs/` 目录） +- 操作步骤截图 + +--- + +*文档更新时间: 2025-10-23* +*南京灿能电力自动化股份有限公司* + diff --git a/doc/便携式JRE集成指南.md b/doc/便携式JRE集成指南.md deleted file mode 100644 index f9319fb..0000000 --- a/doc/便携式JRE集成指南.md +++ /dev/null @@ -1,133 +0,0 @@ -## 便携式 JRE/JDK8 集成指南 - -本指南介绍如何将 JRE 8 以“便携式”（解压即用、无需安装）的方式随应用打包，并在 Electron 主进程中通过绝对路径调用，从而避免要求用户在系统中安装 JDK/JRE。 - -### 为什么选择便携式 JRE -- 无需管理员权限与系统环境变量配置，用户无感知。 -- 不污染系统环境（不写入 JAVA_HOME/PATH）。 -- 跨平台一致，可精简体积、可控版本。 - -### 适用场景 -- 运行 Java 程序或 JAR 包（仅需运行时）。 -- 不需要 javac/jcmd/jmap 等开发/诊断工具（若需要，请改为随包便携式 JDK）。 - -### 推荐的 JRE 8 发行版（可再分发） -- Azul Zulu 8 JRE（可选 ZuluFX 含 JavaFX）：[下载页面](https://www.azul.com/downloads/?version=java-8-lts&package=jre) -- BellSoft Liberica 8 JRE（Standard/Full，Full 含 JavaFX）：[下载页面](https://bell-sw.com/pages/downloads/#/java-8-lts) -- Eclipse Temurin 8 JRE（Adoptium）：[下载页面](https://adoptium.net/temurin/releases/?version=8) - -选择要点： -- 需要 AWT/Swing/字体/打印 → 选择非 headless 包。 -- 需要 JavaFX → 选择 Liberica Full 或 ZuluFX。 -- 仅命令行/服务端 → 任意 JRE 8（headless 也可）。 - -### 目录放置约定 -将解压后的 JRE 放入项目的 `build/extraResources/jre`，保证内部存在 `bin/java(.exe)`： - -``` -build/ - extraResources/ - jre/ - bin/ - java(.exe) - lib/ - ... -``` - -构建后在生产环境可通过 `process.resourcesPath` 访问： -`/resources/extraResources/jre/bin/java(.exe)`。 - -### 主进程调用示例 -在 `electron/preload/lifecycle.js` 或你的业务模块中封装 Java 运行工具（开发/生产两种路径）： - -```js -const path = require('path'); -const { spawn } = require('child_process'); - -function getExtraResourcesDir() { - // 开发态：使用项目目录；生产态：使用 asar/resources 目录 - const isDev = !!process.env.EE_DEV || process.env.NODE_ENV === 'development'; - return isDev - ? path.join(process.cwd(), 'build', 'extraResources') - : path.join(process.resourcesPath, 'extraResources'); -} - -function getJavaBinPath() { - const extraDir = getExtraResourcesDir(); - const javaBinName = process.platform === 'win32' ? 'java.exe' : 'java'; - return path.join(extraDir, 'jre', 'bin', javaBinName); -} - -function runJavaJar(jarAbsPath, args = [], options = {}) { - const javaPath = getJavaBinPath(); - const child = spawn(javaPath, ['-jar', jarAbsPath, ...args], { - stdio: 'inherit', - ...options, - }); - return child; -} - -async function ensureJavaVersion(logger) { - return new Promise((resolve) => { - const child = spawn(getJavaBinPath(), ['-version']); - let out = ''; - let err = ''; - child.stdout && child.stdout.on('data', (d) => (out += d.toString())) - child.stderr && child.stderr.on('data', (d) => (err += d.toString())) - child.on('close', () => { - const text = (out + '\n' + err).trim(); - logger && logger.info('[java] version check:', text); - resolve(text.includes('1.8.0')); - }); - }); -} - -module.exports = { getJavaBinPath, runJavaJar, ensureJavaVersion }; -``` - -在生命周期中调用（示例）： - -```js -const { logger } = require('ee-core/log'); -const path = require('path'); -const { runJavaJar, ensureJavaVersion } = require('./java-runner'); - -class Lifecycle { - async ready() { - const ok = await ensureJavaVersion(logger); - if (!ok) { - logger.error('[java] 未检测到 JRE 8，请检查 extraResources/jre 是否存在'); - } - } - - async windowReady() { - const jarPath = path.join(process.resourcesPath || process.cwd(), 'extraResources', 'tools', 'your-app.jar'); - // 示例：延后在某业务时机再启动 Java 进程 - // const proc = runJavaJar(jarPath, ['--arg1', 'value']); - } -} -``` - -注意：示例中的 `java-runner` 为上文工具函数文件，实际请按你的项目结构放置。 - -### 验证清单 -- 运行 `jre/bin/java -version` 输出包含 `1.8.0_xxx`。 -- 若涉及 GUI/字体/打印，验证 AWT/Swing 中文渲染与打印。 -- 若需 JavaFX，验证 JavaFX Demo 启动。 -- 若涉及 TLS/HTTPS，验证 SSL 通信正常。 - -### 许可与合规 -- Azul Zulu、Eclipse Temurin（Adoptium）、BellSoft Liberica 的 JRE/JDK 8 发行包均可免费再分发（GPLv2+CE 或厂商许可证）。 -- 建议在应用的“关于/许可证”中附上所选发行版的许可证链接与致谢。 - -### 常见问题 -1) 是否“阉割”？ -— 上述 JRE 8 发行版均为标准运行时，通过兼容性测试；JRE 不包含开发者工具属于正常区别，不是删减。 - -2) 何时需要 JDK 而不是 JRE？ -— 需要 `javac` 编译或 `jcmd/jmap` 等诊断工具，或你的 Java 组件依赖 `tools.jar` 时。 - -3) 体积如何优化？ -— 选择 headless（若无 GUI 需求）、去除无用语言/字体包；或改用 JDK 9+ 使用 jlink（不适用于 8）。 - - diff --git a/doc/打包方案对比.md b/doc/打包方案对比.md deleted file mode 100644 index b7d8b41..0000000 --- a/doc/打包方案对比.md +++ /dev/null @@ -1,436 +0,0 @@ -# 应用打包方案对比与实现 - -本文档详细说明 ElectronEgg 应用的两种打包方案：纯绿色版方案 和 双版本方案。 - ---- - -## 方案对比 - -| 特性 | 方案一：纯绿色版 | 方案二：双版本打包 | -|------|-----------------|-------------------| -| **打包产物** | 单个便携版 exe | 安装版 exe + 便携版 exe | -| **安装过程** | 无需安装 | 安装版需安装，便携版无需 | -| **桌面快捷方式** | 应用内自动创建 | 安装版自动创建，便携版手动或自动 | -| **开始菜单** | 无 | 安装版有 | -| **卸载程序** | 无（直接删除） | 安装版有 | -| **适用场景** | 临时使用、U盘携带 | 正式部署、企业分发 | -| **用户体验** | 灵活、轻量 | 专业、完整 | -| **打包时间** | 快 | 较慢（打包两次） | -| **分发复杂度** | 简单（单文件） | 中等（两个文件） | - ---- - -## 方案一：纯绿色版 + 自动创建快捷方式 - -### 特点 -- ✅ 单个 exe 文件，双击即用 -- ✅ 首次启动时询问是否创建桌面快捷方式 -- ✅ 无需安装，无需卸载 -- ✅ 适合快速分发和临时使用 - -### 实现步骤 - -#### 1. 修改打包配置 - -**文件**：[cmd/builder.json](../cmd/builder.json) - -```json -{ - "productName": "南京灿能工具", - "appId": "com.canneng.tool", - "copyright": "© 2025 hongawen", - "directories": { - "output": "out" - }, - "asar": true, - "files": [ - "**/*", - "!cmd/", - "!data/", - "!electron/", - "!frontend/", - "!logs/", - "!out/", - "!go/", - "!python/" - ], - "extraResources": { - "from": "build/extraResources/", - "to": "extraResources" - }, - "publish": [ - { - "provider": "generic", - "url": "https://your-update-server.com" - } - ], - "win": { - "icon": "build/icons/icon.ico", - "artifactName": "${productName}-${os}-${version}-${arch}.${ext}", - "target": [ - { - "target": "portable" - } - ] - } -} -``` - -#### 2. 添加自动创建快捷方式功能 - -**文件**：[electron/preload/lifecycle.js](../electron/preload/lifecycle.js) - -在 `windowReady()` 钩子中添加以下代码： - -```javascript -const { logger } = require('ee-core/log'); -const { getConfig } = require('ee-core/config'); -const { getMainWindow } = require('ee-core/electron'); - -class Lifecycle { - - async ready() { - logger.info('[lifecycle] ready'); - } - - async electronAppReady() { - logger.info('[lifecycle] electron-app-ready'); - } - - async windowReady() { - logger.info('[lifecycle] window-ready'); - - // 延迟加载，无白屏 - const { windowsOption } = getConfig(); - if (windowsOption.show == false) { - const win = getMainWindow(); - win.once('ready-to-show', () => { - win.show(); - win.focus(); - }) - } - - // 绿色版自动创建桌面快捷方式 - await this.createDesktopShortcut(); - } - - /** - * 为绿色版创建桌面快捷方式 - */ - async createDesktopShortcut() { - const { app, dialog, shell } = require('electron'); - const path = require('path'); - const fs = require('fs'); - - // 判断是否为便携版（绿色版） - // 安装版通常在 C:\Program Files 或 AppData\Local\Programs - const isPortable = process.platform === 'win32' && - !process.execPath.includes('Program Files') && - !process.execPath.includes('AppData\\Local\\Programs'); - - if (!isPortable) { - logger.info('[lifecycle] 非便携版，跳过快捷方式创建'); - return; - } - - try { - const desktopPath = app.getPath('desktop'); - const shortcutPath = path.join(desktopPath, '南京灿能工具.lnk'); - - // 如果快捷方式已存在，跳过 - if (fs.existsSync(shortcutPath)) { - logger.info('[lifecycle] 桌面快捷方式已存在'); - return; - } - - // 询问用户是否创建快捷方式 - const result = await dialog.showMessageBox({ - type: 'question', - buttons: ['创建', '跳过'], - defaultId: 0, - title: '创建桌面快捷方式', - message: '是否在桌面创建快捷方式？', - detail: '方便您下次快速启动应用' - }); - - if (result.response === 0) { - // Windows 下创建快捷方式 - const success = shell.writeShortcutLink(shortcutPath, { - target: process.execPath, - cwd: path.dirname(process.execPath), - description: '南京灿能C端工具', - icon: process.execPath, - iconIndex: 0 - }); - - if (success) { - logger.info('[lifecycle] 桌面快捷方式创建成功'); - await dialog.showMessageBox({ - type: 'info', - title: '成功', - message: '桌面快捷方式已创建', - buttons: ['确定'] - }); - } else { - logger.error('[lifecycle] 桌面快捷方式创建失败'); - } - } else { - logger.info('[lifecycle] 用户跳过创建快捷方式'); - } - } catch (error) { - logger.error('[lifecycle] 创建快捷方式时出错:', error); - } - } - - async beforeClose() { - logger.info('[lifecycle] before-close'); - } -} -Lifecycle.toString = () => '[class Lifecycle]'; - -module.exports = { - Lifecycle -}; -``` - -#### 3. 打包命令 - -```bash -npm run build # 完整构建 -npm run build-w # 打包 Windows 便携版 -``` - -#### 4. 产物说明 - -打包完成后，在 `out/` 目录下会生成： -``` -out/ -└── 南京灿能工具-win-4.0.0-x64.exe （便携版，约 150-200MB） -``` - ---- - -## 方案二：双版本打包（安装版 + 便携版） - -### 特点 -- ✅ 提供两种版本供用户选择 -- ✅ 安装版：专业、完整的安装体验 -- ✅ 便携版：灵活、轻量，无需安装 -- ✅ 适合正式产品发布 - -### 实现步骤 - -#### 1. 修改打包配置 - -**文件**：[cmd/builder.json](../cmd/builder.json) - -```json -{ - "productName": "南京灿能工具", - "appId": "com.canneng.tool", - "copyright": "© 2025 hongawen", - "directories": { - "output": "out" - }, - "asar": true, - "files": [ - "**/*", - "!cmd/", - "!data/", - "!electron/", - "!frontend/", - "!logs/", - "!out/", - "!go/", - "!python/" - ], - "extraResources": { - "from": "build/extraResources/", - "to": "extraResources" - }, - "nsis": { - "oneClick": false, - "allowElevation": true, - "allowToChangeInstallationDirectory": true, - "installerIcon": "build/icons/icon.ico", - "uninstallerIcon": "build/icons/icon.ico", - "installerHeaderIcon": "build/icons/icon.ico", - "createDesktopShortcut": true, - "createStartMenuShortcut": true, - "shortcutName": "南京灿能工具", - "artifactName": "${productName}-Setup-${version}.${ext}" - }, - "portable": { - "artifactName": "${productName}-Portable-${version}.${ext}" - }, - "publish": [ - { - "provider": "generic", - "url": "https://your-update-server.com" - } - ], - "win": { - "icon": "build/icons/icon.ico", - "target": [ - { - "target": "nsis", - "arch": ["x64"] - }, - { - "target": "portable", - "arch": ["x64"] - } - ] - } -} -``` - -#### 2. 便携版快捷方式功能（可选） - -如果希望便携版也能自动创建快捷方式，使用**方案一**中的 `createDesktopShortcut()` 代码。 - -#### 3. 打包命令 - -```bash -npm run build # 完整构建 -npm run build-w # 打包两个版本 -``` - -#### 4. 产物说明 - -打包完成后，在 `out/` 目录下会生成： -``` -out/ -├── 南京灿能工具-Setup-4.0.0.exe （安装版，约 150MB） -└── 南京灿能工具-Portable-4.0.0.exe （便携版，约 150-200MB） -``` - -#### 5. 版本差异说明 - -**安装版 (NSIS)**： -- 需要安装到系统（默认 C:\Program Files） -- 自动创建桌面快捷方式 -- 自动创建开始菜单项 -- 提供卸载程序 -- 支持自动更新 -- 适合企业部署、长期使用 - -**便携版 (Portable)**： -- 单个 exe 文件 -- 双击直接运行（首次会自解压） -- 无需安装，无需卸载 -- 可放在 U 盘随身携带 -- 适合临时使用、测试环境 - ---- - -## 快捷方式创建原理（技术细节） - -### Windows 快捷方式 (.lnk) - -```javascript -shell.writeShortcutLink(shortcutPath, { - target: process.execPath, // 目标程序路径 - cwd: path.dirname(process.execPath), // 工作目录 - description: '应用描述', // 快捷方式描述 - icon: process.execPath, // 图标路径 - iconIndex: 0, // 图标索引 - args: '', // 启动参数（可选） - appUserModelId: 'com.app.id' // Windows 应用 ID（可选） -}) -``` - -### 判断是否为便携版 - -```javascript -const isPortable = process.platform === 'win32' && - !process.execPath.includes('Program Files') && - !process.execPath.includes('AppData\\Local\\Programs'); -``` - -**原理**： -- 安装版通常安装在 `C:\Program Files\YourApp\` -- 或者 `C:\Users\用户名\AppData\Local\Programs\YourApp\` -- 便携版可以在任意位置运行 - ---- - -## 推荐配置 - -### 企业级应用（推荐方案二） -``` -✅ 提供两个版本 -✅ 主推安装版（专业形象） -✅ 提供便携版作为备选 -``` - -### 轻量工具（推荐方案一） -``` -✅ 只提供便携版 -✅ 应用内自动创建快捷方式 -✅ 简化分发流程 -``` - ---- - -## 常见问题 - -### Q1: 便携版首次启动为什么慢？ -**A**: 便携版是自解压程序，首次运行需要解压资源到临时目录（约 3-5 秒）。后续启动会快很多。 - -### Q2: 便携版数据存储在哪里？ -**A**: -- 用户数据：`C:\Users\用户名\AppData\Roaming\你的appId\` -- 临时文件：`C:\Users\用户名\AppData\Local\Temp\` - -### Q3: 如何让便携版也支持自动更新？ -**A**: 需要配置 `electron-updater`，但便携版更新体验不如安装版。建议： -- 安装版：使用自动更新 -- 便携版：提示用户下载新版本 - -### Q4: 可以同时运行两个版本吗？ -**A**: 不建议。虽然技术上可行，但会导致数据冲突（共享同一个 userData 目录）。 - -### Q5: 如何自定义快捷方式图标？ -**A**: 在 `build/icons/` 目录放置 `.ico` 文件，并在 `builder.json` 中配置： -```json -"win": { - "icon": "build/icons/custom-icon.ico" -} -``` - ---- - -## 测试检查清单 - -打包完成后，请进行以下测试： - -### 安装版测试 -- [ ] 安装到默认路径成功 -- [ ] 安装到自定义路径成功 -- [ ] 桌面快捷方式正常 -- [ ] 开始菜单项正常 -- [ ] 应用启动正常 -- [ ] 卸载程序正常 - -### 便携版测试 -- [ ] 双击 exe 正常启动 -- [ ] 首次启动自动创建快捷方式（如已实现） -- [ ] 桌面快捷方式可用 -- [ ] 应用功能正常 -- [ ] 关闭后再次启动正常 -- [ ] 可移动到其他目录运行 - ---- - -## 参考资源 - -- electron-builder 官方文档: https://www.electron.build/ -- NSIS 配置: https://www.electron.build/configuration/nsis -- Portable 配置: https://www.electron.build/configuration/portable -- Electron shell API: https://www.electronjs.org/docs/latest/api/shell - ---- - -*文档创建时间: 2025-10-14* -*作者: hongawen* diff --git a/electron/config/config.default.js b/electron/config/config.default.js index 1d4b156..3a9f88d 100644 --- a/electron/config/config.default.js +++ b/electron/config/config.default.js @@ -12,7 +12,7 @@ module.exports = () => { singleLock: true, windowsOption: { title: 'NPQS9100-自动检测平台', - menuBarVisible: true, // 显示菜单栏，方便查看日志 + menuBarVisible: false, // 隐藏菜单栏 width: 1920, height: 1000, minWidth: 1024, @@ -25,7 +25,7 @@ module.exports = () => { }, frame: true, show: false, // 初始不显示，等待服务启动完成后再显示 - icon: path.join(getBaseDir(), 'public', 'images', 'logo-32.png'), + icon: path.join(getBaseDir(), 'public', 'images', 'icon.png'), }, logger: { level: 'INFO', diff --git a/electron/controller/mysql.js b/electron/controller/mysql.js deleted file mode 100644 index b925bca..0000000 --- a/electron/controller/mysql.js +++ /dev/null @@ -1,75 +0,0 @@ -const path = require('path'); - -// 动态获取 scripts 目录路径 -function getScriptsPath(scriptName) { - // 开发环境 - const devPath = path.join(__dirname, '../../scripts', scriptName); - // 生产环境（打包后） - const prodPath = path.join(process.resourcesPath, 'scripts', scriptName); - - try { - // 先尝试开发环境路径 - require.resolve(devPath); - return devPath; - } catch (e) { - // 如果开发环境路径不存在，使用生产环境路径 - return prodPath; - } -} - -// 延迟加载 MySQLManager -let MySQLManager = null; -function getMySQLManager() { - if (!MySQLManager) { - MySQLManager = require(getScriptsPath('start-mysql')); - } - return MySQLManager; -} - -class MySQLController { - - /** - * 启动MySQL服务 - */ - async start() { - try { - const MySQLManagerClass = getMySQLManager(); - const mysqlManager = new MySQLManagerClass(); - await mysqlManager.start(); - return { success: true, message: 'MySQL started successfully' }; - } catch (error) { - return { success: false, message: error.message }; - } - } - - /** - * 停止MySQL服务 - */ - async stop() { - try { - const MySQLManagerClass = getMySQLManager(); - const mysqlManager = new MySQLManagerClass(); - await mysqlManager.stop(); - return { success: true, message: 'MySQL stopped successfully' }; - } catch (error) { - return { success: false, message: error.message }; - } - } - - /** - * 获取MySQL连接配置 - */ - async getConnectionConfig() { - try { - const MySQLManagerClass = getMySQLManager(); - const mysqlManager = new MySQLManagerClass(); - const config = mysqlManager.getConnectionConfig(); - return { success: true, data: config }; - } catch (error) { - return { success: false, message: error.message }; - } - } -} - -MySQLController.toString = () => '[class MySQLController]'; -module.exports = MySQLController; \ No newline at end of file diff --git a/electron/main.js b/electron/main.js index a552255..5ce4e28 100644 --- a/electron/main.js +++ b/electron/main.js @@ -1,27 +1,132 @@ const { ElectronEgg } = require('ee-core'); -const { app, Menu, ipcMain } = require('electron'); +const { app, Menu, ipcMain, Tray, dialog, BrowserWindow } = require('electron'); +const path = require('path'); const lifecycle = require('./preload/lifecycle'); const { preload } = require('./preload'); // new app const electronApp = new ElectronEgg(); +// 全局变量 +let tray = null; +let isQuitting = false; + +// 创建系统托盘 +function createTray() { + try { + // 开发环境和生产环境的图标路径 + const isDev = !process.resourcesPath; + const iconPath = isDev + ? path.join(__dirname, '..', 'public', 'images', 'tray.png') + : path.join(process.resourcesPath, 'app.asar.unpacked', 'public', 'images', 'tray.png'); + + console.log('[Tray] Icon path:', iconPath); + + // 检查图标文件是否存在 + const fs = require('fs'); + if (!fs.existsSync(iconPath)) { + console.error('[Tray] Icon file not found:', iconPath); + // 如果找不到，尝试使用备用路径（主图标） + const fallbackIcon = isDev + ? path.join(__dirname, '..', 'public', 'images', 'icon.png') + : path.join(process.resourcesPath, 'app.asar.unpacked', 'public', 'images', 'icon.png'); + + if (fs.existsSync(fallbackIcon)) { + console.log('[Tray] Using fallback icon:', fallbackIcon); + tray = new Tray(fallbackIcon); + } else { + console.error('[Tray] No icon available, tray not created'); + return; + } + } else { + tray = new Tray(iconPath); + } + + tray.setToolTip('NPQS-9100自动检测平台'); + console.log('[Tray] Tray created successfully'); + + // 创建托盘菜单 + const contextMenu = Menu.buildFromTemplate([ + { + label: '显示主窗口', + click: () => { + const mainWindow = BrowserWindow.getAllWindows()[0]; + if (mainWindow) { + if (mainWindow.isMinimized()) { + mainWindow.restore(); + } + mainWindow.show(); + mainWindow.focus(); + } + } + }, + { type: 'separator' }, + { + label: '退出', + click: async () => { + // 弹出确认对话框 + const { response } = await dialog.showMessageBox({ + type: 'question', + title: '退出确认', + message: '确定退出应用吗？', + buttons: ['取消', '确定退出'], + defaultId: 0, + cancelId: 0 + }); + + if (response === 1) { + // 用户点击了"确定退出" + isQuitting = true; + + // 获取主窗口 + const mainWindow = BrowserWindow.getAllWindows()[0]; + + // 移除所有 close 监听器，避免阻止关闭 + if (mainWindow) { + mainWindow.removeAllListeners('close'); + } + + // 执行清理 + await lifecycle.cleanup(); + + // 退出应用 + app.quit(); + } + } + } + ]); + + tray.setContextMenu(contextMenu); + + // 双击托盘图标显示窗口 + tray.on('double-click', () => { + const mainWindow = BrowserWindow.getAllWindows()[0]; + if (mainWindow) { + if (mainWindow.isMinimized()) { + mainWindow.restore(); + } + mainWindow.show(); + mainWindow.focus(); + } + }); + + } catch (error) { + console.error('[Tray] Failed to create tray:', error); + tray = null; + } +} + // 创建应用菜单 function createApplicationMenu() { + // 生产环境隐藏菜单栏 + Menu.setApplicationMenu(null); + + // 调试时可以使用下面的菜单（取消注释） + /* const template = [ { label: '查看', submenu: [ - { - label: '显示/隐藏服务日志', - accelerator: 'F12', - click: () => { - if (lifecycle.logWindowManager) { - lifecycle.logWindowManager.toggle(); - } - } - }, - { type: 'separator' }, { role: 'reload', label: '刷新' }, { role: 'forceReload', label: '强制刷新' }, { type: 'separator' }, @@ -47,9 +152,10 @@ function createApplicationMenu() { ] } ]; - + const menu = Menu.buildFromTemplate(template); Menu.setApplicationMenu(menu); + */ } // 注册 IPC 处理器 @@ -71,14 +177,87 @@ ipcMain.handle('toggle-log-window', () => { } }); +// 检查是否正在退出 +ipcMain.handle('is-quitting', () => { + return isQuitting; +}); + +// 处理单实例：当尝试启动第二个实例时，聚焦已有窗口 +app.on('second-instance', (event, commandLine, workingDirectory) => { + console.log('[Main] Second instance detected, focusing main window...'); + + // 获取主窗口 + const mainWindow = BrowserWindow.getAllWindows().find(win => { + return win.getTitle().includes('NPQS') || win.getTitle().includes('检测平台'); + }); + + if (mainWindow) { + // 如果窗口最小化，恢复它 + if (mainWindow.isMinimized()) { + mainWindow.restore(); + } + + // 如果窗口隐藏，显示它 + if (!mainWindow.isVisible()) { + mainWindow.show(); + } + + // 聚焦窗口 + mainWindow.focus(); + + console.log('[Main] Main window focused'); + } else { + console.warn('[Main] Main window not found'); + } +}); + +// 监听应用退出前事件（确保清理托盘） +app.on('before-quit', () => { + console.log('[Main] App before-quit, destroying tray...'); + + // 销毁托盘图标 + if (tray && !tray.isDestroyed()) { + tray.destroy(); + tray = null; + } +}); + +// 监听 will-quit 事件（强制退出时） +app.on('will-quit', () => { + console.log('[Main] App will-quit'); + + // 确保托盘被销毁 + if (tray && !tray.isDestroyed()) { + tray.destroy(); + tray = null; + } +}); + // register lifecycle (绑定 this 上下文) electronApp.register("ready", lifecycle.ready.bind(lifecycle)); electronApp.register("electron-app-ready", () => { lifecycle.electronAppReady.bind(lifecycle)(); createApplicationMenu(); + createTray(); // 创建系统托盘 }); electronApp.register("window-ready", lifecycle.windowReady.bind(lifecycle)); -electronApp.register("before-close", lifecycle.beforeClose.bind(lifecycle)); +electronApp.register("before-close", async () => { + // 如果不是真正退出，不执行清理 + if (!isQuitting) { + console.log('[Main] Not quitting, skip cleanup'); + return; + } + + console.log('[Main] Quitting, execute cleanup'); + + // 销毁托盘图标 + if (tray && !tray.isDestroyed()) { + tray.destroy(); + tray = null; + } + + await lifecycle.beforeClose.bind(lifecycle)(); +}); // register preload electronApp.register("preload", preload); diff --git a/electron/preload/lifecycle.js b/electron/preload/lifecycle.js index 4582273..3dfd3da 100644 --- a/electron/preload/lifecycle.js +++ b/electron/preload/lifecycle.js @@ -4,7 +4,7 @@ const path = require('path'); const { logger } = require('ee-core/log'); const { getConfig } = require('ee-core/config'); const { getMainWindow } = require('ee-core/electron'); -const ps = require('ee-core/ps'); +const { getBaseDir } = require('ee-core/ps'); const { app } = require('electron'); // 动态获取 scripts 目录路径 @@ -12,7 +12,8 @@ function getScriptsPath(scriptName) { const fs = require('fs'); // 判断是否是打包后的环境 - const isProd = process.resourcesPath && process.resourcesPath.includes('win-unpacked'); + // 只要 process.resourcesPath 存在，就是打包后的环境（无论在哪个目录） + const isProd = !!process.resourcesPath; if (isProd) { // 生产环境（打包后）：从 resources 目录 @@ -44,11 +45,11 @@ function getScriptsPath(scriptName) { } // 延迟加载 scripts -let MySQLManager, JavaRunner, ConfigGenerator, PortChecker, StartupManager, LogWindowManager; +let MySQLServiceManager, JavaRunner, ConfigGenerator, PortChecker, StartupManager, LogWindowManager; function loadScripts() { - if (!MySQLManager) { - MySQLManager = require(getScriptsPath('start-mysql')); + if (!MySQLServiceManager) { + MySQLServiceManager = require(getScriptsPath('mysql-service-manager')); JavaRunner = require(getScriptsPath('java-runner')); ConfigGenerator = require(getScriptsPath('config-generator')); PortChecker = require(getScriptsPath('port-checker')); @@ -59,7 +60,7 @@ function loadScripts() { class Lifecycle { constructor() { - this.mysqlManager = null; + this.mysqlServiceManager = null; this.javaRunner = null; this.startupManager = null; this.logWindowManager = null; @@ -74,76 +75,58 @@ class Lifecycle { async ready() { logger.info('[lifecycle] ready'); // 延迟加载 scripts - if (ps.isProd()) { - loadScripts(); - } - + loadScripts(); } /** * 完整的应用启动流程 */ async startApplication() { + this.logWindowManager.addLog('system', '▶ 步骤1: 开始启动流程...'); + logger.info('[lifecycle] Starting application...'); + + this.logWindowManager.addLog('system', '▶ 步骤2: 加载配置信息...'); const config = getConfig(); + logger.info('[lifecycle] Config loaded:', JSON.stringify(config)); // 步骤1: 初始化 + this.logWindowManager.addLog('system', '▶ 步骤3: 初始化启动管理器...'); this.startupManager.updateProgress('init'); await this.sleep(500); - // 步骤2: 检测 MySQL 端口 - this.startupManager.updateProgress('check-mysql-port'); - this.logWindowManager.addLog('system', '正在检测可用的 MySQL 端口（从3306开始）...'); + // 步骤2-4: 确保 MySQL 服务运行 + this.logWindowManager.addLog('system', '▶ 步骤4: 检查 MySQL 配置...'); + logger.info('[lifecycle] MySQL config check - enable:', config.mysql?.enable, 'autoStart:', config.mysql?.autoStart); - this.mysqlPort = await PortChecker.findAvailablePort(3306, 100); - - if (this.mysqlPort === -1) { - this.logWindowManager.addLog('error', 'MySQL 端口检测失败：3306-3405 全部被占用'); - throw new Error('无法找到可用的 MySQL 端口（3306-3405 全部被占用）'); - } - - if (this.mysqlPort !== 3306) { - this.logWindowManager.addLog('warn', `MySQL 默认端口 3306 已被占用，自动切换到端口: ${this.mysqlPort}`); - } else { - this.logWindowManager.addLog('success', `MySQL 将使用默认端口: ${this.mysqlPort}`); - } - - logger.info(`[lifecycle] MySQL will use port: ${this.mysqlPort}`); - this.startupManager.updateProgress('check-mysql-port', { mysqlPort: this.mysqlPort }); - await this.sleep(500); - - // 步骤3: 启动 MySQL if (config.mysql && config.mysql.enable && config.mysql.autoStart) { - this.startupManager.updateProgress('start-mysql', { mysqlPort: this.mysqlPort }); - this.logWindowManager.addLog('mysql', `正在启动 MySQL，端口: ${this.mysqlPort}`); + this.startupManager.updateProgress('check-mysql-port'); + this.logWindowManager.addLog('system', '▶ 步骤5: 启动 MySQL 服务管理器...'); - this.mysqlManager = new MySQLManager(); + this.mysqlServiceManager = new MySQLServiceManager(this.logWindowManager); + this.logWindowManager.addLog('system', '正在检查 MySQL 服务状态...'); - // 监听 MySQL 输出 - const actualPort = await this.mysqlManager.start(this.mysqlPort); - this.setupMySQLLogging(this.mysqlManager.process); - - logger.info(`[lifecycle] MySQL started on port: ${actualPort}`); - this.logWindowManager.addLog('success', `MySQL 已启动，端口: ${actualPort}`); - - // 步骤4: 等待 MySQL 就绪 - this.startupManager.updateProgress('wait-mysql', { mysqlPort: actualPort }); - this.logWindowManager.addLog('mysql', '等待 MySQL 就绪...'); - - const mysqlReady = await PortChecker.waitForPort(actualPort, 30000); - - if (!mysqlReady) { - this.logWindowManager.addLog('error', `MySQL 启动超时（端口 ${actualPort} 未响应）`); - throw new Error(`MySQL 启动超时（端口 ${actualPort} 未响应）`); + try { + // 使用服务管理器确保MySQL服务运行 + this.logWindowManager.addLog('system', '▶ 步骤6: 确保 MySQL 服务运行中...'); + this.mysqlPort = await this.mysqlServiceManager.ensureServiceRunning( + PortChecker.findAvailablePort.bind(PortChecker), + PortChecker.waitForPort.bind(PortChecker) + ); + + logger.info(`[lifecycle] MySQL service running on port: ${this.mysqlPort}`); + this.logWindowManager.addLog('success', `✓ MySQL 服务已就绪，端口: ${this.mysqlPort}`); + this.startupManager.updateProgress('wait-mysql', { mysqlPort: this.mysqlPort }); + await this.sleep(500); + } catch (error) { + logger.error('[lifecycle] MySQL error:', error); + this.logWindowManager.addLog('error', `MySQL 错误: ${error.message}`); + throw error; } - - logger.info('[lifecycle] MySQL is ready'); - this.logWindowManager.addLog('success', 'MySQL 已就绪！'); - await this.sleep(500); } // 步骤5: 检测 Java 端口 + this.logWindowManager.addLog('system', '▶ 步骤7: 检测可用的 Java 端口（从18092开始）...'); this.startupManager.updateProgress('check-java-port', { mysqlPort: this.mysqlPort }); - this.logWindowManager.addLog('system', '正在检测可用的 Java 端口（从18092开始）...'); this.javaPort = await PortChecker.findAvailablePort(18092, 100); @@ -152,13 +135,30 @@ class Lifecycle { throw new Error('无法找到可用的后端服务端口（18092-18191 全部被占用）'); } + // 步骤5.5: 检测 WebSocket 端口 + this.logWindowManager.addLog('system', '▶ 步骤8: 检测可用的 WebSocket 端口（从7777开始）...'); + + this.websocketPort = await PortChecker.findAvailablePort(7777, 100); + + if (this.websocketPort === -1) { + this.logWindowManager.addLog('error', 'WebSocket 端口检测失败：7777-7876 全部被占用'); + throw new Error('无法找到可用的 WebSocket 端口（7777-7876 全部被占用）'); + } + if (this.javaPort !== 18092) { - this.logWindowManager.addLog('warn', `Java 默认端口 18092 已被占用，自动切换到端口: ${this.javaPort}`); + this.logWindowManager.addLog('warn', `⚠ Java 默认端口 18092 已被占用，自动切换到端口: ${this.javaPort}`); } else { - this.logWindowManager.addLog('success', `Java 将使用默认端口: ${this.javaPort}`); + this.logWindowManager.addLog('success', `✓ Java 将使用默认端口: ${this.javaPort}`); + } + + if (this.websocketPort !== 7777) { + this.logWindowManager.addLog('warn', `⚠ WebSocket 默认端口 7777 已被占用，自动切换到端口: ${this.websocketPort}`); + } else { + this.logWindowManager.addLog('success', `✓ WebSocket 将使用默认端口: ${this.websocketPort}`); } logger.info(`[lifecycle] Spring Boot will use port: ${this.javaPort}`); + logger.info(`[lifecycle] WebSocket will use port: ${this.websocketPort}`); this.startupManager.updateProgress('check-java-port', { mysqlPort: this.mysqlPort, javaPort: this.javaPort @@ -166,28 +166,35 @@ class Lifecycle { await this.sleep(500); // 步骤6: 生成配置文件 + this.logWindowManager.addLog('system', '▶ 步骤9: 生成 Spring Boot 配置文件...'); this.startupManager.updateProgress('generate-config', { mysqlPort: this.mysqlPort, - javaPort: this.javaPort + javaPort: this.javaPort, + websocketPort: this.websocketPort }); const configGenerator = new ConfigGenerator(); const { configPath, dataPath } = await configGenerator.generateConfig({ mysqlPort: this.mysqlPort, javaPort: this.javaPort, + websocketPort: this.websocketPort, mysqlPassword: 'njcnpqs' }); logger.info(`[lifecycle] Configuration generated at: ${configPath}`); logger.info(`[lifecycle] Data directory: ${dataPath}`); + this.logWindowManager.addLog('success', `✓ 配置文件已生成: ${configPath}`); + this.logWindowManager.addLog('system', ` 数据目录: ${dataPath}`); this.startupManager.updateProgress('generate-config', { mysqlPort: this.mysqlPort, javaPort: this.javaPort, + websocketPort: this.websocketPort, dataPath: dataPath }); await this.sleep(500); // 步骤7: 启动 Spring Boot + this.logWindowManager.addLog('system', '▶ 步骤10: 启动 Spring Boot 应用...'); this.startupManager.updateProgress('start-java', { mysqlPort: this.mysqlPort, javaPort: this.javaPort, @@ -197,6 +204,7 @@ class Lifecycle { await this.startSpringBoot(configPath); // 步骤8: 等待 Spring Boot 就绪 + this.logWindowManager.addLog('system', '▶ 步骤11: 等待 Spring Boot 就绪（最多60秒）...'); this.startupManager.updateProgress('wait-java', { mysqlPort: this.mysqlPort, javaPort: this.javaPort, @@ -207,13 +215,16 @@ class Lifecycle { if (!javaReady) { logger.warn(`[lifecycle] Spring Boot 启动超时，但继续启动应用`); + this.logWindowManager.addLog('warn', '⚠ Spring Boot 启动超时（60秒），但应用将继续启动'); } else { logger.info('[lifecycle] Spring Boot is ready'); + this.logWindowManager.addLog('success', '✓ Spring Boot 启动成功！'); } await this.sleep(1000); // 步骤9: 完成 + this.logWindowManager.addLog('system', '▶ 步骤12: 启动完成，准备显示主窗口...'); this.startupManager.updateProgress('done', { mysqlPort: this.mysqlPort, javaPort: this.javaPort, @@ -225,6 +236,7 @@ class Lifecycle { this.logWindowManager.addLog('success', '✓ NPQS9100 启动完成！所有服务正常运行'); this.logWindowManager.addLog('system', `✓ MySQL 端口: ${this.mysqlPort}`); this.logWindowManager.addLog('system', `✓ Java 端口: ${this.javaPort}`); + this.logWindowManager.addLog('system', `✓ WebSocket 端口: ${this.websocketPort}`); this.logWindowManager.addLog('system', `✓ 数据目录: ${dataPath}`); this.logWindowManager.addLog('system', '='.repeat(60)); this.logWindowManager.addLog('system', '应用即将启动...'); @@ -239,13 +251,41 @@ class Lifecycle { const win = getMainWindow(); win.show(); win.focus(); - - // 添加主窗口关闭事件监听 - win.on('close', async () => { - logger.info('[lifecycle] Main window closing, cleaning up...'); - await this.cleanup(); + + // 窗口关闭时，使用 Electron 原生对话框确认 + win.on('close', async (event) => { + if (global.isConfirmedExit) { + logger.info('[lifecycle] Exit already confirmed, proceeding'); + return; + } + + event.preventDefault(); + logger.info('[lifecycle] Window close intercepted, showing exit confirm dialog'); + + const { dialog } = require('electron'); + const { response } = await dialog.showMessageBox(win, { + type: 'question', + buttons: ['取消', '退出'], + defaultId: 1, + cancelId: 0, + title: '退出确认', + message: '确定要退出应用吗？', + noLink: true + }); + + if (response === 1) { + logger.info('[lifecycle] User confirmed exit'); + global.isConfirmedExit = true; + await this.cleanup(); + if (win && !win.isDestroyed()) { + win.destroy(); + } + app.quit(); + } else { + logger.info('[lifecycle] User cancelled exit'); + } }); - + // 立即刷新一次，确保显示最新内容 setTimeout(() => { if (win && !win.isDestroyed()) { @@ -323,10 +363,8 @@ class Lifecycle { this.logWindowManager.addLog('system', '正在停止 Spring Boot...'); } - // 设置超时，3秒后强制继续 - const stopPromise = this.javaRunner.stopSpringBoot(); - const timeoutPromise = new Promise(resolve => setTimeout(resolve, 3000)); - await Promise.race([stopPromise, timeoutPromise]); + // 停止 Java 进程（内部已有完整的等待和清理逻辑） + await this.javaRunner.stopSpringBoot(); logger.info('[lifecycle] Spring Boot stopped'); if (this.logWindowManager && this.logWindowManager.logWindow && !this.logWindowManager.logWindow.isDestroyed()) { @@ -337,37 +375,30 @@ class Lifecycle { } } - // 停止 MySQL - const config = getConfig(); - if (config.mysql && config.mysql.enable && config.mysql.autoStart) { + // 停止 MySQL 进程（进程模式） + if (this.mysqlServiceManager) { try { - logger.info('[lifecycle] Stopping MySQL...'); + logger.info('[lifecycle] Stopping MySQL process...'); if (this.logWindowManager && this.logWindowManager.logWindow && !this.logWindowManager.logWindow.isDestroyed()) { - this.logWindowManager.addLog('system', '正在停止 MySQL（最多等待10秒）...'); + this.logWindowManager.addLog('system', '正在停止 MySQL...'); } - - if (this.mysqlManager) { - // MySQL 的 stop() 方法内部使用 mysqladmin shutdown（最多10秒） - // 设置12秒超时作为保险 - const stopPromise = this.mysqlManager.stop(); - const timeoutPromise = new Promise(resolve => setTimeout(resolve, 12000)); - await Promise.race([stopPromise, timeoutPromise]); - } - - logger.info('[lifecycle] MySQL stopped'); + + await this.mysqlServiceManager.stopMySQLProcess(); + + logger.info('[lifecycle] MySQL process stopped'); if (this.logWindowManager && this.logWindowManager.logWindow && !this.logWindowManager.logWindow.isDestroyed()) { this.logWindowManager.addLog('success', 'MySQL 已停止'); - this.logWindowManager.addLog('system', '清理完成，应用即将退出'); - this.logWindowManager.addLog('system', '='.repeat(60)); } } catch (error) { logger.error('[lifecycle] Failed to stop MySQL:', error); - if (this.logWindowManager && this.logWindowManager.logWindow && !this.logWindowManager.logWindow.isDestroyed()) { - this.logWindowManager.addLog('error', 'MySQL 停止失败: ' + error.message); - } } } + if (this.logWindowManager && this.logWindowManager.logWindow && !this.logWindowManager.logWindow.isDestroyed()) { + this.logWindowManager.addLog('system', '清理完成，应用即将退出'); + this.logWindowManager.addLog('system', '='.repeat(60)); + } + // 等待500ms让用户看到清理日志 await this.sleep(500); @@ -384,35 +415,6 @@ class Lifecycle { logger.info('[lifecycle] Cleanup completed'); } - /** - * 设置 MySQL 日志监听 - */ - setupMySQLLogging(mysqlProcess) { - if (!mysqlProcess) return; - - mysqlProcess.stdout.on('data', (data) => { - const output = data.toString().trim(); - if (output) { - // 根据内容判断日志类型 - if (output.includes('[ERROR]') || output.includes('ERROR')) { - this.logWindowManager.addLog('error', `[MySQL] ${output}`); - } else if (output.includes('[Warning]') || output.includes('WARNING')) { - this.logWindowManager.addLog('warn', `[MySQL] ${output}`); - } else if (output.includes('ready for connections')) { - this.logWindowManager.addLog('success', `[MySQL] ${output}`); - } else { - this.logWindowManager.addLog('mysql', `[MySQL] ${output}`); - } - } - }); - - mysqlProcess.stderr.on('data', (data) => { - const output = data.toString().trim(); - if (output) { - this.logWindowManager.addLog('warn', `[MySQL Error] ${output}`); - } - }); - } /** * 启动 Spring Boot 应用 @@ -495,56 +497,56 @@ class Lifecycle { * main window have been loaded */ async windowReady() { - logger.info('[lifecycle] window-ready'); - if (ps.isProd()) { - // 创建日志窗口 - this.logWindowManager = new LogWindowManager(); - this.logWindowManager.createLogWindow(); - this.logWindowManager.addLog('system', '='.repeat(60)); - this.logWindowManager.addLog('system', 'NPQS9100 启动中...'); - this.logWindowManager.addLog('system', '='.repeat(60)); + logger.info('[lifecycle] window-ready hook triggered'); - // 创建 Loading 窗口 - this.startupManager = new StartupManager(); - this.startupManager.createLoadingWindow(); + // 进程模式不需要管理员权限检查 - // 开始启动流程 - try { - await this.startApplication(); - } catch (error) { - logger.error('[lifecycle] Failed to start application:', error); - this.logWindowManager.addLog('error', `启动失败: ${error.message}`); - this.logWindowManager.addLog('system', '请检查日志窗口了解详细错误信息'); - this.startupManager.showError(error.message || '启动失败，请查看日志'); + // 创建日志管理器（但不显示窗口，仅用于写日志文件） + logger.info('[lifecycle] Creating log window manager...'); + this.logWindowManager = new LogWindowManager(); + // this.logWindowManager.createLogWindow(); // ← 注释掉，不创建窗口 + this.logWindowManager.addLog('system', '='.repeat(80)); + this.logWindowManager.addLog('system', 'NPQS9100 应用启动'); + this.logWindowManager.addLog('system', '='.repeat(80)); - // 显示错误5秒后关闭Loading窗口，但不关闭日志窗口 - setTimeout(() => { - this.startupManager.closeLoadingWindow(); - - // 即使启动失败，也显示主窗口（但用户可能需要手动修复问题） - const win = getMainWindow(); - win.show(); - win.focus(); - - // 添加主窗口关闭事件监听 - win.on('close', async () => { - logger.info('[lifecycle] Main window closing (after error), cleaning up...'); - await this.cleanup(); - }); - - this.logWindowManager.addLog('warn', '应用已启动，但部分服务可能未正常运行'); - }, 5000); - } - } else { - const win = getMainWindow(); - const {windowsOption} = getConfig(); - if (windowsOption.show == false) { - win.once('ready-to-show', () => { - win.show(); - win.focus(); - }) - } + // 创建 Loading 窗口 + logger.info('[lifecycle] Creating startup manager and loading window...'); + this.startupManager = new StartupManager(); + this.startupManager.createLoadingWindow(); + this.logWindowManager.addLog('system', '='.repeat(60)); + this.logWindowManager.addLog('system', 'NPQS9100 启动中...'); + this.logWindowManager.addLog('system', '='.repeat(60)); + // 开始启动流程 + logger.info('[lifecycle] Starting application flow...'); + try { + await this.startApplication(); + } catch (error) { + logger.error('[lifecycle] Failed to start application:', error); + this.logWindowManager.addLog('error', `启动失败: ${error.message}`); + this.logWindowManager.addLog('system', '请检查日志窗口了解详细错误信息'); + this.startupManager.showError(error.message || '启动失败，请查看日志'); + + // 显示错误5秒后关闭Loading窗口，但不关闭日志窗口 + setTimeout(() => { + this.startupManager.closeLoadingWindow(); + + // 即使启动失败，也显示主窗口（但用户可能需要手动修复问题） + const win = getMainWindow(); + win.show(); + win.focus(); + + // 启动失败时，允许用户正常关闭窗口（不强制托盘） + // 因为可能托盘未创建，或用户想直接退出 + win.on('close', async (event) => { + logger.info('[lifecycle] Window closing (after error), cleaning up...'); + // 不阻止关闭，执行清理 + await this.cleanup(); + }); + + this.logWindowManager.addLog('warn', '应用已启动，但部分服务可能未正常运行'); + this.logWindowManager.addLog('system', '您可以点击 X 关闭应用'); + }, 5000); } // 主窗口初始化但不显示，等待启动流程完成后再显示 @@ -556,10 +558,7 @@ class Lifecycle { */ async beforeClose() { logger.info('[lifecycle] before-close hook triggered'); - if (ps.isProd()) { - await this.cleanup(); - } - + await this.cleanup(); } } Lifecycle.toString = () => '[class Lifecycle]'; diff --git a/frontend/.env.development b/frontend/.env.development index 775678d..f43557d 100644 --- a/frontend/.env.development +++ b/frontend/.env.development @@ -20,8 +20,8 @@ VITE_API_URL=/api # 开发环境跨域代理，支持配置多个 #VITE_PROXY=[["/api","http://127.0.0.1:18092/"]] -VITE_PROXY=[["/api","http://192.168.1.124:18092/"]] -#VITE_PROXY=[["/api","http://192.168.1.125:18092/"]] +#VITE_PROXY=[["/api","http://192.168.1.124:18092/"]] +VITE_PROXY=[["/api","http://192.168.1.125:18092/"]] # VITE_PROXY=[["/api","http://192.168.1.138:8080/"]]张文 # 开启激活验证 -VITE_ACTIVATE_OPEN=false \ No newline at end of file +VITE_ACTIVATE_OPEN=true \ No newline at end of file diff --git a/frontend/.env.production b/frontend/.env.production index 0d6f9c7..2822720 100644 --- a/frontend/.env.production +++ b/frontend/.env.production @@ -25,4 +25,4 @@ VITE_PWA=true #VITE_API_URL="/api" # 打包时用 VITE_API_URL="http://127.0.0.1:18092/" # 开启激活验证 -VITE_ACTIVATE_OPEN=false \ No newline at end of file +VITE_ACTIVATE_OPEN=true \ No newline at end of file diff --git a/frontend/src/App.vue b/frontend/src/App.vue index 957bd38..8d37c8c 100644 --- a/frontend/src/App.vue +++ b/frontend/src/App.vue @@ -1,5 +1,6 @@