# DEB 打包检查清单 ## 📋 打包前检查 ### 环境检查 - [ ] linuxdeployqt 工具存在：`$HOME/dev/sunvpack-py/bin/linuxdeployqt` - [ ] Qt 5.15.2 已安装：`$HOME/sdk/qt-5.15.2` - [ ] dpkg-dev 已安装：`dpkg-deb --version` - [ ] 项目可以正常编译：`./build.sh` - [ ] 程序可以正常运行：`./run.sh` ### 文件检查 - [ ] `screenlockdemo.desktop` 文件存在且配置正确 - [ ] `debian/control` 包信息完整 - [ ] `debian/copyright` 版权信息正确 - [ ] `debian/changelog` 版本号正确 - [ ] 图标文件准备好（可选）：`icon.png` ### 版本检查 - [ ] 版本号已更新（如果是新版本） - [ ] `make_deb.sh` 中的 VERSION - [ ] `build_deb.sh` 中的 VERSION - [ ] `debian/changelog` 中的版本号 - [ ] `CMakeLists.txt` 中的 VERSION --- ## 🔨 打包过程检查 ### 执行打包 - [ ] 脚本有执行权限：`chmod +x make_deb.sh` - [ ] 运行打包脚本：`./make_deb.sh` - [ ] 打包过程无错误 - [ ] DEB 文件生成成功：`deb_package/screenlockdemo_1.0.0_amd64.deb` ### 包内容检查 ```bash # 查看包信息 dpkg -I deb_package/screenlockdemo_1.0.0_amd64.deb # 查看文件列表 dpkg -c deb_package/screenlockdemo_1.0.0_amd64.deb ``` - [ ] 包信息正确（名称、版本、架构、依赖） - [ ] 包含主程序：`./opt/screenlockdemo/bin/ScreenLockDemo` - [ ] 包含 Qt 库：`./opt/screenlockdemo/lib/libQt5*.so*` - [ ] 包含 Qt 插件：`./opt/screenlockdemo/plugins/platforms/libqxcb.so` - [ ] 包含启动脚本：`./opt/screenlockdemo/screenlockdemo.sh` - [ ] 包含系统命令：`./usr/bin/screenlockdemo` - [ ] 包含 desktop 文件：`./usr/share/applications/screenlockdemo.desktop` - [ ] 包含图标：`./usr/share/icons/hicolor/256x256/apps/screenlockdemo.png` - [ ] 包含控制脚本：`./DEBIAN/control`, `./DEBIAN/postinst` --- ## 🧪 安装测试 ### 基本安装 ```bash sudo dpkg -i deb_package/screenlockdemo_1.0.0_amd64.deb ``` - [ ] 安装成功，无错误 - [ ] 如有依赖问题，运行：`sudo apt-get install -f` - [ ] 文件已安装到正确位置 ### 文件验证 ```bash # 检查安装的文件 ls -la /opt/screenlockdemo/ ls -la /usr/bin/screenlockdemo ls -la /usr/share/applications/screenlockdemo.desktop ``` - [ ] `/opt/screenlockdemo/` 目录存在 - [ ] `/opt/screenlockdemo/bin/ScreenLockDemo` 可执行 - [ ] `/opt/screenlockdemo/lib/` 包含所有 Qt 库 - [ ] `/usr/bin/screenlockdemo` 命令存在 - [ ] 桌面文件已安装 ### 依赖验证 ```bash # 检查库依赖 ldd /opt/screenlockdemo/bin/ScreenLockDemo ``` - [ ] 所有依赖都能找到（not found = 0） - [ ] Qt 库指向 `/opt/screenlockdemo/lib/` - [ ] 系统库正确链接 --- ## 🚀 功能测试 ### 启动测试 - [ ] 命令行启动：`screenlockdemo` 成功 - [ ] 直接运行：`/opt/screenlockdemo/screenlockdemo.sh` 成功 - [ ] 无错误信息，无崩溃 - [ ] 窗口正常显示 ### 界面测试 - [ ] 主窗口正常显示 - [ ] 动画正常播放（旋转圆圈、波浪效果） - [ ] 状态信息显示正确 - [ ] 按钮响应正常 ### 功能测试 - [ ] **锁屏检测**：锁定屏幕（Ctrl+Alt+L） - [ ] 检测器状态显示正常 - [ ] 屏幕锁定状态显示为 "🔒 LOCKED" - [ ] 动画自动停止（Paint 事件禁用） - [ ] **解锁检测**：解锁屏幕 - [ ] 屏幕锁定状态显示为 "🔓 UNLOCKED" - [ ] 动画自动恢复（Paint 事件启用） - [ ] **手动控制** - [ ] "Disable Painting" 按钮可以停止动画 - [ ] "Enable Painting" 按钮可以恢复动画 - [ ] "Reset Frame Count" 按钮可以重置计数器 - [ ] **帧数统计**：计数器正常工作 ### DBus 连接测试 ```bash # 查看程序输出 screenlockdemo 2>&1 | grep -i "dbus\|screensaver\|connected" ``` - [ ] 至少一个 DBus 接口连接成功 - [ ] GNOME ScreenSaver 或 systemd-logind 连接正常 - [ ] 无致命错误 ### 应用菜单测试 - [ ] 在应用程序菜单中可以找到 "Screen Lock Demo" - [ ] 图标显示正常（或默认图标） - [ ] 从菜单启动成功 --- ## 🖼️ 界面测试 ### 桌面集成 - [ ] 桌面快捷方式可用 - [ ] 应用图标显示（更新图标缓存：`sudo gtk-update-icon-cache -f /usr/share/icons/hicolor`） - [ ] 窗口标题正确 - [ ] 任务栏图标正确 --- ## 🔄 卸载测试 ### 卸载 ```bash sudo dpkg -r screenlockdemo ``` - [ ] 卸载成功，无错误 - [ ] `/opt/screenlockdemo/` 已删除 - [ ] `/usr/bin/screenlockdemo` 已删除 - [ ] 桌面文件已删除 - [ ] 图标已删除 ### 清理验证 ```bash # 检查残留文件 ls -la /opt/screenlockdemo/ ls -la /usr/bin/screenlockdemo ``` - [ ] 无残留文件 - [ ] 应用菜单中已移除 --- ## 🌍 兼容性测试 ### 不同 Ubuntu 版本 - [ ] Ubuntu 18.04 LTS - [ ] Ubuntu 20.04 LTS - [ ] Ubuntu 22.04 LTS - [ ] Ubuntu 23.10 / 24.04 ### 不同桌面环境 - [ ] GNOME - [ ] KDE Plasma - [ ] XFCE - [ ] Unity（如适用） ### 架构 - [ ] x86_64 (amd64) - [ ] 其他架构（如需要） --- ## 📊 性能测试 ### 资源占用 ```bash # 监控资源使用 top -p $(pgrep ScreenLockDemo) ``` - [ ] CPU 使用率合理（空闲时 < 5%，动画时 < 20%） - [ ] 内存使用合理（< 100MB） - [ ] 无内存泄漏（长时间运行） ### 稳定性 - [ ] 运行 1 小时无崩溃 - [ ] 多次锁屏/解锁循环测试（> 10 次） - [ ] 快速锁定/解锁测试 - [ ] 无僵死进程 --- ## 📦 包质量检查 ### 包大小 ```bash du -h deb_package/screenlockdemo_1.0.0_amd64.deb ``` - [ ] 包大小合理（通常 50-80MB） - [ ] 如需优化，考虑 strip 符号 ### 包结构 ```bash # 检查 Lintian（Debian 包检查工具） lintian deb_package/screenlockdemo_1.0.0_amd64.deb ``` - [ ] 无严重错误（E:） - [ ] 警告（W:）可接受 - [ ] 信息（I:）已知晓 ### 元数据 - [ ] 包名称正确：`screenlockdemo` - [ ] 版本号正确：`1.0.0` - [ ] 架构正确：`amd64` - [ ] 维护者信息完整 - [ ] 描述清晰准确 - [ ] 依赖列表正确 --- ## 📝 文档检查 ### 用户文档 - [ ] README.md 完整且最新 - [ ] DEB_PACKAGE.md 说明清晰 - [ ] PACKAGING_README.md 快速入门完整 ### 技术文档 - [ ] 打包脚本有注释 - [ ] desktop 文件配置正确 - [ ] control 文件信息准确 --- ## 🚢 发布准备 ### 最终检查 - [ ] 所有功能正常 - [ ] 无已知 bug - [ ] 文档完整 - [ ] 版本号正确 - [ ] changelog 已更新 ### 发布材料 - [ ] DEB 包文件 - [ ] 校验和（MD5/SHA256） ```bash md5sum deb_package/screenlockdemo_1.0.0_amd64.deb sha256sum deb_package/screenlockdemo_1.0.0_amd64.deb ``` - [ ] 安装说明 - [ ] 发布说明 - [ ] 已知问题列表（如有） --- ## ✅ 最终确认 在发布前，确认以下声明： - [ ] ✓ 我已在测试环境中完整安装并测试了 DEB 包 - [ ] ✓ 所有核心功能都经过验证并正常工作 - [ ] ✓ 包可以正常安装和卸载，无残留 - [ ] ✓ 至少在一个目标 Ubuntu 版本上测试通过 - [ ] ✓ 文档准确反映了当前版本的功能 - [ ] ✓ 版本号和 changelog 已更新 - [ ] ✓ 无已知的严重 bug --- ## 📞 问题跟踪 如果发现问题，记录以下信息： - 问题描述： - 重现步骤： - 系统环境： - 错误信息： - 解决方案： --- ## 🎯 快速命令参考 ```bash # 打包 ./make_deb.sh # 查看包信息 dpkg -I deb_package/screenlockdemo_1.0.0_amd64.deb dpkg -c deb_package/screenlockdemo_1.0.0_amd64.deb # 安装 sudo dpkg -i deb_package/screenlockdemo_1.0.0_amd64.deb sudo apt-get install -f # 如有依赖问题 # 测试 screenlockdemo ldd /opt/screenlockdemo/bin/ScreenLockDemo # 卸载 sudo dpkg -r screenlockdemo # 校验和 md5sum deb_package/screenlockdemo_1.0.0_amd64.deb sha256sum deb_package/screenlockdemo_1.0.0_amd64.deb ``` --- **检查完成日期**: ___________ **测试人员**: ___________ **版本号**: ___________ **测试环境**: ___________ **结果**: □ 通过 □ 失败 □ 有条件通过 **备注**: