Improv Wi-Fi协议在.NET中的跨平台实现与应用

1. 项目背景与核心价值

在物联网设备开发中，设备首次联网配置一直是个令人头疼的问题。想象一下你刚买了一个智能灯泡，却要花半小时才能把它连上家里的Wi-Fi——这种体验足以让大多数用户放弃使用。传统配网方式通常需要设备先进入AP模式，然后用户手动连接设备热点再进行配置，整个过程繁琐且容易出错。

Improv Wi-Fi协议的出现彻底改变了这一局面。它通过蓝牙低功耗（BLE）建立设备与手机/电脑之间的安全通信通道，让用户可以在熟悉的界面上直接输入Wi-Fi密码，然后由设备自动完成网络连接。整个过程就像用AirPods连接iPhone一样简单自然。

这个.NET实现方案的核心突破在于：

• 首次实现了跨Windows和Linux平台的统一协议栈
• 通过分层架构将协议逻辑与平台实现彻底解耦
• 提供开箱即用的NuGet包支持，包括对AOT编译的特殊优化
• 完整支持Improv协议的所有核心功能点：
  • 设备识别（Identify）
  • 授权状态管理
  • 多SSID配置
  • 配网结果回调

2. 架构设计与实现原理

2.1 分层架构解析

项目的核心设计采用了经典的三层架构：

code复制┌───────────────────────┐
│      应用层           │
│  (业务逻辑处理)       │
└──────────┬────────────┘
           │
┌──────────▼────────────┐
│      协议层           │
│  (Improv编解码/状态机)│
└──────────┬────────────┘
           │
┌──────────▼────────────┐
│      传输层           │
│ (Windows/Linux BLE实现)│
└───────────────────────┘

协议层关键组件：

• ImprovService：协议状态机核心
• PacketCodec：负责协议数据包的编解码
• TransportServer：抽象传输层接口
• 事件系统：处理Identify、Provisioning等协议事件

2.2 跨平台实现方案

对于Windows平台，项目基于Windows.Devices.Bluetooth命名空间实现，这是UWP提供的官方BLE API。而在Linux端，则通过两种方式实现：

1. 托管实现：使用Tmds.DBus直接与BlueZ通信
2. AOT优化版：通过Rust编写Native库，再用P/Invoke调用

这种设计带来的优势非常明显：

• 协议层代码可以100%复用
• 平台特定问题被隔离在传输层
• 可以根据目标环境选择最适合的实现方式

3. 快速开始指南

3.1 环境准备

Windows开发环境：

1. 安装Visual Studio 2022（建议版本17.4+）
2. 启用"使用C++的桌面开发"工作负载
3. 确认蓝牙适配器支持外设模式（多数现代PC都支持）

**Linux开发环