简介
c-ares是异步解析器库,适用于需要无阻塞地执行 DNS 查询或需要并行执行多个 DNS 查询的应用程序。
下载安装
直接在OpenHarmony-SIG仓中搜索c-ares并下载。
使用说明
以OpenHarmony 3.1 Beta的rk3568版本为例
-
将下载的c-ares库代码存在以下路径:./third_party/c-ares
-
修改添加依赖的编译脚本,路径:/developtools/bytrace_standard/ohos.build
{
"subsystem": "developtools",
"parts": {
"bytrace_standard": {
"module_list": [
"//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
"//developtools/bytrace_standard/bin:bytrace_target",
"//developtools/bytrace_standard/bin:bytrace.cfg",
"//developtools/bytrace_standard/interfaces/kits/js/napi:bytrace",
"//third_party/c_ares:c_ares_target"
],
"inner_kits": [
{
"type": "so",
"name": "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
"header": {
"header_files": [
"bytrace.h"
],
"header_base": "//developtools/bytrace_standard/interfaces/innerkits/native/include"
}
}
],
"test_list": [
"//developtools/bytrace_standard/bin/test:unittest"
]
}
}
}
-
编译:./build.sh --product-name rk3568 --ccache
-
生成库文件和一些可执行测试文件,路径:out/rk3568/developtools/profiler
接口说明
- ares对channel进行初始化:
ares_init()
- 销毁channel,释放内存,关闭打开的socket:
ares_destroy(self.channel)
- 初始化channel,options,optmask:
ares_init_options(&channel, &options, optmask)
- 设置dns请求服务器,设置完成需要free掉c_servers的内存空间:
ares_set_servers(self.channel, cares.ares_addr_node* c_servers)
- ares处理完成,返回DNS解析的信息:
dns_callback()
- 获取ares channel使用的FD:
ares_fds()
- 有事件发生,交由ares处理:
ares_process()
- 传递给c-ares channal和回调:
ares_gethostbyaddr()
约束与限制
支持OpenHarmony API version 8 。
目录结构
|---- c-ares
| |---- ci
| |---- docs #资源文件
| |---- include #头文件
| |---- m4 #预处理文件
| |---- src
| |---- lib
| |---- ares__close_sockets.c #关闭TCP和UDP连接
| |---- ares__get_hostent.c #获取area hostent
| |---- ares__read_line.c #将文件中的一行读取到动态分配的缓冲区
| |---- ares__readaddrinfo.c #读取地址信息
| |---- ares__sortaddrinfo.c #对地址进行排序,并重新排列链表
| |---- ares_cancel.c #取消请求
| |---- ares_fds.c #获取使用的FD
| |---- ares_search.c #area搜索
| |---- test #单元测试文件
| |---- README.md #安装使用方法
如果想更深入的学习 OpenHarmony (鸿蒙南向)全栈开发的内容,可以参考以下学习文档:
OpenHarmony 开发环境搭建:https://qr18.cn/CgxrRy
《OpenHarmony源码解析》:https://qr18.cn/CgxrRy
- 搭建开发环境
- Windows 开发环境的搭建
- Ubuntu 开发环境搭建
- Linux 与 Windows 之间的文件共享
- ……
系统架构分析:https://qr18.cn/CgxrRy
- 构建子系统
- 启动流程
- 子系统
- 分布式任务调度子系统
- 分布式通信子系统
- 驱动子系统
- ……
OpenHarmony 设备开发学习手册:https://qr18.cn/CgxrRy
OpenHarmony面试题(内含参考答案):https://qr18.cn/CgxrRy
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:
https://gitee.com/MNxiaona/733GH