# WiFiconnect

**Repository Path**: mogaribue/WiFiconnect

## Basic Information

- **Project Name**: WiFiconnect
- **Description**: 鸿蒙 WiFi 连接管理应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WiFiconnect

鸿蒙（HarmonyOS）WiFi 连接管理应用，基于 ArkTS + MVVM 架构，提供 WiFi 网络扫描、连接管理、WiFi Direct（P2P）设备发现以及 TCP/UDP 数据传输功能。

## 功能特性

- **WiFi 管理** — 扫描附近 WiFi 网络、连接/断开、已保存网络管理
- **WiFi Direct（P2P）** — 发现附近 P2P 设备、设备详情查看
- **数据传输** — 支持 TCP 服务端/客户端模式和 UDP 无连接传输
- **连接状态监控** — 实时显示信号强度（RSSI）、连接速率、频段、IP 地址
- **网络可用性检测** — 监听网络连通/断开事件

## 技术栈

| 技术 | 说明 |
|------|------|
| 平台 | HarmonyOS 5.0.0 (API 12) |
| 语言 | ArkTS |
| 构建工具 | Hvigor |
| 架构模式 | MVVM（Model-View-ViewModel） |
| IDE | DevEco Studio |

## 项目结构

```
WiFiconnect/
├── AppScope/                  # 应用全局配置
├── entry/                     # 主模块
│   └── src/main/ets/
│       ├── common/            # 常量、枚举
│       ├── entryability/      # EntryAbility 入口
│       ├── model/             # 数据模型（纯数据类）
│       ├── pages/             # 页面级 @Component
│       ├── service/           # 单例服务层（封装鸿蒙 SDK）
│       ├── utils/             # 静态工具类
│       ├── viewmodel/         # @Observed ViewModel
│       └── views/             # 可复用 UI 组件
├── build-profile.json5        # 构建配置
└── hvigor/                    # Hvigor 构建系统配置
```

### 各层职责

```
pages/      — 页面级 @Component；消费共享 ViewModel，持有页面专属 ViewModel
views/      — 可复用 UI @Component（状态栏、列表项、输入框等）
viewmodel/  — @Observed 装饰的类，使用 @Track 管理状态；编排服务调用
service/    — 鸿蒙 SDK API 的单例封装层
model/      — 纯数据接口/类
common/     — 常量、枚举定义
utils/      — 静态工具类
```

## 核心服务

| 服务 | 封装 SDK | 用途 |
|------|----------|------|
| `WifiManagerService` | `@ohos.wifiManager` | WiFi 开关、扫描、连接/断开、设备配置、IP 信息 |
| `SocketTransferService` | `@ohos.net.socket` | TCP 服务端/客户端、UDP Socket、分块数据传输 |
| `NetworkMonitorService` | `@ohos.net.connection` | 网络可用性监控 |
| `HasWifiService` | `has.*` 原子服务 API | WiFi 操作的原子服务备用方案 |

## 权限

应用启动时请求以下权限：

- `ohos.permission.INTERNET` — 网络访问
- `ohos.permission.GET_WIFI_INFO` — WiFi 信息读取
- `ohos.permission.SET_WIFI_INFO` — WiFi 信息写入
- `ohos.permission.GET_WIFI_CONFIG` — WiFi 配置读取
- `ohos.permission.LOCATION` — 精确定位（WiFi 扫描必需）
- `ohos.permission.APPROXIMATELY_LOCATION` — 粗略定位

## 构建与运行

需要 DevEco Studio 及 DevEco MCP 工具。

### 构建（debug）
在 DevEco Studio 中打开项目，点击 **Build → Build Hap(s)/APP(s)**。

### 运行
连接鸿蒙设备或启动模拟器后，点击 **Run → Run 'entry'**。

### 构建产物
```
entry/build/default/outputs/default/entry-default-unsigned.hap
```

## 设计模式

### 状态管理
ViewModel 类使用 `@Observed` 装饰，可变属性使用 `@Track` 装饰。绑定到组件模板时自动触发 ArkUI 响应式更新。

### 导航
`Index.ets` 是根页面，创建 `NavPathStack` 和共享的 `ConnectionStatusViewModel`，通过 `@Provide`/`@Consume` 提供给子页面。

### 路由
```typescript
// 页面跳转
this.navPathStack.pushPathByName('WifiDirectPage', params)
```

## 许可证

MIT