0417_QT_code/REGENERATE_MIGRATION.md

重新生成项目后的代码移植方法

这份说明的目标是：

1. 重新新建一个干净的 Qt Widgets 工程。
2. 不沿用旧工程的 .sln / .vcxproj / .vs / x64。
3. 只把当前已经实现好的业务代码移植过去。

这样最稳，也最不容易把旧工程状态带进来。

一、建议的新建方式

在 Visual Studio 里重新新建一个 Qt Widgets Application。

建议保持这些配置：

• Qt：5.13.1
• 平台：x64
• 编译器：和你当前环境一致
• Qt Modules：core;gui;widgets

新工程创建完成后，先确保它能空工程编译通过一次。

二、不要移植的内容

下面这些不要从旧工程复制过去：

• .vs/
• x64/
• 20260320.* 这些中间目录
• 旧的 .sln
• 旧的 .vcxproj
• 旧的 .vcxproj.filters
• 旧的 .vcxproj.user
• Browse.VC.db 一类缓存

原则很简单：

只移植源码，不移植工程缓存和生成物。

三、需要复制过去的目录和文件

把下面这些直接复制到新工程根目录：

• APP/
• DRI/
• LOGIC/
• EXTEN/
• main.cpp

如果你想保留当前这套界面和调试窗口，这些就是最小必需集合。

四、可以不要的旧模板文件

如果新工程自动生成了自己的 MainWindow 或其他模板文件，而你准备直接用当前这套代码，那么这些模板文件可以删掉或从工程里移除。

当前仓库里这些文件不是主链必需：

• _new_keyboard.cpp
• _new_keyboard.h
• _new_keyboard.ui
• _new_keyboard.qrc

它们现在没有参与主入口逻辑。

五、把文件加回新工程的方法

推荐用 Visual Studio 的“添加现有项”。

1. 源文件加入工程

把这些 .cpp 加到新工程：

• APP\\APP_ChatGptButton.cpp
• APP\\APP_DebugPanel.cpp
• APP\\APP_GlassCard.cpp
• APP\\APP_KeyButton.cpp
• APP\\APP_ThemeSwitch.cpp
• APP\\APP_UIWindow.cpp
• DRI\\DRI_DeviceState.cpp
• DRI\\DRI_HidDevice.cpp
• EXTEN\\EXTEN_Theme.cpp
• LOGIC\\LOGIC_DeviceSession.cpp
• LOGIC\\LOGIC_HidProtocol.cpp
• LOGIC\\LOGIC_KeypadModel.cpp
• main.cpp

2. 头文件加入工程

把这些 .h 加到新工程：

• APP\\APP_ChatGptButton.h
• APP\\APP_DebugPanel.h
• APP\\APP_GlassCard.h
• APP\\APP_KeyButton.h
• APP\\APP_ThemeSwitch.h
• APP\\APP_UIWindow.h
• DRI\\DRI_DeviceState.h
• DRI\\DRI_HidDevice.h
• EXTEN\\EXTEN_Theme.h
• LOGIC\\LOGIC_DeviceSession.h
• LOGIC\\LOGIC_HidProtocol.h
• LOGIC\\LOGIC_KeypadModel.h

六、新工程需要保留的工程设置

请确认新工程至少有这些设置：

1. Include 目录

C/C++ -> Additional Include Directories

至少包含：

• $(ProjectDir)

这样代码里的这类包含才能工作：

• #include "APP/APP_UIWindow.h"
• #include "DRI/DRI_HidDevice.h"
• #include "LOGIC/LOGIC_HidProtocol.h"

2. Qt 模块

保持：

• core
• gui
• widgets

3. 字符集

保持：

• Unicode

4. UTF-8 编译

建议保留：

• /utf-8

七、这套代码迁移时有一个好处

当前新增代码已经特意改成了“普通 C++ 回调”，不是自定义 Qt 信号/槽项目项。

这意味着迁移时：

• 不需要额外手工加 QtMoc 条目
• 不需要改 .vcxproj 去注册新 moc 头
• 只要把 .cpp/.h 作为普通源码文件加进去即可

这一步会明显降低“工程能编但 VS 打不开”这类问题。

八、HID 相关设置

DRI\\DRI_HidDevice.cpp 里已经用了：

• #pragma comment(lib, "hid.lib")
• #pragma comment(lib, "setupapi.lib")

所以一般不需要你再手工去 Linker 里加库。

只要是 Windows 桌面工程即可。

九、迁移后你应该先验证什么

迁移完成后，不要先看业务联动，先按这个顺序验证：

1. 工程能正常打开
2. 工程能 Debug|x64 编译通过
3. 程序能启动
4. 主界面正常显示
5. 下方调试窗口正常显示
6. 能枚举到 VID=0x1209 / PID=0x0001 / UsagePage=0xFF00 / Usage=0x0002
7. 能看到收到的原始包
8. 能看到 0x04 包的中文解析

十、最稳的实际操作顺序

推荐直接按下面顺序做：

1. 新建一个全新的 Qt Widgets 工程
2. 先空工程编译一次
3. 关闭 VS
4. 把 APP/DRI/LOGIC/EXTEN/main.cpp 复制过去
5. 删除新模板里不用的 MainWindow 一类文件
6. 打开新工程
7. 用“添加现有项”把上面列出的 .cpp/.h 加入工程
8. 检查 Qt modules 和 include 目录
9. 编译
10. 接设备验证调试窗口

十一、如果你想让我继续帮你做

如果你重新生成了一个新工程目录，我可以直接帮你做这几件事：

1. 把当前代码拷过去
2. 帮你把新 .vcxproj 补成可编译状态
3. 再做一次编译验证

你只要把新工程路径告诉我即可。