QtUsb 安装和配置指南

2026-01-20 02:49:53作者：范垣楠Rhoda

1. 项目基础介绍和主要的编程语言

项目基础介绍

QtUsb 是一个跨平台的 USB 模块，专为 Qt 框架设计。它围绕 libusb-1.0 和 libhidapi 构建，可以作为库使用，也可以直接集成到项目中。QtUsb 提供了对 USB 设备的批量传输、中断传输、热插拔检测、设备枚举和过滤等功能。

主要的编程语言

QtUsb 主要使用 C++ 编程语言，并结合了 CMake 和 Python 进行构建和配置。

2. 项目使用的关键技术和框架

关键技术和框架

Qt 框架：用于跨平台应用程序开发。
libusb-1.0：用于与 USB 设备通信的库。
libhidapi：用于与 HID 设备通信的库。
CMake：用于构建和管理项目。
qmake：用于 Qt 项目的构建。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统已经安装了以下依赖项：

libusb-1.0-0-dev：用于 USB 设备通信。
libhidapi-dev：用于 HID 设备通信。
pkg-config：用于管理库的编译和链接。
Qt 开发环境：包括 Qt Creator 和 qmake。

安装步骤

1. 克隆项目仓库

首先，从 GitHub 克隆 QtUsb 项目到本地：

git clone https://github.com/fpoussin/QtUsb.git
cd QtUsb

2. 构建项目

在 Unix 系统上

创建一个构建目录并进入该目录：
```
mkdir build
cd build
```
使用 qmake 配置项目：
```
qmake ..
```
编译并安装项目：
```
make
sudo make install
```

在 Windows 系统上

下载并安装 Visual Studio 和 Windows SDK。

使用提供的脚本 build_msvc.bat 构建项目：

build_msvc.bat 2017 x64 static C:\Qt\5.14.1\msvc2017_64

3. 配置 Qt Creator

打开 Qt Creator。
在项目文件中添加 QtUsb 模块：
```
qt += usb
```

包含必要的头文件：

#include <QUsbDevice>
#include <QUsbEndpoint>

4. 验证安装

编写一个简单的测试程序，验证 QtUsb 是否正常工作。例如：

#include <QCoreApplication>
#include <QUsbDevice>
#include <QUsbEndpoint>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QUsbDevice device;
    if (device.open(QUsbDevice::ReadWrite)) {
        qDebug() << "Device opened successfully!";
    } else {
        qDebug() << "Failed to open device!";
    }

    return a.exec();
}