HelloIoT 使用指南

1. 项目目录结构及介绍

HelloIoT 是一个基于Java开发的MQTT仪表板应用程序，它支持在Windows、MacOS、Linux以及Android系统上运行。下面简要介绍其核心目录结构：

helloiot/
├── src                        # 源代码目录
│   ├── main                   # 主要程序代码
│   │   ├── java                # Java源代码文件
│   │   │   └── com.example    # 示例包，包含主应用逻辑
│   ├── resources               # 配置资源文件夹
│   │   └── application.properties # 应用配置文件
│   └── ...
├── image                      # 可执行文件或部署相关文件夹
│   ├── bin                     # 包含各平台可执行文件
│       └── HelloIoT           # 各操作系统的启动脚本或者可执行文件
│   ├── dist                    # 发布版本文件夹，包含不同平台的压缩包
│   │   ├── windows
│   │   ├── macos
│   │   └── linux
│   └── ...
├── pom.xml                     # Maven项目构建配置文件
├── README.md                  # 项目说明文档
└── LICENSE                    # 许可证文件，遵循GPLv3协议

• src/main/java 存放所有Java源代码，是业务逻辑的核心。
• resources 目录包含了应用运行所需的配置文件。
• image 目录存放了构建好的应用分发文件，包括用于不同操作系统上的可执行文件或安装包。
• pom.xml 是Maven项目管理文件，用于编译、打包等构建过程。

2. 项目的启动文件介绍

对于桌面系统，HelloIoT提供了预编译的可执行文件。每个操作系统的启动流程如下：

• Windows: 解压下载的helloiot-1.1.030-windows.zip，找到image/bin/HelloIoT.exe并双击启动。
• MacOS: 同样解压helloiot-1.1.030-macos.zip，执行image/bin/HelloIoT.app。
• Linux: 解压helloiot-1.1.030-linux.zip，通过终端进入解压后的目录，并使用命令行./image/bin/HelloIoT来运行。

对于Android，需先允许安装来自未知来源的应用，然后直接安装下载的.apk文件。

3. 项目的配置文件介绍

主要配置文件位于src/main/resources/application.properties中，这个文件对应用的行为进行定制，尽管具体的内容可能因版本而异，典型的配置项可能包括：

# 假设示例配置
mqtt.broker.uri=tcp://localhost:1883      # MQTT代理地址
server.port=8080                           # 应用服务端口
app.name=HelloIoT                          # 应用名称
# 其他自定义配置...

• mqtt.broker.uri 指定了MQTT代理的URL，这是连接到MQTT服务器所必需的。
• server.port 若应用包含HTTP服务，这将指定服务监听的端口号。
• app.name 应用内部使用的名称标识。

请注意，在实际使用前，根据你的需求修改application.properties中的配置项，以确保应用能够正确连接到MQTT代理和其他必要的服务。