news 2026/3/20 0:40:16

【鸿蒙 PC 命令行适配】c-ares 在鸿蒙 PC 上的移植与交叉编译实战（可复现指南）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【鸿蒙 PC 命令行适配】c-ares 在鸿蒙 PC 上的移植与交叉编译实战（可复现指南）

文章目录

  • 【鸿蒙 PC 命令行适配】c-ares 在鸿蒙 PC 上的移植与交叉编译实战（可复现指南）
    • 前言
    • 一、OHOS SDK
    • 二、前置环境
    • 三、下载 c-ares 源码
    • 四、配置交叉编译环境（核心步骤）
      • 4.1 CMake 交叉编译参数
    • 五、编译与安装
    • 六、部署到鸿蒙 PC
    • 七、真机验证（关键）
      • 7.1 测试程序（DNS 查询）
      • 7.2 编译链接（鸿蒙 PC）
    • 八、适配过程中的经验总结
    • 九、总结

【鸿蒙 PC 命令行适配】c-ares 在鸿蒙 PC 上的移植与交叉编译实战（可复现指南）

前言

在网络型应用中，DNS 解析是一个绕不开的基础能力。虽然系统通常提供同步的getaddrinfo()接口，但在高并发、事件驱动或网络库内部，阻塞式 DNS往往成为性能瓶颈。

c-ares是一个由 Google 维护的、成熟稳定的异步 DNS 解析库，被广泛用于 curl、Node.js、libuv 等核心项目。它采用纯 C 实现、系统依赖极少，非常适合作为鸿蒙 PC 层的基础网络库。

本文将基于OHOS SDK + Clang/LLVM，完整演示c-ares 在鸿蒙 PC（AArch64）上的交叉编译、部署与真机验证流程，所有步骤均可直接复现。

一、OHOS SDK

OHOS SDK之前的文章也有写过，大体步骤如下
官方下载地址：

https://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist

下载完成后，通常得到一个类似如下名称的压缩包：

ohos-sdk-full_linux_xxx.tar.gz

解压 OHOS SDK

将下载好的 SDK 压缩包解压到一个固定目录（建议统一放在 /opt 或 $HOME 下，便于长期维护）：

tar-xzf ohos-sdk-full_linux_xxx.tar.gz

解压完成后，会得到顶层目录：

ohos-sdk/

进入 ohos-sdk/linux 目录，可以看到多个子组件，其中交叉编译只需要关注以下目录：

接下来分别解压这两个子包（如果它们仍是压缩文件）：

cdohos-sdk/linuxtar-xzf native*.tar.gztar-xzf toolchains*.tar.gz

其中：
llvm包含 Clang、LLVM、lld、llvm-ar 等交叉编译工具

二、前置环境

已经完成以下准备：

  • 已安装OHOS SDK
  • 已配置 Clang/LLVM 工具链
  • 开发机为 Linux x86_64

关键环境变量如下：

exportOHOS_SDK=/opt/ohos-sdk/linux/nativeexportPATH=$OHOS_SDK/llvm/bin:$PATHexportSYSROOT=$OHOS_SDK/sysroot

验证：

clang --version

确认输出来自 OHOS SDK。

三、下载 c-ares 源码

c-ares 官方仓库：

https://github.com/c-ares/c-ares

这里使用稳定版本1.19.x：

wgethttps://github.com/c-ares/c-ares/releases/download/cares-1_19_1/c-ares-1.19.1.tar.gztar-xzf c-ares-1.19.1.tar.gzcdc-ares-1.19.1

目录结构：

四、配置交叉编译环境（核心步骤）

c-ares 使用 CMake，推荐独立构建目录：

mkdirbuild-ohoscdbuild-ohos

4.1 CMake 交叉编译参数

cmake..\-DCMAKE_SYSTEM_NAME=Linux\-DCMAKE_C_COMPILER=clang\-DCMAKE_C_FLAGS="--target=aarch64-linux-ohos --sysroot=$SYSROOT"\-DCARES_STATIC=ON\-DCARES_SHARED=OFF\-DCARES_BUILD_TESTS=OFF\-DCMAKE_INSTALL_PREFIX=$(pwd)/install

参数说明：

参数说明
CMAKE_SYSTEM_NAME=Linux鸿蒙 PC 在 ABI 层与 Linux 兼容
CARES_STATIC=ON优先验证静态库
CARES_SHARED=OFF避免动态库部署干扰
CARES_BUILD_TESTS=OFF交叉编译不跑测试

五、编译与安装

make-j$(nproc)makeinstall



安装完成后得到：

install/ ├── include/ares.h ├── include/ares_version.h └── lib/libcares.a

