paho.mqtt.cpp mqtt客户端

### 关于 `paho.mqtt.cpp` MQTT 客户端

#### 简介
`paho.mqtt.cpp` 是一款用于 C++ 开发环境下的 MQTT 协议客户端库，旨在简化 IoT 设备与服务器之间的消息传递过程。此库构建在 `paho.mqtt.c` 之上，提供了面向对象接口以便更好地融入现代 C++ 应用程序开发流程中[^2]。

#### 获取方式
可以从指定的开源平台获取已经编译好适用于 Windows 平台 (通过 Visual Studio 2019 编译) 的版本，这使得开发者能够快速上手并测试功能[^4]。

#### 集成方法
为了将 `paho.mqtt.cpp` 整合进现有项目当中，通常需要先移植基础组件——即来自 `MQTTPacket/src` 下的所有源码文件以及位于 `MQTTClient-C/src` 文件夹内的核心实现部分 (`MQTTClient.c`, `MQTTClient.h`) 和特定操作系统支持模块（如 Linux 版本下的 `MQTTLinux.c`, `MQTTLinux.h`）。对于应用层面上的具体实践案例，则可以参照样例代码 `stdoutsub.c` 来理解如何订阅主题并处理接收到的消息[^1]。

#### 示例代码展示
下面给出一段简单的例子来演示怎样利用 `paho.mqtt.cpp` 创建一个基本的发布者：

#include "mqtt/async_client.h"
using namespace std;

int main() {
    const string server_url = "tcp://broker.example.com";
    const string client_id = "example";

    mqtt::async_client sample_client(server_url, client_id);

    try {
        auto connOpts = mqtt::connect_options_builder()
            .clean_session(true)
            .finalize();

        cout << "Connecting to the broker..." << endl;
        sample_client.connect(connOpts)->wait();
        
        // 发布一条消息至 test/topic 主题下
        auto msg = make_shared<mqtt::message>("test/topic", "Hello world!");
        sample_client.publish(msg)->wait();
    
        cout << "Disconnecting from the broker." << endl;
        sample_client.disconnect()->wait();
    } catch(const mqtt::exception& exc){
        cerr << "Error: " << exc.what() << endl;
        return 1;
    }

    return 0;
}

这段代码展示了创建异步模式下的客户端实例、建立连接选项设置、执行连接操作并向指定的主题发送消息的过程。此外还加入了异常捕获机制以应对可能出现的问题场景[^5]。