如何通过OpenHarmony菜单进行网络配置

OpenHarmony菜单进行网络配置的正确路径

一、先明确你的目标菜单类型

• 设备端系统配置菜单：指的是在设备本地通过终端运行配置工具（如 make menuconfig 或某些发行版提供的 openharmonymenuconfig）来调整内核/系统选项。这类菜单主要用于构建镜像时的功能开关与参数设定，并非设备上运行的图形化“设置”。
• 应用层网络配置：指的是在应用内通过 @ohos.net.connection 等 Network Kit API 查询默认网络、监听网络变化、开启/关闭飞行模式等能力，属于运行时配置与状态管理。

二、使用设备端菜单进行网络相关配置

• 进入源码根目录后启动配置界面：执行 make menuconfig。在菜单中可依次进入 Networking 等相关条目，对网络特性进行开关与参数调整；完成后保存退出，配置文件通常生成于 .config，后续编译会将该配置带入镜像。
• 部分发行版/工程可能提供 openharmonymenuconfig 入口，其交互形态与 Kconfig 菜单类似，可在菜单中找到与 Network Configuration 相关的条目进行编辑与保存。
• 重要提示：上述菜单主要用于构建期配置。诸如 IP 地址、子网掩码、网关、DNS 等运行时网络参数通常不属于内核配置项，需在系统启动后由相应的网络管理组件或服务按策略应用（菜单配置无法替代运行时的 DHCP/静态 IP 下发与生效）。

三、在应用内通过菜单入口触发网络配置

• 若你的“菜单”是指应用内的设置页，建议使用 @ohos.net.connection 提供的能力：创建 NetConnection、获取默认网络 getDefaultNet、监听网络能力变化等。示例（ArkTS）：
  • 获取默认数据网络：使用 connection.getDefaultNet，并在模块配置中声明权限 ohos.permission.GET_NETWORK_INFO；该接口可返回 NetHandle，用于进一步查询网络类型与能力。
  • 监听网络：通过 createNetConnection 关注默认网络或特定承载类型（如蜂窝），在网络可用性变化时得到通知，从而刷新 UI 或执行重连逻辑。
  • 飞行模式：可调用模块提供的接口开启/关闭飞行模式，作为网络菜单中的快捷开关能力。

四、常见菜单与用途对照

五、实践建议

• 目标是“设备出厂即生效”的网络行为：在构建期用 make menuconfig 打开/关闭相关网络特性与驱动选项，并确保系统镜像包含所需的网络管理组件与策略。
• 目标是“用户在设备上改 Wi‑Fi/以太网”：在应用层实现设置页，使用 @ohos.net.connection 查询与监听网络，调用系统提供的网络配置接口或发送配置到系统网络服务；静态 IP/网关/DNS 通常由系统在对应网络接口上应用，而非通过构建菜单直接写入。