前言

网络连接属性包括连接类型、链路信息等详细数据，对网络诊断和优化有重要参考价值。@pura/harmony-utils 的 NetworkUtil 封装了网络连接属性查询方法。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解，帮助开发者快速掌握并应用到实际项目中。

一、NetworkUtil连接属性核心API

NetworkUtil 提供了以下网络连接属性查询方法：

方法	说明	返回类型	使用场景
getConnectionProperties()	获取连接属性	object	网络诊断
getLinkAddress()	获取链路地址	string	网络配置
getConnectionType()	获取连接类型	string	类型展示

1.1 核心特性

• 简洁易用：封装复杂API为一行调用，降低使用门槛
• 类型安全：完整的TypeScript类型定义，编译期即可发现错误
• 异常处理：内置异常捕获机制，避免运行时崩溃
• 信息全面：覆盖连接类型、链路地址等详细属性

1.2 连接属性信息对照

属性	说明	示例值
连接类型	WiFi/蜂窝/以太网	WiFi
链路地址	网络链路层地址	192.168.1.100
DNS服务器	域名解析服务器	8.8.8.8

二、完整使用步骤

2.1 安装依赖

ohpm install @pura/harmony-utils

2.2 获取连接属性

import { NetworkUtil } from '@pura/harmony-utils';

Button('获取连接属性')
  .width('100%')
  .onClick(() => {
    try {
      let type = NetworkUtil.getConnectionType();
      this.result = `连接类型: ${type}`;
    } catch (e) {
      this.result = '异常: ' + e;
    }
  })

2.3 获取链路信息

Button('获取链路信息')
  .width('100%')
  .onClick(() => {
    try {
      let address = NetworkUtil.getLinkAddress();
      this.result = `链路地址: ${address}`;
    } catch (e) {
      this.result = '异常: ' + e;
    }
  })

三、完整页面示例

import { NetworkUtil } from '@pura/harmony-utils';

@Entry
@Component
struct ConnectionDemo {
  @State result: string = '';

  build() {
    Column({ space: 12 }) {
      Button('获取连接信息').width('100%').onClick(() => {
        try {
          let type = NetworkUtil.getConnectionType();
          let address = NetworkUtil.getLinkAddress();
          this.result = `类型: ${type}\n地址: ${address}`;
        } catch (e) { this.result = '异常: ' + e; }
      });
      Text(this.result).fontSize(14).fontColor('#333333')
    }
    .padding(16)
  }
}

四、进阶用法

4.1 网络诊断信息收集

import { NetworkUtil } from '@pura/harmony-utils';

function collectNetworkDiagnostics(): Record<string, Object> {
  return {
    type: NetworkUtil.getConnectionType(),
    properties: NetworkUtil.getConnectionProperties(),
    linkAddress: NetworkUtil.getLinkAddress()
  };
}

4.2 连接类型判断

function isHighSpeedNetwork(): boolean {
  let type = NetworkUtil.getConnectionType();
  return type === 'WiFi' || type === 'Ethernet' || NetworkUtil.is5GConnected();
}

五、注意事项

1. 权限要求：连接属性查询需要网络相关权限
2. 信息完整性：部分属性可能在特定网络下不可用
3. 动态变化：连接属性可能随网络切换变化
4. 初始化依赖：使用前需确保 AppUtil.init() 已调用
5. 隐私保护：网络属性属于设备信息，需注意隐私合规

六、常见问题

Q1: getConnectionProperties()返回空对象？

可能是网络未连接或权限不足，建议先检查网络状态和权限配置。

Q2: 链路地址和IP地址有什么区别？

链路地址是网络链路层地址，IP地址是网络层地址，两者可能不同。

Q3: 如何判断当前网络质量？

可以结合连接类型、信号强度、网络能力等多维度综合判断。

Q4: 连接属性信息可以缓存吗？

不建议长期缓存，网络状态可能随时变化，建议每次使用时重新获取。

总结

NetworkUtil 的网络连接属性查询方法为网络诊断和优化提供了详细数据支撑。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用这些信息实现网络诊断和智能策略。

本文基于 @pura/harmony-utils 工具库，更多功能请参考官方文档与后续系列文章。