Qt 5.9.1 MinGW 32位下，手把手搞定周立功CAN二次开发库的加载与配置-编程实验室

Qt 5.9.1 MinGW 32位环境下周立功CAN二次开发库的实战配置指南

在嵌入式开发领域，CAN总线通信一直是工业控制和汽车电子系统中的核心技术。对于使用Qt框架进行CAN通信开发的工程师来说，如何正确配置硬件厂商提供的二次开发库往往是项目起步阶段的第一道门槛。本文将针对Qt 5.9.1 MinGW 32位这一特定环境，详细解析周立功CAN开发库的完整配置流程，帮助开发者避开常见陷阱。

1. 环境准备与版本锁定

在开始配置之前，必须确保开发环境的每个组件版本完全匹配。这是Qt与硬件库集成中最容易出错的关键点。

1.1 工具链版本确认

首先检查您的Qt安装版本是否确认为5.9.1 MinGW 32位。可以通过Qt Creator的"帮助→关于Qt Creator"菜单查看详细版本信息。特别需要注意的是：

Qt Creator版本：4.3.1
Qt版本：5.9.1
编译器：MinGW 32-bit

提示：如果使用Qt在线安装器，务必在安装时勾选"Qt 5.9.1→MinGW 32-bit"组件，避免版本不匹配问题。

1.2 开发库下载与解压

从周立功官网下载对应的二次开发库时，必须选择与Qt环境匹配的32位(X86)版本。解压后的文件夹通常包含以下关键内容：

ControlCAN二次开发库/ ├── ControlCANx86/ │ ├── ControlCAN.dll │ ├── ControlCAN.h │ ├── ControlCAN.lib │ └── kerneldlls/ │ ├── CHA0.dll │ ├── CHA1.dll │ └── ...其他内核级DLL

2. 工程文件结构配置

正确的文件放置位置是保证库成功加载的基础。不同于一般的Qt库配置，周立功CAN库有其特殊的路径要求。

2.1 头文件与库文件放置

在您的Qt项目目录中，需要将以下文件放置到指定位置：

ControlCAN.h：直接放在项目根目录下（与.pro文件同级）
ControlCAN.lib：同样放在项目根目录下

对应的项目结构应该如下所示：

MyCANProject/ ├── ControlCAN.h ├── ControlCAN.lib ├── MyCANProject.pro └── main.cpp

2.2 运行时依赖文件配置

动态链接库和内核级DLL需要放置在构建输出的debug目录中。这个路径通常是：

build-MyCANProject-Desktop_Qt_5_9_1_MinGW_32bit-Debug/debug/

在该目录下，需要放置：

ControlCAN.dll
kerneldlls/文件夹（包含所有子DLL）

3. Qt项目文件(.pro)配置

正确的.pro文件配置是连接Qt工程与硬件库的桥梁。以下是必须的配置项：

win32: LIBS += -L$$PWD/./ -lControlCAN INCLUDEPATH += $$PWD/. DEPENDPATH += $$PWD/.

这段配置做了三件事：

添加库文件搜索路径(-L$$PWD/./)
链接ControlCAN库(-lControlCAN)
添加头文件包含路径

注意：不要勾选"为debug版本添加'd'作为后缀"选项，因为周立功的库文件命名不遵循这一约定。

4. 常见编译错误排查

即使按照上述步骤配置，仍可能遇到各种编译和运行时问题。以下是几个典型问题及其解决方案：

4.1 "无法找到ControlCAN.dll"错误

现象：程序编译通过，但运行时弹出缺失DLL的错误对话框。

解决方案：

确认ControlCAN.dll确实存在于构建输出的debug目录中
检查kerneldlls文件夹是否完整复制到了debug目录
确保没有多个不同版本的DLL混用

4.2 "未定义的引用"链接错误

现象：编译时出现类似"undefined reference to `_imp__CAN_Init@8'"的错误。

可能原因：

.pro文件中库名称拼写错误
使用了64位库文件而非32位版本
库文件路径配置不正确

排查步骤：

检查.lib文件是否确实存在于项目目录
使用Dependency Walker工具验证.lib文件的架构是否为32位
确认.pro文件中的-lControlCAN拼写完全正确

5. 验证库加载成功的测试代码

配置完成后，可以通过以下简单代码测试库是否加载成功：

#include "ControlCAN.h" #include <QDebug> bool testCANLibrary() { DWORD dwRel; VCI_BOARD_INFO pInfo; dwRel = VCI_OpenDevice(VCI_USBCAN2, 0, 0); if(dwRel != STATUS_OK) { qDebug() << "Open device failed! Error code:" << dwRel; return false; } VCI_CloseDevice(VCI_USBCAN2, 0); qDebug() << "CAN library loaded successfully!"; return true; }

这段代码尝试打开和关闭CAN设备，如果能够输出成功信息，说明库配置完全正确。

6. 高级配置技巧

对于需要更复杂项目结构的开发者，可以考虑以下优化方案：

6.1 使用相对路径管理库文件

在项目根目录下创建3rdparty文件夹存放所有第三方库，然后修改.pro文件：

win32: LIBS += -L$$PWD/3rdparty/ -lControlCAN INCLUDEPATH += $$PWD/3rdparty DEPENDPATH += $$PWD/3rdparty

6.2 自动化部署脚本

对于团队开发环境，可以创建自动复制DLL的构建后步骤。在.pro文件中添加：

win32 { debug { QMAKE_POST_LINK += $$quote(cmd /c xcopy /Y $$PWD/3rdparty/ControlCANx86/*.dll $$OUT_PWD/debug/) QMAKE_POST_LINK += $$quote(cmd /c xcopy /Y $$PWD/3rdparty/ControlCANx86/kerneldlls $$OUT_PWD/debug/kerneldlls /E) } }