OpenHarmony网络协议通信c-ares [交叉编译]异步解析器库

173 阅读2分钟

简介

c-ares是异步解析器库,适用于需要无阻塞地执行 DNS 查询或需要并行执行多个 DNS 查询的应用程序。

下载安装

直接在OpenHarmony-SIG仓中搜索c-ares并下载。

使用说明

以OpenHarmony 3.1 Beta的rk3568版本为例

  1. 将下载的c-ares库代码存在以下路径:./third_party/c-ares

  2. 修改添加依赖的编译脚本,路径:/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"
      ]
    }
  }
}
  1. 编译:./build.sh --product-name rk3568 --ccache

  2. 生成库文件和一些可执行测试文件,路径:out/rk3568/developtools/profiler

DD一下:欢迎大家关注公众号<程序猿百晓生>,可以了解到以下内容:

1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题(含参考答案) 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

接口说明

  1. ares对channel进行初始化: ares_init()
  2. 销毁channel,释放内存,关闭打开的socket: ares_destroy(self.channel)
  3. 初始化channel,options,optmask: ares_init_options(&channel, &options, optmask)
  4. 设置dns请求服务器,设置完成需要free掉c_servers的内存空间: ares_set_servers(self.channel, cares.ares_addr_node* c_servers)
  5. ares处理完成,返回DNS解析的信息: dns_callback()
  6. 获取ares channel使用的FD: ares_fds()
  7. 有事件发生,交由ares处理: ares_process()
  8. 传递给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                    #安装使用方法