前言

网络加速检测在企业应用和安全场景中非常重要，如企业应用要求连接内网才能访问内部资源。@pura/harmony-utils 的 NetworkUtil 封装了内网检测方法。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解，帮助开发者快速掌握并应用到实际项目中。

一、NetworkUtil 网络加速核心API

NetworkUtil 提供了以下网络加速检测方法：

方法	说明	返回类型	使用场景
isVpnConnected()	是否VPN连接	boolean	VPN状态检测
getVpnConnectionInfo()	获取VPN连接信息	string	VPN详情查询

1.1 核心特性

• 简洁易用：封装复杂API为一行调用，降低使用门槛
• 类型安全：完整的TypeScript类型定义，编译期即可发现错误
• 异常处理：内置异常捕获机制，避免运行时崩溃
• 安全检测：支持网络连接状态检测

1.2 网络检测应用场景

场景	网络要求	处理方式
企业内网访问	必须内网	未连接时阻止访问
敏感数据传输	建议内网	未连接时提醒用户
普通应用	无要求	仅展示状态

二、完整使用步骤

2.1 安装依赖

ohpm install @pura/harmony-utils

2.2 检测内网连接

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

Button('检测内网连接')
  .width('100%')
  .onClick(() => {
    try {
      let isVpn = NetworkUtil.isVpnConnected();
      this.result = `VPN: ${isVpn ? '已连接 🛡️' : '未连接'}`;
    } catch (e) {
      this.result = '异常: ' + e;
    }
  })

2.3 企业应用安全检查

async accessInternalResource() {
  if (!NetworkUtil.isVpnConnected()) {
    DialogUtil.show('请先连接企业内网');
    return;
  }
  let data = await this.api.getInternalData();
  return data;
}

三、完整页面示例

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

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

  build() {
    Column({ space: 12 }) {
      Button('检测内网').width('100%').onClick(() => {
        try {
          let isVpn = NetworkUtil.isVpnConnected();
          this.result = `内网状态: ${isVpn ? '已连接' : '未连接'}`;
        } catch (e) { this.result = '异常: ' + e; }
      });
      Text(this.result).fontSize(14).fontColor('#333333')
    }
    .padding(16)
  }
}

四、进阶用法

4.1 加速网络网关检测

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

function checkVpnBeforeAccess(): boolean {
  if (!NetworkUtil.isVpnConnected()) {
    ToastUtil.showToast('请先连接企业VPN后再访问');
    return false;
  }
  return true;
}

4.2 加速网络的状态UI指示

@State vpnConnected: boolean = false;

aboutToAppear() {
  this.vpnConnected = NetworkUtil.isVpnConnected();
}

五、注意事项

1. 检测精度：VPN检测基于网络接口类型判断
2. 隐私合规：VPN状态属于用户隐私信息
3. 权限要求：VPN检测需要网络相关权限
4. 初始化依赖：使用前需确保 AppUtil.init() 已调用
5. VPN类型：不同VPN协议可能影响检测结果

六、常见问题

Q1: 使用内网但isVpnConnected()返回false？

部分加速网络应用可能使用特殊协议，导致检测不准确。建议结合网络接口信息综合判断。

Q2: VPN检测需要什么权限？

需要 ohos.permission.GET_NETWORK_INFO 等网络相关权限。

Q3: 如何引导用户连接VPN？

可以跳转到系统VPN设置页面，或提供企业VPN应用的下载链接。

Q4: 内网连接后网络变慢怎么办？

内网会增加网络延迟，建议在非必要场景下不强制要求VPN。

总结

NetworkUtil 的VPN检测方法为企业应用安全提供了基础保障。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。合理使用VPN检测，可以确保企业数据安全传输。

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