HarmonyOSNEXT网络连接管理全攻略

##Harmony OS Next ##Ark Ts ##教育

本文适用于教育科普行业进行学习，有错误之处请指出我会修改。

🌟 先来认识几个核心概念

// 网络三要素定义
type NetProducer = 'WiFi' | '蜂窝网络' | '以太网'; // 网络提供者
type NetConsumer = App | 系统服务;        // 网络使用者
type NetMonitor = '连接探测' | 'DNS检测' | 'HTTPS验证'; // 网络健康检查员

---

🚀 功能全景图

五大核心能力一键Get：

1. 📶 多网络优先级管理（WiFi/蜂窝/以太网）
2. 🔍 实时网络质量评估
3. 🔔 网络状态变化订阅（默认/指定网络）
4. 📊 网络连接信息查询
5. 🌐 智能DNS解析

---

⚠️ 重要说明

// 异步调用规范示例
connection.getDefaultNet().then((netHandle) => {
  console.log("当前默认网络ID：" + netHandle.netId);
}).catch((error) => {
  console.error("获取失败：" + error.code);
});

💡 划重点：

• 90%的API采用异步调用，支持Promise和callback双模式
• 推荐使用Promise写法更简洁（如上示例）
• API版本：从API 8开始支持，新版接口会有特别标注

---

🔧 接口工具箱

📌 基础操作

接口方法	功能描述
getDefaultNet()	获取当前默认网络句柄
setAppHttpProxy()	设置应用级HTTP代理
getAllNets()	获取所有已连接网络列表

🎯 高级功能

// 网络状态监听实战
import { connection } from '@kit.NetworkKit';

const netConnection = connection.createNetConnection();
netConnection.on('netAvailable', (netHandle) => {
  console.log(`🎉 网络切换成功！新网络ID：${netHandle.netId}`);
});
netConnection.register(); // 开启监听

---

🛠️ 四大实战场景

场景1：网络状态实时监控

// 网络状态变化监听模板
const specifier = {
  netCapabilities: {
    bearerTypes: [connection.NetBearType.BEARER_CELLULAR],
    networkCap: [connection.NetCap.NET_CAPABILITY_INTERNET]
  }
};

const conn = connection.createNetConnection(specifier);
conn.on('netAvailable', handleNetworkChange); // 网络可用时触发
conn.on('netLost', handleNetworkLoss);        // 网络丢失时触发

场景2：多网络智能切换

// 网络切换自动重连示例
let currentSession: rcp.Session;

function createNewSession() {
  currentSession?.close();
  currentSession = rcp.createSession();
  // 这里添加你的网络请求逻辑
}

connection.createNetConnection().on('netAvailable', createNewSession);

---

📋 超实用速查表

网络能力解码表

能力值	含义
NET_CAPABILITY_MMS	支持彩信传输
NET_CAPABILITY_NOT_METERED	不计流量网络
NET_CAPABILITY_VALIDATED	网络有效性已验证

网络类型对照表

// 判断网络类型代码片段
connection.getNetCapabilities(netHandle).then((caps) => {
  if (caps.bearerTypes.includes(0)) {
    console.log("📶 当前是蜂窝网络");
  } else if (caps.bearerTypes.includes(1)) {
    console.log("🛜 当前是WiFi网络");
  }
});

---

💡 避坑指南

1. 权限申请必看：

   // required_permissions.json
   {
     "name": "ohos.permission.GET_NETWORK_INFO"
   }
   

2. Socket使用须知：

   • 切换网络后必须关闭旧Socket
   • 推荐使用@kit.RemoteCommunicationKit替代原生HTTP模块

3. DNS解析技巧：

// 智能DNS解析示例
connection.getAddressesByName("www.example.com").then((addresses) => {
  console.log("🌍 解析到IP地址：" + addresses.join(', '));
});

---

🚨 紧急情况处理： 当遇到网络状态与管理器不一致时：

// 强制报告网络状态
connection.reportNetDisconnected(badNetHandle); // 标记问题网络
connection.reportNetConnected(goodNetHandle);   // 确认可用网络

---

🎯 最佳实践总结：

• 多网络场景优先使用createNetConnection创建独立连接
• 重要操作添加try-catch异常处理
• 及时取消无用的事件监听（unregister()）