Windows下用VS2019和libusb库，手把手教你写一个控制安卓手机的C++程序（附完整源码）

Windows平台下基于libusb的安卓设备底层控制实战指南

在Windows开发环境中直接与安卓设备建立USB通信，绕过标准ADB命令行工具，能够为开发者带来更高效的调试体验和更灵活的自动化控制能力。本文将深入探讨如何利用Visual Studio 2019和libusb库构建一个完整的C++解决方案，实现与安卓设备的底层交互。

1. 开发环境配置与避坑指南

配置Visual Studio 2019与libusb的工作环境是项目成功的第一步。许多开发者在此阶段会遇到各种环境问题，导致后续开发受阻。

libusb库的获取与配置：

• 从官方源获取最新稳定版libusb（推荐1.0.24或更高版本）
• 解压后重点关注以下文件：
  • libusb-1.0.lib（静态库）
  • libusb-1.0.dll（动态链接库）
  • libusb.h（头文件）

在VS2019中配置时，需要特别注意以下几点：

1. 项目属性设置：

   // 确保包含目录正确指向libusb头文件位置 // 示例配置路径（根据实际位置调整）： C/C++ → 常规 → 附加包含目录：$(SolutionDir)third_party\libusb\include

2. 链接器配置：

   // 链接器 → 输入 → 附加依赖项添加： libusb-1.0.lib // 库目录配置示例： 链接器 → 常规 → 附加库目录：$(SolutionDir)third_party\libusb\lib\x86

3. 运行时依赖处理：

   • 将libusb-1.0.dll复制到生成目录（与exe同目录）
   • 或将其放入系统PATH包含的目录中

注意：32位和64位程序需要匹配相应架构的libusb库，混合使用会导致运行时错误。

2. 安卓设备USB通信核心原理

理解ADB over USB的工作原理是开发稳定通信程序的基础。安卓设备通过特定的USB接口类与主机通信：

#define ADB_CLASS 0xFF #define ADB_SUBCLASS 0x42 #define ADB_PROTOCOL 0x01

通信过程采用BULK传输模式，这种模式特点包括：

• 高带宽利用
• 无保证的传输延迟
• 错误检测和重传机制

通信端点识别策略：

设备枚举过程中，我们需要：

1. 获取设备列表
2. 遍历设备接口
3. 匹配ADB特定接口类
4. 识别通信端点

3. 工程化实现与代码封装

良好的代码结构能够提升项目的可维护性和扩展性。我们采用分层设计：

核心模块划分：

• 设备管理层：负责设备发现、连接和状态维护
• 协议处理层：实现ADB协议封装和解析
• 应用层：提供业务逻辑接口

关键数据结构示例：

struct AdbDeviceHandle { libusb_device_handle* dev_handle; unsigned char read_endpoint; unsigned char write_endpoint; int zero_mask; DeviceState state; }; struct AdbMessage { uint32_t command; uint32_t arg0; uint32_t arg1; uint32_t data_length; uint32_t data_check; uint32_t magic; };

设备初始化流程：

1. 初始化libusb上下文
2. 扫描并匹配ADB接口
3. 申请接口控制权
4. 配置通信端点

bool InitializeAdbDevice(AdbDeviceHandle* handle) { libusb_init(NULL); if (!FindAdbInterface(handle)) { return false; } if (libusb_claim_interface(handle->dev_handle, 0) != LIBUSB_SUCCESS) { std::cerr << "Failed to claim interface" << std::endl; return false; } handle->state = DEVICE_INITIALIZED; return true; }

4. 实战：实现屏幕控制功能

基于上述基础，我们可以实现具体的设备控制功能。以屏幕控制为例：

熄屏命令实现流程：

1. 建立USB连接
2. 发送认证密钥
3. 构造并发送ADB命令包
4. 处理设备响应

void SendScreenOffCommand(AdbDeviceHandle* handle) { AdbPacket packet; packet.message.command = A_OPEN; packet.message.arg0 = A_VERSION; packet.message.arg1 = 0; const char* command = "shell:input keyevent 26"; packet.message.data_length = strlen(command) + 1; strcpy((char*)packet.data, command); if (SendAdbPacket(handle, &packet) != 0) { std::cerr << "Failed to send screen off command" << std::endl; return; } AdbPacket response; while (ReceiveAdbPacket(handle, &response) == 0) { if (response.message.command == A_OKAY) { std::cout << "Screen turned off successfully" << std::endl; break; } } }

常见问题排查表：

5. 高级技巧与性能优化

提升通信稳定性和效率是生产环境应用的关键：

传输优化策略：

• 使用异步I/O提高吞吐量
• 实现双缓冲减少等待时间
• 合理设置超时参数

错误处理最佳实践：

int HandleUsbError(int error_code) { switch (error_code) { case LIBUSB_ERROR_TIMEOUT: // 实现重试逻辑 return RETRY_COUNT--; case LIBUSB_ERROR_NO_DEVICE: // 设备断开处理 ReinitializeDevice(); return -1; case LIBUSB_ERROR_PIPE: // 端点停止响应 ResetDeviceConnection(); return 0; default: return -1; } }

内存管理要点：

• 预分配通信缓冲区
• 使用RAII管理资源
• 避免频繁内存分配

class AdbPacketBuffer { public: AdbPacketBuffer() { packet = (AdbPacket*)malloc(sizeof(AdbPacket)); } ~AdbPacketBuffer() { free(packet); } AdbPacket* Get() { return packet; } private: AdbPacket* packet; };

在实际项目中，我们发现合理设置超时参数能显著提升用户体验。对于交互式命令，推荐使用200-500ms的超时设置，而对于后台任务，可以适当延长至2-3秒。