前言

运营商信息和选网模式是移动通信管理的重要组成部分。@pura/harmony-utils 的 NetworkUtil 封装了运营商查询方法，帮助开发者获取网络注册运营商、选网模式等信息。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解，帮助开发者快速掌握并应用到实际项目中。

一、NetworkUtil运营商核心API

NetworkUtil 提供了以下运营商查询方法：

方法	说明	返回类型	使用场景
getNetworkOperator()	获取网络注册运营商	string	运营商识别
getNetworkOperatorName()	获取运营商名称	string	UI展示
getNetworkCountryCode()	获取网络国家代码	string	地区判断
getNetworkSelectionMode()	获取选网模式	string	网络管理

1.1 核心特性

• 简洁易用：封装复杂API为一行调用，降低使用门槛
• 类型安全：完整的TypeScript类型定义，编译期即可发现错误
• 异常处理：内置异常捕获机制，避免运行时崩溃
• 信息全面：覆盖运营商代码、名称、国家代码

1.2 选网模式说明

选网模式	说明	适用场景
AUTO	自动选网	普通用户
MANUAL	手动选网	专业用户

二、完整使用步骤

2.1 安装依赖

ohpm install @pura/harmony-utils

2.2 查询运营商信息

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

Button('查询运营商')
  .width('100%')
  .onClick(() => {
    try {
      let operator = NetworkUtil.getNetworkOperatorName();
      let code = NetworkUtil.getNetworkCountryCode();
      this.result = `运营商: ${operator}\n国家代码: ${code}`;
    } catch (e) {
      this.result = '异常: ' + e;
    }
  })

2.3 查询选网模式

Button('查询选网模式')
  .width('100%')
  .onClick(() => {
    try {
      let mode = NetworkUtil.getNetworkSelectionMode();
      this.result = `选网模式: ${mode}`;
    } catch (e) {
      this.result = '异常: ' + e;
    }
  })

三、完整页面示例

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

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

  build() {
    Column({ space: 12 }) {
      Button('获取运营商信息').width('100%').onClick(() => {
        try {
          let name = NetworkUtil.getNetworkOperatorName();
          let code = NetworkUtil.getNetworkCountryCode();
          this.result = `运营商: ${name}\n国家: ${code}`;
        } catch (e) { this.result = '异常: ' + e; }
      });
      Text(this.result).fontSize(14).fontColor('#333333')
    }
    .padding(16)
  }
}

四、进阶用法

4.1 运营商定制功能

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

function getOperatorConfig(): Record<string, string> {
  let operator = NetworkUtil.getNetworkOperatorName();
  if (operator.includes('移动')) return { server: 'cmcc.api.com' };
  if (operator.includes('联通')) return { server: 'cucc.api.com' };
  return { server: 'default.api.com' };
}

4.2 跨国网络检测

function isDomesticNetwork(): boolean {
  let code = NetworkUtil.getNetworkCountryCode();
  return code === 'CN';
}

五、注意事项

1. 权限要求：运营商信息查询需要相应权限
2. 双卡设备：不同SIM卡可能注册不同运营商
3. 漫游状态：漫游时运营商信息可能不同
4. 初始化依赖：使用前需确保 AppUtil.init() 已调用
5. 信息变化：运营商信息可能随网络切换变化

六、常见问题

Q1: getNetworkOperator()返回数字代码还是名称？

返回运营商的数字代码（MCC+MNC），如需名称请使用 getNetworkOperatorName()。

Q2: 漫游时运营商信息会变化吗？

漫游时注册运营商可能变为当地运营商，SIM卡运营商不变。

Q3: 如何区分SIM卡运营商和注册运营商？

SIM卡运营商通过 getSimOperatorName() 获取，注册运营商通过 getNetworkOperatorName() 获取。

Q4: 选网模式可以修改吗？

普通应用无法修改选网模式，需引导用户到系统设置中修改。

总结

NetworkUtil 的运营商查询方法为移动通信管理提供了数据支撑。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以根据运营商信息实现定制功能和网络管理。

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