harmony-utils之NetworkUtil,网络相关工具类

简介: `harmony-utils` 是一款专为 HarmonyOS 开发的高效工具库,提供包括网络、设备、权限、文件等常用功能的封装。其中 `NetworkUtil` 工具类涵盖网络状态检测、类型判断、IP 获取、SIM 卡信息查询等功能,帮助开发者快速实现网络相关操作,提升开发效率。

harmony-utils之NetworkUtil,网络相关工具类

harmony-utils 简介与说明


harmony-utils 一款功能丰富且极易上手的HarmonyOS工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON等一系列的功能和操作,能够满足各种不同的开发需求。
picker_utils 是harmony-utils拆分出来的一个子库,包含PickerUtil、PhotoHelper、ScanUtil。

下载安装
ohpm i @pura/harmony-utils
ohpm i @pura/picker_utils

  //全局初始化方法,在UIAbility的onCreate方法中初始化 AppUtil.init()
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    AppUtil.init(this.context);
  }

API方法与使用


isDefaultNetMetered 检查当前网络上的数据流量使用是否被计量
 let hasDefaultNet = NetworkUtil.isDefaultNetMeteredSync();
 ToastUtil.showToast(`当前网络上的数据流量使用是否被计量:${hasDefaultNet}`);
hasDefaultNet 检查默认数据网络是否被激活
let hasDefaultNet = NetworkUtil.hasDefaultNetSync();
ToastUtil.showToast(`默认数据网络是否被激活:${hasDefaultNet}`);
getDefaultNet 获取默认激活的数据网络
  let defaultNet = await NetworkUtil.getDefaultNet();
  let jsonStr = JSON.stringify(defaultNet, null, 2);
getAppNet 获取App绑定的网络信息
let appNet = await NetworkUtil.getAppNet();
 let jsonStr = JSON.stringify(appNet, null, 2);
getAllNets 获取所有处于连接状态的网络列表
  let allNet = await NetworkUtil.getAllNets();
  let jsonStr = JSON.stringify(allNet, null, 2);
isNetworkAvailable 判断当前设备网络是否可用
let isNetwork = NetworkUtil.isNetworkAvailable();
ToastUtil.showToast(`当前网络是否可用:${isNetwork}`);
hasNetMobile 判断当前网络是否是蜂窝网络(移动网络)
let hasNetMobile = NetworkUtil.hasNetMobile();
ToastUtil.showToast(`当前网络是否是蜂窝网络:${hasNetMobile}`);
hasNetWiFi 判断当前网络是否是Wi-Fi网络
 let hasNetWiFi = NetworkUtil.hasNetWiFi();
 ToastUtil.showToast(`当前网络是否是Wi-Fi网络:${hasNetWiFi}`);
hasNetEthernet 判断当前网络是否是以太网网络
 let hasNetEthernet = NetworkUtil.hasNetEthernet();
 ToastUtil.showToast(`当前网络是否是以太网网络:${hasNetEthernet}`);
hasNetVPN 判断当前网络是否是VPN网络
 let hasNetVPN = NetworkUtil.hasNetVPN();
 ToastUtil.showToast(`当前网络是否是VPN网络:${hasNetVPN}`);
hasNetBearType 是否存在指定的网络
 let hasNet = NetworkUtil.hasNetBearType(connection.NetBearType.BEARER_WIFI);
 ToastUtil.showToast(`是否存在指定的网络:${hasNet}`);
getNetBearTypes 获取网络类型,数组里面只包含了一种具体的网络类型
let netBearTypes = NetworkUtil.getNetBearTypes();
let jsonStr = JSON.stringify(netBearTypes, null, 2);
getNetBearType 获取网络类型
 let type = await NetworkUtil.getNetBearType();
 ToastUtil.showToast(`网络类型:${type}`);
getNetCapabilities 获取netHandle对应的网络的能力信息
  let netCapabilities = NetworkUtil.getNetCapabilitiesSync();
  let jsonStr = JSON.stringify(netCapabilities, null, 2);
getConnectionProperties 获取netHandle对应的网络的连接信息
let connectionProperties = NetworkUtil.getConnectionPropertiesSync();
let jsonStr = JSON.stringify(connectionProperties, null, 2);
getIpAddress 获取当前设备的IP地址(设备连接Wi-Fi后)
 let ip = NetworkUtil.getIpAddress();
 ToastUtil.showToast(ip);
