GoldenDict-NG开发环境配置指南

开发环境搭建要点

GoldenDict-NG作为一款基于Qt框架开发的词典软件，其开发环境配置需要注意以下几个关键点：

Qt组件选择

开发GoldenDict-NG需要安装以下Qt组件：

• Qt Creator IDE
• Qt 6.x基础模块
• MSVC2019或GCC编译器
• Qt5兼容模块
• 额外组件包括：
  • Qt图像格式支持
  • Qt多媒体模块
  • Qt定位模块
  • Qt语音模块
  • Qt WebChannel
  • Qt WebEngine

编译器配置

特别注意，Qt WebEngine不支持MinGW编译器，必须使用MSVC编译器。在Qt Creator中需要正确配置构建套件(kits)，确保使用MSVC而非MinGW。

常见问题解决方案

EPWING支持问题

当使用CMake构建时，如果遇到EPWING相关错误，有两种解决方案：

1. 初始化git子模块
2. 在CMake配置中添加-DWITH_EPWING_SUPPORT=OFF参数

zlib1.dll缺失问题

编译成功后运行时可能遇到zlib1.dll缺失错误，解决方法有：

1. 手动将winlibs/lib/zlib1.dll复制到可执行文件目录
2. 将Qt的lib目录添加到系统PATH环境变量
3. 使用Qt Creator的"部署"目标自动复制依赖库

构建配置建议

在Qt Creator中配置构建时，建议：

1. 使用CMake而非qmake构建系统
2. 在CMake配置视图中设置参数，而非直接编辑CMakeLists.txt
3. 确保选择了正确的构建套件(MSVC)

开发环境验证

成功配置的开发环境应能：

1. 完整编译项目无错误
2. 启动GoldenDict-NG主界面
3. 加载词典文件进行测试

通过以上步骤，开发者可以建立起完整的GoldenDict-NG开发环境，为后续的功能开发和调试打下基础。