鸿蒙三方库 | harmony-utils之NetworkUtil IP地址获取详解

前言IP地址是网络通信的基础标识在设备发现、本地服务、网络诊断等场景中经常需要获取设备IP地址。pura/harmony-utils的NetworkUtil封装了IP地址获取方法。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、NetworkUtil IP核心APINetworkUtil提供了以下IP地址获取方法方法说明返回类型使用场景getIpAddress()获取IP地址string设备发现、本地服务getIpv6Address()获取IPv6地址stringIPv6网络getGateway()获取网关地址string网络诊断getNetMask()获取子网掩码string网络计算getDnsServers()获取DNS服务器string[]DNS配置1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃信息全面覆盖IPv4、IPv6、网关、掩码、DNS等1.2 IP地址类型对比类型格式示例适用场景IPv432位192.168.1.100局域网通信IPv6128位fe80::1新一代网络二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 获取IP地址import{NetworkUtil}frompura/harmony-utils;Button(获取IP地址).width(100%).onClick((){try{letipNetworkUtil.getIpAddress();this.resultIP地址:${ip}\n类型: IPv4;}catch(e){this.result异常: e;}})2.3 获取网络详情Button(获取网络详情).width(100%).onClick((){try{letipNetworkUtil.getIpAddress();letgatewayNetworkUtil.getGateway();letmaskNetworkUtil.getNetMask();this.resultIP:${ip}\n网关:${gateway}\n掩码:${mask};}catch(e){this.result异常: e;}})三、完整页面示例import{NetworkUtil}frompura/harmony-utils;EntryComponentstruct IpAddressDemo{Stateresult:string;build(){Column({space:12}){Button(获取IP地址).width(100%).onClick((){try{letipNetworkUtil.getIpAddress();this.result本机IP:${ip};}catch(e){this.result异常: e;}});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 局域网设备发现import{NetworkUtil}frompura/harmony-utils;functiongetLocalNetworkPrefix():string{letipNetworkUtil.getIpAddress();letpartsip.split(.);return${parts[0]}.${parts[1]}.${parts[2]};}4.2 网络诊断信息收集functioncollectNetworkInfo():Recordstring,string{return{ip:NetworkUtil.getIpAddress(),gateway:NetworkUtil.getGateway(),mask:NetworkUtil.getNetMask()};}五、注意事项网络依赖需连接网络后才能获取IP地址多网卡设备可能有多个网络接口返回的可能是任一接口的IP隐私合规IP地址属于用户隐私数据使用时需注意合规初始化依赖使用前需确保AppUtil.init()已调用动态分配IP地址可能由DHCP动态分配会发生变化六、常见问题Q1: 未连接网络时获取IP返回什么可能返回空字符串或0.0.0.0建议先检查网络连接状态。Q2: 如何获取指定网络接口的IP当前API返回默认网络接口的IP如需指定接口需使用系统底层API。Q3: IPv6地址获取失败怎么办部分网络环境不支持IPv6建议同时获取IPv4作为备选。Q4: getDnsServers()返回多个DNS是什么意思设备可能配置了主DNS和备用DNS返回数组包含所有DNS服务器地址。总结NetworkUtil的IP地址获取方法为网络通信和诊断提供了基础数据支撑。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用这些信息实现设备发现、本地服务、网络诊断等功能。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。