register 订阅指定网络状态变化的通知,支持多事件监听回调
NetworkUtil.register((netHandle) => {
  LogUtil.error(`订阅网络可用事件回调:${JSON.stringify(netHandle)}`);
}, () => {
  LogUtil.error(`订阅网络不可用事件回调。`);
}, (netCapabilityInfo) => {
  LogUtil.error(`订阅网络能力变化事件回调:${JSON.stringify(netCapabilityInfo)}`);
}, (nNetConnectionPropertyInfo) => {
  LogUtil.error(`订阅网络连接信息变化事件回调:${JSON.stringify(nNetConnectionPropertyInfo)}`);
}, (netBlockStatusInfo) => {
  LogUtil.error(`订阅网络阻塞状态事件回调:${JSON.stringify(netBlockStatusInfo)}`);
}, (netHandle) => {
  LogUtil.error(`订阅网络丢失事件回调:${JSON.stringify(netHandle)}`);
});
unregister 取消订阅默认网络状态变化的通知
NetworkUtil.unregister();
ToastUtil.showToast("取消订阅默认网络状态变化监听");
isNRSupported 判断当前设备是否支持NR(New Radio)。也就是5G。
let isNRSupported = NetworkUtil.isNRSupported();
ToastUtil.showToast(`当前设备是否支持NR:${isNRSupported}`);
isRadioOn 判断Radio是否打开
let isRadioOn = await NetworkUtil.isRadioOn();
ToastUtil.showToast(`Radio是否打开:${isRadioOn}`);
getPrimarySlotId 获取主卡所在卡槽的索引号
 let slotId = await NetworkUtil.getPrimarySlotId();
 ToastUtil.showToast(`主卡所在卡槽的索引号:${slotId}`);
getOperatorName 获取运营商名称
let operatorName = await NetworkUtil.getOperatorName();
ToastUtil.showToast(`运营商名称:${operatorName}`);
getNetworkState 获取网络状态
let networkState = await NetworkUtil.getNetworkState();
let jsonStr = JSON.stringify(networkState, null, 2);
getNetworkSelectionMode 获取当前选网模式
let mode = await NetworkUtil.getNetworkSelectionMode();
let jsonStr = JSON.stringify(mode, null, 2);
getSignalInformation 获取指定SIM卡槽对应的注册网络信号强度信息列表
 let signalInformation = await NetworkUtil.getSignalInformation();
 let jsonStr = JSON.stringify(signalInformation, null, 2);
getNetworkType 获取网络类型
let networkType = await NetworkUtil.getNetworkType();
ToastUtil.showToast(`网络类型:${networkType}`);
getNetworkTypeStr 获取网络类型,返回字符类型
 let networkType = await NetworkUtil.getNetworkTypeStr();
 ToastUtil.showToast(`网络类型:${networkType}`);
getDefaultCellularDataSlotId 获取默认移动数据的SIM卡
let slotId = await NetworkUtil.getDefaultCellularDataSlotId();
ToastUtil.showToast(`默认移动数据的SIM卡:${slotId}`);
getCellularDataFlowType 获取蜂窝数据业务的上下行状态
 let dataFlowType = await NetworkUtil.getCellularDataFlowType();
 ToastUtil.showToast(`蜂窝数据业务的上下行状态:${dataFlowType}`);
getCellularDataState 获取分组交换域(PS域)的连接状态
 let state = await NetworkUtil.getCellularDataState();
 ToastUtil.showToast(`分组交换域(PS域)的连接状态:${state}`);
isCellularDataEnabled 检查蜂窝数据业务是否启用
let enabled = await NetworkUtil.isCellularDataEnabled();
ToastUtil.showToast(`蜂窝数据业务是否启用:${enabled}`);
isCellularDataRoamingEnabled 检查蜂窝数据业务是否启用漫游
let enabled = await NetworkUtil.isCellularDataRoamingEnabled();
ToastUtil.showToast(`蜂窝数据业务是否启用漫游:${enabled}`);
getDefaultCellularDataSimId 获取默认移动数据的SIM卡ID。与SIM卡绑定,从1开始递增
 let simId = NetworkUtil.getDefaultCellularDataSimId();
 ToastUtil.showToast(`默认移动数据的SIM卡ID:${simId}`);
isSimActive 获取指定卡槽SIM卡是否激活
let isSimActive = await NetworkUtil.isSimActive(1);
ToastUtil.showToast(`卡槽2SIM卡是否激活:${isSimActive}`);
hasSimCard 获取指定卡槽SIM卡是否插卡
  let hasSimCard = await NetworkUtil.hasSimCard(1);
  ToastUtil.showToast(`卡槽2SIM卡是否插卡:${hasSimCard}`);