这说明：

  • c-ares 已成功生成AArch64 鸿蒙 ELF 静态库
  • 头文件与符号导出正常

六、部署到鸿蒙 PC

将目录拷贝到鸿蒙 PC：

七、真机验证（关键）

7.1 测试程序（DNS 查询）

在鸿蒙 PC 上创建测试文件test_ares.c：

#include<stdio.h>#include<ares.h>voidcallback(void*arg,intstatus,inttimeouts,structares_addrinfo*res){if(status==ARES_SUCCESS&&res){printf("DNS resolve success\n");ares_freeaddrinfo(res);}else{printf("DNS resolve failed\n");}}intmain(){ares_library_init(ARES_LIB_INIT_ALL);ares_channel channel;if(ares_init(&channel)!=ARES_SUCCESS){printf("ares_init failed\n");return1;}structares_addrinfo_hintshints={0};hints.ai_family=AF_INET;ares_getaddrinfo(channel,"www.example.com",NULL,&hints,callback,NULL);for(;;){fd_set r,w;intnfds;structtimevaltv;FD_ZERO(&r);FD_ZERO(&w);nfds=ares_fds(channel,&r,&w);if(nfds==0)break;ares_timeout(channel,NULL,&tv);select(nfds,&r,&w,NULL,&tv);ares_process(channel,&r,&w);}ares_destroy(channel);ares_library_cleanup();return0;}

说明：
这里使用select + ares_process，这是 c-ares 最标准、最可移植的用法。

7.2 编译链接（鸿蒙 PC）

clang test_ares.c -I$(pwd)/include$(pwd)/lib/libcares.a -o test_ares

运行：

./test_ares

输出示例：

DNS resolve success


此时证明：

c-ares 静态库正常工作
libcares.a 已经可以在鸿蒙 PC 上被正确链接和调用。
DNS 查询功能正常
ares_getaddrinfo 能够正确向系统 DNS 解析服务器发送请求，并成功返回 IP 地址信息。
输出 DNS resolve success 表示解析 “www.baidu.com” 成功。
交叉编译环境配置正确
用 AArch64 交叉编译生成的静态库，在鸿蒙 PC 的 Linux ABI 层能正确运行，没有出现符号缺失或运行错误。
基础网络调用可用

说明鸿蒙 PC 上的网络栈、select/select-based 事件处理等都可用，c-ares 可以正常工作。

可以写一个更加完善的代码。

#include <stdio.h>#include <stdlib.h>#include <string.h>#include <ares.h>#include <arpa/inet.h>#include <netdb.h>#include <sys/select.h>struct query{const char *hostname;intdone;};void query_callback(void *arg, int status, int timeouts, struct ares_addrinfo *res){struct query *q=(struct query *)arg;q->done=1;// 标记查询完成if(status==ARES_SUCCESS&&res){printf("[%s] DNS resolve success:\n", q->hostname);for(struct ares_addrinfo_node *node=res->nodes;node;node=node->ai_next){char ip[INET6_ADDRSTRLEN];if(node->ai_family==AF_INET){struct sockaddr_in *sa=(struct sockaddr_in *)node->ai_addr;inet_ntop(AF_INET,&sa->sin_addr, ip, sizeof(ip));printf(" IPv4: %s\n",ip);}elseif(node->ai_family==AF_INET6){struct sockaddr_in6 *sa6=(struct sockaddr_in6 *)node->ai_addr;inet_ntop(AF_INET6,&sa6->sin6_addr, ip, sizeof(ip));printf(" IPv6: %s\n",ip);}}ares_freeaddrinfo(res);}else{printf("[%s] DNS resolve failed (status=%d)\n", q->hostname, status);}}intmain(){ares_library_init(ARES_LIB_INIT_ALL);ares_channel channel;if(ares_init(&channel)!=ARES_SUCCESS){fprintf(stderr,"ares_init failed\n");return1;}const char *hosts[]={"www.baidu.com","www.bing.com","www.csdn.net"};const int n_hosts=sizeof(hosts)/sizeof(hosts[0]);struct query queries[n_hosts];memset(queries,0, sizeof(queries));// 初始化查询for(int i=0;i<n_hosts;++i){queries[i].hostname=hosts[i];queries[i].done=0;struct ares_addrinfo_hints hints;memset(&hints,0, sizeof(hints));hints.ai_family=AF_UNSPEC;// IPv4 + IPv6 ares_getaddrinfo(channel, hosts[i], NULL,&hints, query_callback,&queries[i]);}// 事件循环 int unfinished;do{fd_set read_fds, write_fds;FD_ZERO(&read_fds);FD_ZERO(&write_fds);int nfds=ares_fds(channel,&read_fds,&write_fds);if(nfds==0)break;struct timeval tv;struct timeval *tvp=ares_timeout(channel, NULL,&tv);select(nfds,&read_fds,&write_fds, NULL, tvp);ares_process(channel,&read_fds,&write_fds);// 检查是否所有查询完成 unfinished=0;for(int i=0;i<n_hosts;++i){if(!queries[i].done){unfinished=1;break;}}}while(unfinished);ares_destroy(channel);ares_library_cleanup();return0;}

