HarmonyOS 鸿蒙Next支持发送 ICMP包的库吗

基于NetConnection实现ping工具：

ping工具是实用工具类应用的高频使用场景之一，可用于辅助用户实现简单的网络探测功能。
本示例基于native侧异步任务、net_connection.h和NetConn_ProbeResultInfo实现ping功能以及探测数据统计展示。

实现思路

1. 输入待ping的域名或IP地址，对于输入的内容需要校验其是否为符合要求的域名或IP地址，非法输入需要进行提醒。

TextInput({ text: $$this.pingAddress, placeholder: $r('app.string.ping_input_placeholder') })
   .onChange((value) => {
     // 输入过程不进行检测
     this.isValid = true;
     this.pingAddress = value;
   })
   .onBlur(() => {
     // 输入框失焦后检查输入内容的合法性
     if (this.pingAddress === '') {
       this.isValid = true;
       return;
     }
     this.isValid = this.isValidAddress(this.pingAddress);
   })

1. 点击检测按钮，二次校验输入地址的合法性，校验通过后，调用native侧接口执行ping操作，并在回调中对探测结果进行处理和拼接展示。

// 二次校验
if (!this.isValidAddress(this.pingAddress)) {
  this.isValid = false;
  return;
}
try {
  // 调用Native侧的接口实现ping功能
  PingTool.nativePing(this.pingAddress, 2)
    .then((result) => {
      // 获取返回结果并解析，得到其中的各项数据
      let parseResult = JSON.parse(result) as object;
      let lossRate: number = parseResult['lossRate'];
      let minDelay: number = parseResult['minDelay'];
      let maxDelay: number = parseResult['maxDelay'];
      let avgDelay: number = parseResult['avgDelay'];
      let stdDelay: number = parseResult['stdDelay'];
      // 拼接展示信息
      this.pingMsg += util.format(CommonConstants.PING_MESSAGE_TEMPLATE, this.pingAddress, lossRate, minDelay,
        maxDelay, avgDelay, stdDelay);
      this.pingMsg += '\n\n';
    }).catch((error: BusinessError) => {
    this.pingMsg += `ping failed: ${error.code} ${error.message}`;
  })
} catch (e) {
  // 处理错误
}

1. native侧接收地址和探测持续时间两个参数，使用Promise方式构建异步任务执行ping操作，在任务执行回调中执行ping操作，任务完成回调中处理返回数据。

static napi_value NativePing(napi_env env, napi_callback_info info) {
    // 校验参数合法性，并读取地址参数和持续时间参数
    // 创建异步任务，执行ping操作
    napi_status createPromiseStatus;
    napi_value promiseValue = nullptr;
    napi_deferred deferred = nullptr;
    createPromiseStatus = napi_create_promise(env, &deferred, &promiseValue);

    auto callbackData = new CallbackData();
    callbackData->deferred = deferred;
    callbackData->arg_address = buffer;
    callbackData->arg_duration = duration;

    napi_status createResourceStatus;
    napi_value resourceName = nullptr;
    createResourceStatus = napi_create_string_utf8(env, "PingAsyncCallback", NAPI_AUTO_LENGTH, &resourceName);

    napi_status createAsyncStatus;
    // PingExecuteCB为任务执行回调，负责执行ping操作；PingCompleteCB为任务完成回调，用于处理返回值
    createAsyncStatus = napi_create_async_work(env, nullptr, resourceName, PingExecuteCB, PingCompleteCB, callbackData, &callbackData->asyncWork);
    
    if (napi_queue_async_work(env, callbackData->asyncWork) != napi_ok) {
        ReleaseCallbackData(callbackData);
        napi_delete_async_work(env, callbackData->asyncWork);
        napi_throw_error(env, nullptr, "enqueue async work error");
        return nullptr;
    }

    return promiseValue;
}

1. 实际执行ping操作时，构建NetConn_ProbeResultInfo对象用于储存探测结果，并通过OH_NetConn_QueryProbeResult接口发出探测命令，探测完成后，取出结果数据并拼接为json字符串返回。

NetConn_ProbeResultInfo probeInfo;
probeInfo.lossRate = 0;
probeInfo.rtt[0] = 0;
probeInfo.rtt[1] = 0;
probeInfo.rtt[2] = 0;
probeInfo.rtt[3] = 0;

int32_t ret = OH_NetConn_QueryProbeResult(address, duration, &probeInfo);

// ret!=0时代表调用出错
if (ret != 0) {
    OH_LOG_ERROR(LOG_APP, "query probe info error: ret = %{public}d", ret);
    return nullptr;
}
// 成功调用后，获取返回结果中的丢包率，最小、最大、平均以及标准时延
uint8_t lossRate = probeInfo.lossRate;
uint32_t minDelay = probeInfo.rtt[0];
uint32_t maxDelay = probeInfo.rtt[1];
uint32_t avgDelay = probeInfo.rtt[2];
uint32_t stdDelay = probeInfo.rtt[3];
char *json = nullptr;
try {
    std::ostringstream oss;
    oss << "{\"lossRate\": " << static_cast<int>(lossRate) << ", \"minDelay\": " << minDelay
        << ", \"maxDelay\": " << maxDelay << ", \"avgDelay\": " << avgDelay << ", \"stdDelay\": " << stdDelay
        << "}";
    std::string str = oss.str();
    json = new char[str.size() + 1];
    str.copy(json, str.size(), 0);
    json[str.size()] = '\0';
} catch (const std::bad_alloc& e) {
    // 处理异常
}
return json;

权限说明

使用Internet网络权限：ohos.permission.INTERNET。

参考文档

使用Node-API接口进行异步任务开发
net_connection.h
NetConn_ProbeResultInfo