getMaxSimCount 获取卡槽数量
let count = NetworkUtil.getMaxSimCount();
ToastUtil.showToast(`卡槽数量:${count}`);
getSimOperatorNumeric 获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号
let simOperatorNumeric = await NetworkUtil.getSimOperatorNumeric();
ToastUtil.showToast(`指定卡槽SIM卡的归属PLMN:${simOperatorNumeric}`);
getSimSpn 获取指定卡槽SIM卡的服务提供商名称
 let simSpn = await NetworkUtil.getSimSpn();
 ToastUtil.showToast(`指定卡槽SIM卡的服务提供商名称:${simSpn}`);
getSimState 获取指定卡槽的SIM卡状态
 let simState = await NetworkUtil.getSimState();
 ToastUtil.showToast(`指定卡槽的SIM卡状态:${simState}`);
getCardType 获取指定卡槽SIM卡的卡类型
let cardType = await NetworkUtil.getCardType();
ToastUtil.showToast(`指定卡槽SIM卡的卡类型:${cardType}`);

创作不易,请给童长老点赞👍


https://github.com/787107497/harmony-utils
https://gitee.com/tongyuyan/harmony-utils
OpenHarmony三方库

目录
相关文章
|
存储 安全 算法
harmony-utils之AES,AES加解密
harmony-utils是一款专为HarmonyOS开发的高效工具库,提供包括AES加解密在内的多种实用功能,帮助开发者快速构建应用。
370 0
|
存储 算法 安全
harmony-utils之SHA,SHA工具类
harmony-utils 是一款功能丰富的 HarmonyOS 工具库,提供多种实用工具类,助力开发者快速构建鸿蒙应用。其中的 SHA 工具类支持 SHA-1、SHA-2、SHA-3 等算法,可用于数据摘要、完整性校验、数字签名和密码存储等场景。支持同步与异步操作,并提供分段处理及 HMAC 消息认证码计算功能,提升安全性和灵活性。
286 1
|
8月前
|
JSON 生物认证 API
harmony-utils之FormatUtil,格式化工具类
FormatUtil 是 harmony-utils 工具库中的格式化工具类,提供电话号码验证与格式化、中文转拼音、百分比显示、文件大小转换、文本截取、URL参数解析与拼接等功能,助力鸿蒙应用快速开发。
177 0
|
8月前
|
JSON 生物认证 API
harmony-utils之ObjectUtil,对象工具类
`harmony-utils` 是一款专为 HarmonyOS 开发的功能强大且易于使用的工具库,涵盖对象操作、设备信息、文件处理、数据加密等常用开发功能,帮助开发者快速构建高效稳定的鸿蒙应用。
178 0
|
8月前
|
JSON 生物认证 API
harmony-utils之PreviewUtil,文件预览工具类
PreviewUtil 是 harmony-utils 工具库中的文件预览工具类,提供生成预览信息、打开/关闭预览窗口、加载预览数据、判断预览支持等功能,助力鸿蒙应用快速实现文件预览操作。
276 0
|
8月前
|
JSON 生物认证 API
harmony-utils之ImageUtil,图片相关工具类
harmony-utils 是一款功能丰富的 HarmonyOS 工具库,提供包括图像处理在内的多种实用工具类。ImageUtil 作为其子模块,专注于图片相关操作,支持 Base64 与 PixelMap 转换、图片压缩、保存及编码打包等功能,助力开发者高效实现图片处理需求。
582 0
|
8月前
|
存储 JSON 生物认证
harmony-utils之KvUtil,键值型数据库工具类
harmony-utils之KvUtil是鸿蒙系统中用于操作键值型数据库的工具类,提供包括添加、获取、删除、批量操作及备份恢复等功能,简化数据存储与管理。
177 0
|
8月前
|
JSON 生物认证 API
harmony-utils之PasteboardUtil,剪贴板工具类
harmony-utils 是一款功能丰富且易用的 HarmonyOS 工具库,提供剪贴板、设备、屏幕、授权等常用工具类,助力开发者高效构建鸿蒙应用。
177 0
|
8月前
|
JSON 生物认证 API
harmony-utils之LocationUtil,定位相关工具类
harmony-utils 是一款专为 HarmonyOS 开发的高效工具库,包含丰富的实用类与功能模块。其中 LocationUtil 提供了定位服务判断、权限申请、位置获取、地理编码、坐标转换等功能,帮助开发者快速实现定位相关操作,提升开发效率。
203 0
|
8月前
|
JSON 安全 生物认证
harmony-utils之RandomUtil,随机工具类
harmony-utils 是一款功能强大的 HarmonyOS 工具库,提供丰富的实用类与方法,助力开发者高效构建鸿蒙应用。其中 RandomUtil 类可生成随机布尔值、整数、字符串、汉字、颜色、UUID 等,支持多种随机数据生成场景,使用简单,适用于测试、安全、界面展示等多种用途。
301 0