鸿蒙开发enterprise.wifiManager

### HarmonyOS Enterprise.WiFiManager 使用指南

对于企业级应用，在鸿蒙操作系统(HarmonyOS)下进行WiFi管理时，可以利用`enterprise.wifiManager`模块来实现更高级别的控制功能。此模块提供了创建、移除以及连接到指定配置文件等功能。

为了使用这些特性，开发者需先引入相应的库：

import enterprise.wifiManager from '@ohos.enterprise.wifiManager';

#### 创建Wi-Fi配置实例并尝试连接

下面是一个简单的例子，展示了如何通过编程的方式设置一个新的Wi-Fi网络，并让设备自动连接上去[^1]。

async function addAndConnectToNetwork(ssid, password){
    let config = {
        ssid: ssid,
        preSharedKey: password,
        securityType: enterprise.wifiManager.SecurityType.SEC_TYPE_PSK // WPA/WPA2加密类型
    };

    try{
        const result = await enterprise.wifiManager.addConfig(config);
        console.log(`Add Wi-Fi configuration success with id ${result}`);
        
        // 尝试立即连接新添加的网络
        await enterprise.wifiManager.connect(result);
        console.log('Connected to the new network successfully');
    }catch(error){
        console.error('Failed to configure or connect:', error.message);
    }
}

这段代码定义了一个异步函数`addAndConnectToNetwork()`，它接受两个参数——SSID和服务密码。该函数会构建一个包含必要信息的对象`config`，并通过调用API接口将其提交给系统。如果操作成功，则返回分配给这个特定配置项的一个唯一ID；接着再次调用另一个API去请求立刻切换至刚建立好的无线网路环境之中。

#### 获取当前已知的所有Wi-Fi配置列表

有时应用程序可能想要枚举所有之前保存过的Wi-Fi热点记录，这时就可以借助于如下所示的方法:

function listAllKnownNetworks(){
    return new Promise((resolve,reject)=>{
        enterprise.wifiManager.getAllConfigs().then(data=>{
            resolve(data.map(item=>item.ssid));
        }).catch(err=>{
            reject(err);
        });
    });
}

上述JavaScript片段实现了对所有先前存储过的历史Wi-Fi接入点名称(即SSIDs)读取的功能。这有助于用户界面展示可用选项供最终使用者选择重连哪一个曾经访问过得地方。