鸿蒙开发（NEXT/API 12）【NetConnection开发】 网络篇
场景介绍
NetConnection模块提供了常用网络信息查询的能力。
接口说明
| 接口名 | 描述 |
|---|---|
| OH_NetConn_HasDefaultNet(int32_t *hasDefaultNet) | 检查默认数据网络是否被激活，判断设备是否有网络连接，以便在应用程序中采取相应的措施。 |
| OH_NetConn_GetDefaultNet(NetConn_NetHandle *netHandle) | 获得默认激活的数据网络。 |
| OH_NetConn_IsDefaultNetMetered(int32_t *isMetered) | 检查当前网络上的数据流量使用是否被计量 |
| OH_NetConn_GetConnectionProperties(NetConn_NetHandle *netHandle, NetConn_ConnectionProperties *prop) | 获取netHandle对应的网络的连接信息。 |
| OH_NetConn_GetNetCapabilities (NetConn_NetHandle *netHandle, NetConn_NetCapabilities *netCapacities) | 获取netHandle对应的网络的能力信息。 |
| OH_NetConn_GetDefaultHttpProxy (NetConn_HttpProxy *httpProxy) | 获取网络默认的代理配置信息。 如果设置了全局代理，则会返回全局代理配置信息。如果进程已经绑定到指定netHandle对应的网络，则返回网络句柄对应网络的代理配置信息。在其它情况下，将返回默认网络的代理配置信息。 |
| OH_NetConn_GetAddrInfo (char *host, char *serv, struct addrinfo *hint, struct addrinfo **res, int32_t netId) | 通过netId获取DNS结果。 |
| OH_NetConn_FreeDnsResult(struct addrinfo *res) | 释放DNS结果内存。 |
| OH_NetConn_GetAllNets(NetConn_NetHandleList *netHandleList) | 获取所有处于连接状态的网络列表。 |
| OHOS_NetConn_RegisterDnsResolver(OH_NetConn_CustomDnsResolver resolver) | 注册自定义dns解析器。 |
| OHOS_NetConn_UnregisterDnsResolver(void) | 去注册自定义dns解析器。 |
网络管理接口开发示例
开发步骤
使用本文档涉及接口获取网络相关信息时，需先创建Native C++工程，在源文件中将相关接口封装，再在ArkTs层对封装的接口进行调用，使用hilog或者console.log等手段选择打印在控制台或者生成设备日志。
本文以实现获取默认激活的数据网络为例，给出具体的开发指导。
添加开发依赖
添加动态链接库
CMakeLists.txt中添加以下lib:
libace_napi.z.so
libnet_connection.so
头文件
#include "napi/native_api.h"
#include "network/netmanager/net_connection.h"
#include "network/netmanager/net_connection_type.h"
构建工程
1、在源文件中编写调用该API的代码，并将结果封装成一个napi_value类型的值返回给 Node.js 环境。
// Get the execution results of the default network connection.
static napi_value GetDefaultNet(napi_env env, napi_callback_info info)
{
size_t argc = 1;
napi_value args[1] = {nullptr};
napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
int32_t param;
napi_get_value_int32(env, args[0], ¶m);
NetConn_NetHandle netHandle;
if (param== 0) {
param= OH_NetConn_GetDefaultNet(NULL);
} else {
param= OH_NetConn_GetDefaultNet(&netHandle);
}
napi_value result;
napi_create_int32(env, param, &result);
return result;
}
// Get the ID of the default network connection.
static napi_value NetId(napi_env env, napi_callback_info info) {
int32_t defaultNetId;
NetConn_NetHandle netHandle;
OH_NetConn_GetDefaultNet(&netHandle);
defaultNetId = netHandle.netId; // Get the default netId
napi_value result;
napi_create_int32(env, defaultNetId, &result);
return result;
}
简要说明：这两个函数是用于获取系统默认网络连接的相关信息的。其中，GetDefaultNet是接收ArkTs端传入的测试参数，返回调用接口后对应的返回值，param可以自行调整；如果返回值为0，代表获取成功，401代表参数错误，201代表没有权限；而NetId函数则用于获取默认网络连接的ID。这些信息可以用于进一步的网络操作。
2、将通过napi封装好的napi_value类型对象初始化导出，通过外部函数接口，将以上两个函数暴露给JavaScript使用。
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
// Information used to describe an exported attribute. Two properties are defined here: `GetDefaultNet` and `NetId`.
napi_property_descriptor desc[] = {
{"GetDefaultNet", nullptr, GetDefaultNet, nullptr, nullptr, nullptr, napi_default, nullptr},
{"NetId", nullptr, NetId, nullptr, nullptr, nullptr, napi_default, nullptr}};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
3、将上一步中初始化成功的对象通过RegisterEntryModule函数，使用napi_module_register函数将模块注册到 Node.js 中。
static napi_module demoModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "entry",
.nm_priv = ((void*)0),
.reserved = { 0 },
};
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
napi_module_register(&demoModule);
}
4、在工程的index.d.ts文件中定义两个函数的类型。
- GetDefaultNet 函数接受一个数字参数 code，返回一个数字类型的值。
- NetId 函数不接受参数，返回一个数字类型的值。
export const GetDefaultNet: (code: number) => number;
export const NetId: () => number;
5、在index.ets文件中对上述封装好的接口进行调用
import testNetManager from 'libentry.so';
@Entry
@Component
struct Index {
@State message: string = '';
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button('GetDefaultNet').onClick(event => {
this.GetDefaultNet();
})
Button('CodeNumber').onClick(event =>{
this.CodeNumber();
})
}
.width('100%')
}
.height('100%')
}
GetDefaultNet() {
let netid = testNetManager.NetId();
console.log("The defaultNetId is [" + netid + "]");
}
CodeNumber() {
let testParam = 0;
let codeNumber = testNetManager.GetDefaultNet(testParam);
if (codeNumber === 0) {
console.log("Test success. [" + codeNumber + "]");
} else if (codeNumber === 201) {
console.log("Missing permissions. [" + codeNumber + "]");
} else if (codeNumber === 401) {
console.log("Parameter error. [" + codeNumber + "]");
}
}
}
6、配置CMakeLists.txt，本模块需要用到的共享库是libnet_connection.so，在工程自动生成的CMakeLists.txt中的target_link_libraries中添加此共享库。
注意：如图所示，在add_library中的entry是工程自动生成的modename，若要做修改，需和步骤3中.nm_modname保持一致；
经过以上步骤，整个工程的搭建已经完成，接下来就可以连接设备运行工程进行日志查看了。
测试步骤
1、连接设备，使用DevEco Studio打开搭建好的工程
2、运行工程，设备上会弹出以下所示图片：
简要说明：
- 在点击 GetDefaultNet 时，获取的是默认网络ID。
- 在点击 codeNumber 时，获取的是接口返回的响应状态码。
3、点击 GetDefaultNet 按钮，控制台会打印日志：
4、点击 codeNumber 按钮，控制台会打印相应的响应状态码：
最后呢
很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。
而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点
如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。
针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。
- 《鸿蒙 (OpenHarmony)开发学习视频》
- 《鸿蒙生态应用开发V2.0白皮书》
- 《鸿蒙 (OpenHarmony)开发基础到实战手册》
- OpenHarmony北向、南向开发环境搭建
- 《鸿蒙开发基础》
- 《鸿蒙开发进阶》
- 《鸿蒙开发实战》
总结
鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。
并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿
