# MqttQtWin10

**Repository Path**: GKoSon/MqttQtWin10

## Basic Information

- **Project Name**: MqttQtWin10
- **Description**: QT6.10.1开发MQTT客户端-win10/安卓
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-06
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# MqttQtWin10

## 项目简介

MqttQtWin10 是一个基于 **Qt 6.10.1** 框架开发的跨平台 MQTT 客户端应用程序示例。该项目演示了如何使用 Qt 的 MQTT 模块通过 TCP 或 WebSocket 协议连接到消息代理服务器（Broker），并实现了消息的发布（Publish）与订阅（Subscribe）功能。

## 主要功能

1.  **连接管理**：支持通过 TCP/WebSocket 连接 MQTT Broker，支持 SSL/TLS 安全加密连接。
2.  **消息订阅**：可灵活设置 Topic（主题）并接收来自服务器的消息。
3.  **消息发布**：可向指定 Topic 发布消息内容。
4.  **状态监控**：实时显示客户端连接状态（已连接、断开、错误等）并输出操作日志。
5.  **参数配置**：支持配置服务器 IP、端口、客户端 ID、KeepAlive 心跳间隔等参数。

## 环境依赖

- **Qt 版本**：Qt 6.10.1 (Desktop MinGW 64-bit)
- **构建工具**：CMake 3.16 或更高版本
- **编译器**：MinGW-w64 (GCC)
- **操作系统**：Windows 10 及以上 (开发环境为 Win10)

## 编译与安装

### 1. 环境准备
确保已安装 Qt 6.10.1 完整开发环境（包含 Qt Core, Qt GUI, Qt Widgets, Qt Network 模块）。

### 2. 获取源码
```bash
git clone https://gitee.com/GKoSon/MqttQtWin10.git
cd MqttQtWin10
```

### 3. 编译项目
建议使用 Qt Creator 或 CMake 命令行进行编译：

#### 使用命令行编译
```bash
# 创建构建目录
mkdir build
cd build

# 运行 CMake 配置
cmake ..

# 执行编译
cmake --build .
```

#### 使用 Qt Creator
1. 打开 Qt Creator。
2. 点击 `File` -> `Open File or Project`，选择根目录下的 `CMakeLists.txt`。
3. 配置 Kit（确保选择的是 Desktop Qt 6.10.1 MinGW 64-bit）。
4. 点击 `Configure Project`，然后点击 `Build` 按钮。

## 使用说明

1.  **连接 Broker**：
    - 在界面中找到服务器 IP、端口号、客户端 ID 等输入框。
    - 点击“连接”按钮尝试连接服务器。
    - 连接成功后，日志区域会显示 "Client connected" 或类似状态更新。
2.  **订阅主题**：
    - 在“订阅 Topic”输入框中输入感兴趣的主题（Topic），例如 `test/topic`。
    - 点击“订阅”按钮。订阅成功后，收到该主题的消息会显示在日志或接收区域。
3.  **发布消息**：
    - 在“发布”输入框中输入要发送的消息内容。
    - 点击“发布”按钮将消息发送到当前配置的 Topic。

## 项目结构

- **`main.cpp`**: 应用程序入口，负责初始化 QApplication 和显示主窗口。
- **`mainwindow.h` / `mainwindow.cpp`**: 核心业务逻辑类，实现了 MQTT 客户端的连接、订阅、发布及槽函数响应。
- **`mainwindow.ui`**: 使用 Qt Designer 设计的用户界面布局文件(20260206默认巴法云)
- **`qtmqtt/`**: 包含项目依赖的 Qt MQTT 模块源码git clone https://code.qt.io/qt/qtmqtt.git
- **`详细文章`**: QT6.10.1开发MQTT客户端-win10/安卓


## 许可证

本项目通常遵循 Qt 的开源许可协议（LGPL 3.0 或 GPL），具体请参阅项目源码中包含的许可证文件。