鸿蒙(HarmonyOS)实战开发篇——基于connection的网络连接管理能力

最新推荐文章于 2025-07-22 20:07:17 发布

海绵胖

最新推荐文章于 2025-07-22 20:07:17 发布

阅读量563

点赞数 5

CC 4.0 BY-SA版权

分类专栏： harmonyOS 鸿蒙开发移动开发文章标签： harmonyos c语言鸿蒙开发 ArkUI 屏幕适配网络移动开发

本文链接：https://blog.youkuaiyun.com/lc748258/article/details/142785299

鸿蒙开发同时被 3 个专栏收录

71 篇文章

订阅专栏

移动开发

71 篇文章

订阅专栏

harmonyOS

69 篇文章

订阅专栏

往期知识点整理

场景描述

网络连接管理提供管理网络一些基础能力，包括获取默认激活的数据网络、获取所有激活数据网络列表、开启关闭飞行模式、获取网络能力信息等功能。

场景一：应用内部获取当前使用网络类型为wifi / 移动数据及当前网络可连接状态做业务处理

场景二：应用侧需要知道用户当前连接网络状态并作对应的业务处理，如网络断开返回弹框提示、应用中是否按缓存数据展示图片等

场景三：获取当前连接网卡链路地址、DNS地址等信息判断处理用户连接网络位置等应用侧能力

方案描述

场景一：

应用内部获取当前使用网络类型为wifi / 移动数据及当前网络可连接状态做业务处理

效果图

核心代码

connection.getDefaultNet().then((netHandle: connection.NetHandle) => {

connection.getNetCapabilities(netHandle).then((data: connection.NetCapabilities) => {

console.log(JSON.stringify(data));

})

});

场景二：

应用侧需要知道用户当前连接网络状态并作对应的业务处理，如网络断开返回弹框提示、应用中是否按缓存数据展示图片等

效果图

以wifi切换为例监听成功返回日志，可参考打印日志如图

方案

调用connection模块能力，使用前需要调用register开启监听，监听结束后需要调用unregister关闭当前监听请求，

核心代码

//网络状态监听

netCon : connection.NetConnection = connection.createNetConnection();

connTest(){

//开启监听事件

this.netCon.register((error: BusinessError) => {

console.log(JSON.stringify(error));

});

//监听网络是否可用

this.netCon.on('netAvailable', (data) => {

console.log("1---- net status netAvailable" + JSON.stringify(data))

})

//网络切换监听

this.netCon.on('netCapabilitiesChange', (data: connection.NetCapabilityInfo) => {

console.log(JSON.stringify(data));

});

//网络丢失()

this.netCon.on("netLost",(data) => {

console.log("1---- net lost" + JSON.stringify(data))

})

//网络不可用()

this.netCon.on('netUnavailable', (data) => {

console.log("1---- net status netUnavailable" + JSON.stringify(data))

})

//取消监听

this.netCon.unregister((error: BusinessError) => {

console.log(JSON.stringify(error));

});

}

场景三：

获取当前连接网卡链路地址、DNS地址等信息判断处理用户连接网络位置等应用侧能力

效果图

方案

步骤：1、如需要获取蜂窝网络信息，创建时需要添加关注

2、调用getConnectionProperties能力获取连接信息

核心代码

//1、 指定蜂窝网络类型获取

// 关注蜂窝网络，需要传入相关网络特征，

let netConnectionCellular = netConn.createNetConnection({

netCapabilities: {

bearerTypes: [connection.NetBearType.BEARER_CELLULAR]

}

});

try {

const ipAddresses: string[] = []; // 使用数组来收集IP地址

// 获取所有网络句柄

const allNets = connection.getAllNets();

for (const net of allNets) { // 使用for...of循环

// 获取当前网络句柄的能力信息

const netCap = connection.getConnectionProperties(net);

if (!netCap.interfaceName.includes('wlan') && Array.isArray(netCap.dnses)) {

// 确保netCap.dnses是一个数组，然后提取IP地址并添加到数组中

const dnsAddresses = netCap.dnses.map(NetAddress => NetAddress.address);

ipAddresses.push(...dnsAddresses);

}

}

// 将IP地址数组转换为逗号分隔的字符串并返回

return ipAddresses.join(',').toString();

} catch (error) {

// 打印错误并抛出，或进行其他错误处理

console.error('获取IP列表时出错:', error);

// 抛出包含原始错误信息的错误

throw new Error(`获取IP列表时出错: ${error.message}`);

}

-------

//2、默认网络获取

// 关注默认网络

let netConn = connection.createNetConnection();

connection.getDefaultNet().then((netHandle: connection.NetHandle) => {

connection.getConnectionProperties(netHandle).then((data: connection.ConnectionProperties) => {

console.log(JSON.stringify(data));

})

});