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开始支持，新版接口会有特别标注

🔧 接口工具箱

📌 基础操作

🎯 高级功能

// 网络状态监听实战
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);

📋 超实用速查表

网络能力解码表

网络类型对照表

// 判断网络类型代码片段
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()）