WiFiManager 项目教程

1. 项目的目录结构及介绍

WiFiManager 是一个用于 ESP8266 和 ESP32 模块的 WiFi 配置管理库，通过 Web 配置门户进行 WiFi 凭证和自定义参数的配置。以下是项目的目录结构及其介绍：

WiFiManager/
├── examples/          # 示例代码目录
│   ├── AutoConnect/   # 自动连接示例
│   ├── ...            # 其他示例
├── src/               # 源代码目录
│   ├── WiFiManager.h  # 主头文件
│   ├── ...            # 其他源文件
├── keywords.txt       # 关键词文件
├── library.properties # 库属性文件
├── LICENSE            # 许可证文件
├── README.md          # 项目说明文档

目录结构介绍

• examples/：包含多个示例代码，展示了如何使用 WiFiManager 库进行 WiFi 配置。
• src/：包含 WiFiManager 库的核心源代码文件。
• keywords.txt：定义了在 Arduino IDE 中高亮显示的关键词。
• library.properties：库的属性文件，包含库的名称、版本等信息。
• LICENSE：项目的许可证文件。
• README.md：项目的说明文档，包含安装和使用说明。

2. 项目的启动文件介绍

WiFiManager 库的启动文件是 WiFiManager.h，位于 src/ 目录下。这个文件包含了 WiFiManager 库的主要功能和接口。

启动文件介绍

• WiFiManager.h：定义了 WiFiManager 类及其方法，提供了 WiFi 配置和管理的功能。

#include <WiFiManager.h>

WiFiManager wifiManager;

void setup() {
  wifiManager.autoConnect("AP-NAME", "AP-PASSWORD");
}

void loop() {
  // 主循环
}

使用方法

1. 在全局范围内创建一个 WiFiManager 对象。
2. 在 setup() 函数中调用 autoConnect() 方法，启动 WiFi 配置门户。

3. 项目的配置文件介绍

WiFiManager 库的配置文件主要是 library.properties，它定义了库的基本属性，如名称、版本、作者等。

配置文件介绍

• library.properties：包含库的属性信息。

name=WiFiManager
version=2.0.3
author=tzapu
maintainer=tablatronix
sentence=WiFi Configuration manager with web configuration portal for Espressif ESPx boards
paragraph=Library for configuring ESP8266/ESP32 modules WiFi credentials and custom parameters at runtime with captive portal
category=Communication
url=https://github.com/tzapu/WiFiManager
architectures=esp8266,esp32

配置文件内容

• name：库的名称。
• version：库的版本号。
• author：库的作者。
• maintainer：库的维护者。
• sentence：库的简短描述。
• paragraph：库的详细描述。
• category：库的分类。
• url：库的 GitHub 地址。
• architectures：支持的架构。

通过以上介绍，您可以更好地理解和使用 WiFiManager 库进行 WiFi 配置和管理。