Skip to content

VERIFICATION_STEPS.md

Latest commit

 

History

History
244 lines (181 loc) · 6.15 KB

VERIFICATION_STEPS.md

File metadata and controls

244 lines (181 loc) · 6.15 KB

Nice Today 应用打包验证步骤

构建状态

✅ 前端构建完成 - 文件位于 frontend/build/ ✅ 前端文件已复制到 electron/public/ 🔄 Electron应用正在构建中 - 请等待构建完成

验证步骤

第一步：确认构建完成

  1. 检查构建输出目录：

    cd E:\WorkSource\nice_today_app\electron
dir dist

  2. 应该看到以下文件/目录：

    • win-unpacked/ - 未打包的应用目录
    • Nice Today Setup 1.0.0.exe - 安装程序（如果构建成功）

第二步：验证应用文件结构

  1. 检查未打包应用目录：

    dir electron\dist\win-unpacked

  2. 应该包含：

    • Nice Today.exe - 主执行文件
    • resources/ - 资源目录
      • app.asar - 打包的应用文件
      • app/ - 或未打包的应用文件
    • locales/ - 语言文件
    • 其他依赖文件

第三步：验证前端资源

  1. 检查前端文件是否正确打包：

    dir electron\public\static\js
dir electron\public\static\css

  2. 应该看到：

    • main.*.js - 主JavaScript文件
    • main.*.css - 主CSS文件
    • index.html - HTML入口文件

第四步：运行应用测试

方法1：运行未打包版本（推荐用于测试）

  1. 直接运行可执行文件：

    cd electron\dist\win-unpacked
.\Nice Today.exe

  2. 或者使用完整路径：

    Start-Process "E:\WorkSource\nice_today_app\electron\dist\win-unpacked\Nice Today.exe"

方法2：安装并运行

  1. 运行安装程序：

    cd electron\dist
.\Nice Today Setup 1.0.0.exe

  2. 按照安装向导完成安装

  3. 从开始菜单或桌面快捷方式启动应用

第五步：功能验证清单

启动应用后，请验证以下功能：

✅ 基础功能验证

  • 应用启动

    • 应用能够正常启动，无错误提示
    • 窗口正常显示，无白屏或加载错误
    • 标题栏显示 "Nice Today" 或 "人体生物节律分析"

  • 页面加载

    • 页面能够正常加载，显示主界面
    • 没有JavaScript错误（按F12打开开发者工具检查控制台）
    • CSS样式正常显示

✅ 服务初始化验证

  • 服务状态检查

    • 页面顶部显示服务状态（"✅ 所有服务就绪" 或类似提示）
    • 如果显示"⚠️ 部分服务异常"，检查具体哪些服务异常

  • 默认数据加载

    • 应用启动后自动显示默认出生日期（1991-01-01）的生物节律数据
    • 生物节律图表正常显示
    • 今日数据正常显示
    • 7天后数据正常显示

✅ 生物节律功能验证

  • 数据计算

    • 选择一个新的出生日期，数据能够正确更新
    • 图表能够正确显示节律曲线
    • 体力、情绪、智力三个节律值都能正确显示

  • 日期选择

    • 日期选择器能够正常打开
    • 能够选择日期
    • 选择日期后数据能够自动更新

  • 数据展示

    • 生物节律图表正常渲染
    • 今日建议正常显示
    • 科学依据信息正常显示

✅ 其他功能验证

  • 标签切换

    • 能够切换到"玛雅日历"标签
    • 能够切换到"穿衣饮食指南"标签
    • 标签内容正常显示

  • 深色模式

    • 深色模式切换按钮可见
    • 能够切换深色/浅色模式
    • 切换后界面正常显示

第六步：错误排查

如果遇到问题，请检查：

  1. 应用无法启动

    • 检查是否有错误提示
    • 查看Windows事件查看器
    • 检查防病毒软件是否阻止

  2. 页面白屏或加载错误

    • 按F12打开开发者工具
    • 查看Console标签页的错误信息
    • 查看Network标签页，检查资源加载情况

  3. 服务未就绪

    • 检查控制台是否有服务初始化错误
    • 验证electronAPI是否正常暴露
    • 检查IPC通信是否正常

  4. 数据无法加载

    • 检查控制台是否有API调用错误
    • 验证后端服务是否正常初始化
    • 检查数据格式是否正确

第七步：性能验证

  • 应用启动时间 < 5秒
  • 页面加载时间 < 3秒
  • 数据计算响应时间 < 1秒
  • 内存使用正常（< 500MB）

第八步：打包验证

如果所有功能正常，可以验证打包文件：

  1. 检查安装程序

    dir electron\dist\*.exe

  2. 验证文件大小

    • 安装程序应该在合理范围内（通常50-200MB）
    • 未打包目录应该在合理范围内

  3. 测试安装程序

    • 在另一台干净的Windows机器上测试安装
    • 验证安装后应用能够正常运行

常见问题

Q: 构建失败，提示文件被占用

A: 关闭所有相关进程，删除dist目录后重新构建：

Get-Process | Where-Object {$_.Path -like "*nice_today_app*"} | Stop-Process -Force
Remove-Item -Recurse -Force electron\dist
cd electron
npm run dist

Q: 应用启动后显示白屏

A:

  1. 检查前端文件是否正确复制到electron/public
  2. 检查index.html中的JS/CSS路径是否正确
  3. 打开开发者工具查看具体错误

Q: 服务未就绪

A:

  1. 检查electron/main.js中服务初始化代码
  2. 检查preload.js中API暴露代码
  3. 查看控制台日志确认服务状态

Q: 数据无法加载

A:

  1. 检查desktopService是否正确调用IPC
  2. 验证后端服务是否正常初始化
  3. 检查数据格式是否匹配前端期望

构建命令总结

# 1. 构建前端
cd frontend
npm run build

# 2. 复制前端文件到electron
cd ..
Copy-Item -Recurse -Force frontend\build\* electron\public\

# 3. 构建Electron应用
cd electron
npm run dist

# 4. 运行测试
cd dist\win-unpacked
.\Nice Today.exe

验证完成确认

完成所有验证步骤后，请确认：

  • 所有基础功能正常
  • 所有服务正常初始化
  • 默认数据能够自动加载
  • 用户交互功能正常
  • 无严重错误或警告
  • 性能表现良好

如果所有项目都通过，说明应用已成功打包并可以发布！