命令：

clang test_ares_multi.c\-I$(pwd)/include\$(pwd)/lib/libcares.a\-o test_ares_multi

运行

./test_ares_multi


支持 IPv4 + IPv6
可同时查询多个域名
使用标准 C 回调，无需 Lambda 或 C++

结论：

c-ares AArch64 静态库在鸿蒙 PC 已经 可用
可以继续开发使用 c-ares 的应用，例如异步 DNS 查询、HTTP 客户端、网络工具等

八、适配过程中的经验总结

在鸿蒙 PC 上移植 c-ares 的过程中，最大的感受是系统的开发环境非常友好。OHOS SDK 提供了完整的 AArch64 交叉编译工具链和清晰的 sysroot 配置，使得从源码到静态库的构建几乎零障碍。即便是网络库这样涉及底层系统调用和事件处理的组件，也能顺利编译、链接并在真机上运行。鸿蒙 PC 的 Linux ABI 兼容性出色，使得 select、poll 等标准接口无需额外适配即可使用，同时静态库部署简单，调试效率高，整体开发体验非常顺畅。

九、总结

通过本次 c-ares 的移植与验证实践，可以看出鸿蒙 PC 的平台生态已经非常成熟且高效。无论是交叉编译工具链、系统兼容性，还是运行时的网络栈和事件机制，都表现出企业级开发所需的稳定性和可靠性。开发者可以放心地在鸿蒙 PC 上构建高性能网络应用，享受到极佳的开发体验，同时充分利用 AArch64 架构优势，实现跨平台、高效、安全的网络服务。鸿蒙 PC 不仅降低了移植门槛，也为网络库和系统组件的创新提供了坚实的基础。

欢迎加入开源鸿蒙PC社区：https://harmonypc.csdn.net/

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/3/19 1:47:28

Clawdbot直连Qwen3-32B实战教程：Web Chat平台API Key分级管理实践

Clawdbot直连Qwen3-32B实战教程&#xff1a;Web Chat平台API Key分级管理实践 1. 为什么需要API Key分级管理 你有没有遇到过这样的情况&#xff1a;团队里不同人用同一个API Key访问大模型服务&#xff0c;结果有人误调用高成本接口&#xff0c;有人把Key不小心贴在公开代码…

作者头像 李华
网站建设 2026/3/13 22:22:55

U盘小问题修复

链接&#xff1a;https://pan.quark.cn/s/e76fa978cc06如果碰到U盘坏了&#xff0c;可以试试这款软件&#xff0c;看能不能修复过来。这款软件不能100%的修复U盘&#xff0c;大家U盘坏了&#xff0c;可以试试软件&#xff0c;但不能保证能成功。打开以后其有4个选择。有“U盘文…

作者头像 李华
网站建设 2026/3/13 16:53:01

OFA视觉问答效果展示：宠物品种识别+年龄/健康状态推测问答

OFA视觉问答效果展示&#xff1a;宠物品种识别年龄/健康状态推测问答 1. 这不是“看图说话”&#xff0c;而是真正能推理的多模态能力 你有没有试过给一张宠物照片&#xff0c;直接问它&#xff1a;“这是什么品种&#xff1f;”、“它大概几岁&#xff1f;”、“看起来健康吗…

作者头像 李华
网站建设 2026/3/13 6:47:07

无需API！VibeThinker-1.5B本地部署完整教程

无需API&#xff01;VibeThinker-1.5B本地部署完整教程 你是否试过在没有网络、不依赖任何云服务、不申请API密钥的前提下&#xff0c;直接在自己电脑上跑一个能解LeetCode难题、能推导数学证明、还能写出可运行代码的AI模型&#xff1f;不是Demo&#xff0c;不是试用版&#…

作者头像 李华
网站建设 2026/3/15 9:54:43

RMBG-1.4开源模型应用：AI净界赋能设计师高效产出可商用透明素材

RMBG-1.4开源模型应用&#xff1a;AI净界赋能设计师高效产出可商用透明素材 1. 什么是AI净界——一张图说清它能帮你省多少时间 你有没有过这样的经历&#xff1a;花20分钟在Photoshop里抠一张毛茸茸的猫&#xff0c;结果发丝边缘还是毛边&#xff1b;或者为电商上新赶制10张…

作者头像 李华