v60.04 鸿蒙内核源码分析(GN应用篇) | GN语法及在鸿蒙的使用 | 百篇博客分析OpenHarmony源码

司马牛问仁。子曰：“仁者其言也訒。”曰：“其言也訒，斯谓之仁已乎？”子曰：“为之难，言之得无訒乎？” 《论语》：颜渊篇

百篇博客系列篇.本篇为:

v60.xx 鸿蒙内核源码分析(gn应用篇) | gn语法及在鸿蒙的使用

编译构建相关篇为:

• v50.03 鸿蒙内核源码分析(编译环境) | 编译鸿蒙防掉坑指南
• v57.02 鸿蒙内核源码分析(编译过程) | 简单案例窥视编译全过程
• v58.03 鸿蒙内核源码分析(环境脚本) | 编译鸿蒙原来如此简单
• v59.04 鸿蒙内核源码分析(构建工具) | 顺瓜摸藤调试鸿蒙构建过程
• v60.04 鸿蒙内核源码分析(gn应用) | gn语法及在鸿蒙的使用
• v61.03 鸿蒙内核源码分析(忍者ninja) | 都忍者了能不快吗

gn是什么?

gn 存在的意义是为了生成 ninja,如果熟悉前端开发,二者关系很像 Sass和CSS的关系.
为什么会有gn,说是有个叫even的谷歌负责构建系统的工程师在使用传统的makefile构建chrome时觉得太麻烦,不高效,所以设计了一套更简单,更高效新的构建工具gn+ninja,然后就被广泛的使用了.

gn语法和配置

gn 有大量的内置变量和库函数,熟悉这些库函数基本就知道gn能干什么,gn的官方文档很齐全,前往 gn参考手册翻看查找 .
gn 的语法简单,了解以下几点基本就能看懂gn代码.重点了解下函数的调用方式,和其他高级语言不太一样.

字符串

a = "mypath"
b = "$a/foo.cc"  # b -> "mypath/foo.cc"
c = "foo${a}bar.cc"  # c -> "foomypathbar.cc"

列表

a = [ "first" ]
a += [ "second" ]  # [ "first", "second" ]
a += [ "third", "fourth" ]  # [ "first", "second", "third", "fourth" ]
b = a + [ "fifth" ]  # [ "first", "second", "third", "fourth", "fifth" ]

条件语句

if (is_linux || (is_win && target_cpu == "x86")) {
    sources -= [ "something.cc" ]
  }else {
    ...
  }

循环

foreach(i, mylist) {
  print(i)  # Note: i is a copy of each element, not a reference to it.
}

函数调用

print("hello, world")
assert(is_win, "This should only be executed on Windows") # 如果is_win为真,就打印后面的内容
static_library("mylibrary") { 
  sources = [ "a.cc" ]
}

解读:

• print,assert,static_library都是库函数,或者叫内置函数.
• static_library的调用有点奇怪,它是个函数,函数内部会使用sources这个内置变量,sources = [ "a.cc" ]相当于先传参给这个函数的内置变量,并调用这个函数.学习ng得习惯这种语法方式,被大量的使用.

模板 | Templates

gn提供了很多内置函数,使用偏傻瓜式,若构建不复杂的系统,熟悉这些内置函数,选择填空就可以交作业了,如果想高阶点,想自己定义函数怎么办? 答案是模板,模板就是自定义函数.

#定义模板, 文件路径: //tools/idl_compiler.gni, 后缀.gni 代表这是一个 gn import file
template("idl") { #自定义一个名称为 "idl"的函数
  source_set(target_name) { #调用内置函数 source_set
    sources = invoker.sources #invoker为内置变量,含义为调用者内容 即:[ "a", "b" ]的内容
  }
}

#如何使用模板, 用import,类似 C语言的 #include
import("//tools/idl_compiler.gni")
idl("my_interfaces") { #等同于调用 idl
  sources = [ "a", "b" ] #给idl传参, 参数的接收方是 invoker.sources
}

明白了模板的使用,阅读鸿蒙gn代码就不会有太大的障碍.

目标项 | Targets

目标是构建图中的一个节点。它通常表示将生成某种可执行文件或库文件。整个构建是由一个个的目标组成.
目标包含:

action: 运行脚本以生成文件
executable: 生成可执行文件
group: 生成依赖关系组
shared_library: 生成.dll或.so动态链接库
static_library: 生成.lib或.a 静态链接库
...

配置项 | Configs

记录完成目标项所需的配置信息,例如:

config("myconfig") {#创建一个标签为`myconfig`的配置项
    include_dirs = [ "include/common" ]
    defines = [ "ENABLE_DOOM_MELON" ]
  }

executable("mything") {#生成可执行文件
  configs = [ ":myconfig" ]#使用标签为`myconfig`的配置项来生成目标文件
}

gn在鸿蒙中的使用

有了以上基础铺垫,正式开始gn在openharomny中的使用.

从哪开始

在构建工具篇中已经说清楚了 hb的python部分有个工作任务是生成gn命令所需参数. gn生成ninja的命令是 gn gen ...

  /home/tools/gn gen /home/openharmony/code-v1.1.1-LTS/out/hispark_aries/ipcamera_hispark_aries \
  --root=/home/openharmony/code-v1.1.1-LTS \
  --dotfile=/home/openharmony/code-v1.1.1-LTS/build/lite/.gn \
  --script-executable=python3 \
  '--args=ohos_build_type="debug" \
          ohos_build_compiler_specified="clang" \
          ohos_build_compiler_dir="/home/tools/llvm" \
          product_path="/home/openharmony/code-v1.1.1-LTS/vendor/hisilicon/hispark_aries" \
          device_path="/home/openharmony/code-v1.1.1-LTS/device/hisilicon/hispark_aries/sdk_liteos" \
          ohos_kernel_type="liteos_a" \
          enable_ohos_appexecfwk_feature_ability = false \
          ohos_full_compile=true'

解读

• root,dotfile,script-executable是gn内置的固定参数,一切从dotfile指向的文件开始.即build/lite/.gn 相当于main()函数的作用,

• 打开 build/lite/.gn看下内容,只有两句,先配置好内部参数再工作.

  # The location of the build configuration file. #1.完成gn的配置工作
  buildconfig = "//build/lite/config/BUILDCONFIG.gn" 
  
  # The source root location. #2.完成gn的编译工作
  root = "//build/lite" 

• args为用户自定义的参数,它们将会在解析BUILD.gn,BUILDCONFIG.gn过程中被使用.

BUILDCONFIG.gn | 构建配置项

BUILDCONFIG.gn为BUILD.gn做准备,填充好编译所需的配置信息.即生成配置项
详细请查看 build/lite/config/BUILDCONFIG.gn 文件全部内容,本篇只贴出部分.

import("//build/lite/ohos_var.gni")
import("${device_path}/config.gni")
....
arch = "arm"
if (ohos_kernel_type == "liteos_a") {
  target_triple = "$arch-liteos"
} else if (ohos_kernel_type == "linux") {
  target_triple = "$arch-linux-ohosmusl"
}
...
template("executable") { #生成可执行文件
  executable(target_name) {
    forward_variables_from(invoker, Variables_Executable)
    if (!defined(invoker.deps)) {
      deps = [ "//build/lite:prebuilts" ]
    } else {
      deps += [ "//build/lite:prebuilts" ]
    }
    if (defined(invoker.configs)) {
      configs = []
      configs += invoker.configs
    }
  }
}
set_defaults("executable") {#设置目标类型的默认值
  configs = default_executable_configs
  configs += [ "//build/lite/config:board_exe_ld_flags" ]
}
...

解读

• ${device_path}为命令行参数,本篇为home/openharmony/code-v1.1.1-LTS/device/hisilicon/hispark_aries/sdk_liteos
• 查看构建-配置内容,BUILDCONFIG主要任务就是对其中的内置变量赋值.例如:
  • 指定编译器 clang,
  • 如何生成可执行文件的方法等

BUILD.gn | 启动构建

查看 build/lite/BUILD.gn 文件,文件注解较多.

#目的是要得到项目各个模块的编译入口
group("ohos") {
  deps = []
  if (ohos_build_target == "") {
    # Step 1: Read product configuration profile.
    # 第一步:读取配置文件product_path的值来源于根目录的ohos_config.json,如下,内容由 hb set 命令生成
    # {
    #  "root_path": "/home/openharmony",
    #  "board": "hispark_aries",
    #  "kernel": "liteos_a",
    #  "product": "ipcamera_hispark_aries",
    #  "product_path": "/home/openharmony/vendor/hisilicon/hispark_aries",
    #  "device_path": "/home/openharmony/device/hisilicon/hispark_aries/sdk_liteos",
    #  "patch_cache": null
    #}
    product_cfg = read_file("${product_path}/config.json", "json")

    # Step 2: Loop subsystems configured by product.
    # 第二步:循环处理各自子系统,config.json中子系统部分格式如下hb
    #"subsystems": [
    #  {
    #    "subsystem": "aafwk",
    #    "components": [
    #      { "component": "ability", "features":[ "enable_ohos_appexecfwk_feature_ability = false" ] }
    #    ]
    #  },
    #  ...
    #  {
    #    "subsystem": "distributed_schedule",
    #    "components": [
    #   { "component": "system_ability_manager", "features":[] },
    #   { "component": "foundation", "features":[] },
    #   { "component": "distributed_schedule", "features":[] }
    #    ]
    #  },
    #  {
    #      "subsystem": "kernel",
    #      "components": [
    #        { "component": "liteos_a", "features":[] }
    #      ]
    #   },
    #]
    foreach(product_configed_subsystem, product_cfg.subsystems) {#对子系统数组遍历操作
      subsystem_name = product_configed_subsystem.subsystem #读取一个子系统 aafwk,hiviewdfx,security ==
      subsystem_info = {
      }

      # Step 3: Read OS subsystems profile.
        # 第三步: 读取各个子系统的配置文件
      subsystem_info =
          read_file("//build/lite/components/${subsystem_name}.json", "json")

      # Step 4: Loop components configured by product.
      # 第四步: 循环读取子系统内各控件的配置信息
      # 此处以内核为例://build/lite/components/kernel.json"
      # "components": [
      #   {
      #     "component": "liteos_a",              # 组件名称
      #     "description": "liteos-a kernel",     # 组件一句话功能描述
      #     "optional": "false",                  # 组件是否为最小系统必选
      #     "dirs": [                             # 组件源码路径
      #       "kernel/liteos_a"
      #     ],
      #     "targets": [                          # 组件编译入口
      #       "//kernel/liteos_a:kernel"
      #     ],
      #     "rom": "1.98MB",                      # 组件ROM值
      #     "ram": "",                            # 组件RAM估值
      #     "output": [                           # 组件编译输出
      #       "liteos.bin"
      #     ],
      #     "adapted_board": [                    # 组件已适配的主板
      #       "hispark_aries",
      #       "hispark_taurus",
      #       "hi3518ev300",
      #       "hi3516dv300",
      #     ],
      #     "adapted_kernel": [ "liteos_a" ],     # 组件已适配的内核
      #     "features": [],                       # 组件可配置的特性
      #     "deps": {
      #       "components": [],                   # 组件依赖的其他组件
      #       "third_party": [                    # 组件依赖的三方开源软件
      #         "FreeBSD",
      #         "musl",
      #         "zlib",
      #         "FatFs",
      #         "Linux_Kernel",
      #         "lwip",
      #         "NuttX",
      #         "mtd-utils"
      #       ]
      #     }
      #   },
      # ]
      foreach(product_configed_component,
              product_configed_subsystem.components) { #遍历项目控件数组
        # Step 5: Check whether the component configured by product is exist.
            # 第五步: 检查控件配置信息是否存在
        component_found = false #初始为不存在
        foreach(system_component, subsystem_info.components) {#项目控件和子系统中的控件遍历对比
          if (product_configed_component.component ==
              system_component.component) { #找到了liteos_a
            component_found = true
          }
        }
            #如果没找到的信息,则打印项目控件查找失败日志
        assert(
            component_found,
            "Component \"${product_configed_component.component}\" not found" +
                ", please check your product configuration.")
        
        # Step 6: Loop OS components and check validity of product configuration.
        # 第六步: 检查子系统控件的有效性并遍历控件组,处理各个控件
        foreach(component, subsystem_info.components) {
          kernel_valid = false  #检查内核
          board_valid = false   #检查开发板

          # Step 6.1: Skip component which not configured by product.
          if (component.component == product_configed_component.component) {
            # Step 6.1.1: Loop OS components adapted kernel type.
            foreach(component_adapted_kernel, component.adapted_kernel) {
              if (component_adapted_kernel == product_cfg.kernel_type && 
                  kernel_valid == false) { #内核检测是否已适配
                kernel_valid = true
              }
            }
            # 如果内核未适配,则打印未适配日志
            assert(
                kernel_valid,
                "Invalid component configed, ${subsystem_name}:${product_configed_component.component} " + "not available for kernel: ${product_cfg.kernel_type}!")

            # Step 6.1.2: Add valid component for compiling.
            # 添加有效组件进行编译
            foreach(component_target, component.targets) {//遍历组件的编译入口
              deps += [ component_target ] #添加到编译列表中
            }
          }
        }
      }
    }

    # Step 7: Add device and product target by default.
    # 第七步: 添加设备和项目的编译单元
    # "product_path": "/home/openharmony/vendor/hisilicon/hispark_aries",
    # "device_path": "/home/openharmony/device/hisilicon/hispark_aries/sdk_liteos",
      deps += [
      "${device_path}/../", #添加 //device/hisilicon/hispark_aries 进入编译项
      "${product_path}"     #添加 //vendor/hisilicon/hispark_aries 进入编译项
    ]
  } else {#编译指定的组件,例如 hb build -T targetA&&targetB
    deps += string_split(ohos_build_target, "&&")
  }
}

解读

• 有三个概念贯彻整个鸿蒙系统,子系统(subsystems),组件(components),功能(features).理解它们的定位和特点是解读鸿蒙的关键所在.
• 先找到product_path下的 配置文件 config.json,里面配置了项目所要使用的子系统和组件.
• 再遍历项目所使用的组件是否能再 //build/lite/components/*.json组件集中能找到.

• 将找到的组件targets加入到编译列表deps中.targets指向了要编译的组件目录.例如内核组件时指向了://kernel/liteos_a:kernel,

  import("//build/lite/config/component/lite_component.gni") #组件模板函数
  import("//build/lite/config/subsystem/lite_subsystem.gni") #子系统模板函数
  lite_subsystem("kernel") {#编译内核子系统/组件入口
    subsystem_components = []
  
    if (enable_ohos_kernel_liteos_a_ext_build == false) {
      subsystem_components += [
        "//kernel/liteos_a/kernel",
        "//kernel/liteos_a/net",
        "//kernel/liteos_a/lib",
        "//kernel/liteos_a/compat",
        "//kernel/liteos_a/fs",
        "//kernel/liteos_a/arch:platform_cpu",
      ]
      if (LOSCFG_SHELL) {
        subsystem_components += [ "//kernel/liteos_a/shell" ]
      }
    } else {
      deps = [ ":make" ]
    }
  } 

  lite_subsystem是个模板函数(自定义函数),再查看lite_subsystem.gni函数原型,它的目的只有一个填充 deps,deps是私有链接依赖关系,最终会形成一颗依赖树.gn会根据这些依赖关系生成最终的.ninja文件.

  # 定义一个子系统
  # lite_subsystem template模板定义了子系统中包含的所有模块
  # 参数
  #   subsystem_components (必须))
  #     [范围列表] 定义子系统的所有模块.
  template("lite_subsystem") {
      assert(defined(invoker.subsystem_components), "subsystem_components in required.")
  
      lite_subsystem_components = invoker.subsystem_components
  
      group(target_name) {
          deps = []
          if(defined(invoker.deps)) {
              deps += invoker.deps
          }
          # add subsystem packages
          foreach(pkg_label, lite_subsystem_components) {
              deps += [ pkg_label ]
          }
      }
  }

  生成了哪些文件

  执行后gn gen会生成如下文件和目录

  turing@ubuntu:/home/openharmony/code-v1.1.1-LTS/out/hispark_aries/ipcamera_hispark_aries$ ls
  args.gn  build.ninja  build.ninja.d  NOTICE_FILE  obj  test_info  toolchain.ninja

  build.ninja.d中记录依赖的 BUILD.gn文件路径

  build.ninja: ../../../base/global/resmgr_lite/frameworks/resmgr_lite/BUILD.gn \
             ../../../base/hiviewdfx/hilog_lite/frameworks/featured/BUILD.gn \
             ../../../base/hiviewdfx/hilog_lite/services/apphilogcat/BUILD.gn \
             ....

  gn根据这些组件的BUILD.gn在obj目录下对应生成了每个组件的.ninja文件.此处列出鸿蒙L1所有的 .ninja文件, 具体ninja是如何编译成最终的库和可执行文件的,将在后续篇中详细介绍其语法和应用.
  ```
  turing@ubuntu:/home/openharmony/code-v1.1.1-LTS/out/hispark_aries/ipcamera_hispark_aries/obj$ tree
  ├── base
  │   ├── global
  │   │   └── resmgr_lite
  │   │   └── frameworks
  │   │   └── resmgr_lite
  │   │   └── global_resmgr.ninja
  │   ├── hiviewdfx
  │   │   └── hilog_lite
  │   │   ├── frameworks
  │   │   │   └── featured
  │   │   │   ├── hilog_shared.ninja
  │   │   │   └── hilog_static.ninja
  │   │   └── services
  │   │   ├── apphilogcat
  │   │   │   ├── apphilogcat.ninja
  │   │   │   └── apphilogcat_static.ninja
  │   │   └── hilogcat
  │   │   ├── hilogcat.ninja
  │   │   └── hilogcat_static.ninja
  │   ├── security
  │   │   ├── appverify
  │   │   │   └── interfaces
  │   │   │   └── innerkits
  │   │   │   └── appverify_lite
  │   │   │   ├── products
  │   │   │   │   └── ipcamera
  │   │   │   │   └── verify_base.ninja
  │   │   │   ├── unittest
  │   │   │   │   └── app_verify_test.ninja
  │   │   │   └── verify.ninja
  │   │   ├── deviceauth
  │   │   │   └── frameworks
  │   │   │   └── deviceauth_lite
  │   │   │   └── source
  │   │   │   └── hichainsdk.ninja
  │   │   ├── huks
  │   │   │   └── frameworks
  │   │   │   └── huks_lite
  │   │   │   └── source
  │   │   │   └── huks.ninja
  │   │   └── permission
  │   │   └── services
  │   │   └── permission_lite
  │   │   ├── ipc_auth
  │   │   │   └── ipc_auth_target.ninja
  │   │   ├── pms
  │   │   │   └── pms_target.ninja
  │   │   ├── pms_base
  │   │   │   └── pms_base.ninja
  │   │   └── pms_client
  │   │   └── pms_client.ninja
  │   └── startup
  │   ├── appspawn_lite
  │   │   └── services
  │   │   ├── appspawn.ninja
  │   │   └── test
  │   │   └── unittest
  │   │   └── common
  │   │   └── appspawn_test.ninja
  │   ├── bootstrap_lite
  │   │   └── services
  │   │   └── source
  │   │   └── bootstrap.ninja
  │   ├── init_lite
  │   │   └── services
  │   │   ├── init.ninja
  │   │   └── test
  │   │   └── unittest
  │   │   └── common
  │   │   └── init_test.ninja
  │   └── syspara_lite
  │   └── frameworks
  │   ├── parameter
  │   │   └── src
  │   │   └── sysparam.ninja
  │   ├── token
  │   │   └── token_shared.ninja
  │   └── unittest
  │   └── parameter
  │   └── ParameterTest.ninja
  ├── build
  │   └── lite
  │   └── config
  │   └── component
  │   ├── cJSON
  │   │   ├── cjson_shared.ninja
  │   │   └── cjson_static.ninja
  │   ├── openssl
  │   │   ├── openssl_shared.ninja
  │   │   └── openssl_static.ninja
  │   └── zlib
  │   ├── zlib_shared.ninja
  │   └── zlib_static.ninja
  ├── drivers
  │   ├── adapter
  │   │   └── uhdf
  │   │   ├── manager
  │   │   │   └── hdf_core.ninja
  │   │   ├── platform
  │   │   │   └── hdf_platform.ninja
  │   │   ├── posix
  │   │   │   └── hdf_posix_osal.ninja
  │   │   └── test
  │   │   └── unittest
  │   │   ├── common
  │   │   │   └── hdf_test_common.ninja
  │   │   ├── config
  │   │   │   └── hdf_adapter_uhdf_test_config.ninja
  │   │   ├── manager
  │   │   │   ├── hdf_adapter_uhdf_test_door.ninja
  │   │   │   ├── hdf_adapter_uhdf_test_ioservice.ninja
  │   │   │   ├── hdf_adapter_uhdf_test_manager.ninja
  │   │   │   └── hdf_adapter_uhdf_test_sbuf.ninja
  │   │   ├── osal
  │   │   │   └── hdf_adapter_uhdf_test_osal.ninja
  │   │   └── platform
  │   │   └── hdf_adapter_uhdf_test_platform.ninja
  │   └── peripheral
  │   ├── input
  │   │   └── hal
  │   │   └── hdi_input.ninja
  │   └── wlan
  │   ├── client
  │   │   └── wifi_driver_client.ninja
  │   ├── hal
  │   │   └── wifi_hal.ninja
  │   └── test
  │   ├── performance
  │   │   └── hdf_peripheral_wlan_test_performance.ninja
  │   └── unittest
  │   └── hdf_peripheral_wlan_test.ninja
  ├── foundation
  │   ├── aafwk
  │   │   └── aafwk_lite
  │   │   ├── frameworks
  │   │   │   ├── ability_lite
  │   │   │   │   └── ability.ninja
  │   │   │   ├── abilitymgr_lite
  │   │   │   │   └── abilitymanager.ninja
  │   │   │   └── want_lite
  │   │   │   └── want.ninja
  │   │   └── services
  │   │   └── abilitymgr_lite
  │   │   ├── abilityms.ninja
  │   │   ├── tools
  │   │   │   └── aa.ninja
  │   │   └── unittest
  │   │   └── test_lv0
  │   │   └── page_ability_test
  │   │   └── ability_test_pageAbilityTest_lv0.ninja
  │   ├── ai
  │   │   └── engine
  │   │   ├── services
  │   │   │   ├── client
  │   │   │   │   ├── ai_client.ninja
  │   │   │   │   ├── client_executor
  │   │   │   │   │   └── client_executor.ninja
  │   │   │   │   └── communication_adapter
  │   │   │   │   └── ai_communication_adapter.ninja
  │   │   │   ├── common
  │   │   │   │   ├── platform
  │   │   │   │   │   ├── dl_operation
  │   │   │   │   │   │   └── dlOperation.ninja
  │   │   │   │   │   ├── event
  │   │   │   │   │   │   └── event.ninja
  │   │   │   │   │   ├── lock
  │   │   │   │   │   │   └── lock.ninja
  │   │   │   │   │   ├── os_wrapper
  │   │   │   │   │   │   └── ipc
  │   │   │   │   │   │   └── aie_ipc.ninja
  │   │   │   │   │   ├── semaphore
  │   │   │   │   │   │   └── semaphore.ninja
  │   │   │   │   │   ├── threadpool
  │   │   │   │   │   │   └── threadpool.ninja
  │   │   │   │   │   └── time
  │   │   │   │   │   └── time.ninja
  │   │   │   │   ├── protocol
  │   │   │   │   │   └── data_channel
  │   │   │   │   │   └── data_channel.ninja
  │   │   │   │   └── utils
  │   │   │   │   └── encdec
  │   │   │   │   └── encdec.ninja
  │   │   │   └── server
  │   │   │   ├── ai_server.ninja
  │   │   │   ├── communication_adapter
  │   │   │   │   └── ai_communication_adapter.ninja
  │   │   │   ├── plugin_manager
  │   │   │   │   └── plugin_manager.ninja
  │   │   │   └── server_executor
  │   │   │   └── server_executor.ninja
  │   │   └── test
  │   │   ├── common
  │   │   │   ├── ai_test_common.ninja
  │   │   │   └── dl_operation
  │   │   │   └── dl_operation_so
  │   │   │   └── dlOperationSo.ninja
  │   │   ├── function
  │   │   │   ├── ai_test_function.ninja
  │   │   │   └── death_callback
  │   │   │   ├── testDeathCallbackLibrary.ninja
  │   │   │   └── testDeathCallback.ninja
  │   │   ├── performance
  │   │   │   └── ai_test_performance_unittest.ninja
  │   │   └── sample
  │   │   ├── asyncDemoPluginCode.ninja
  │   │   ├── sample_plugin_1.ninja
  │   │   ├── sample_plugin_2.ninja
  │   │   └── syncDemoPluginCode.ninja
  │   ├── appexecfwk
  │   │   └── appexecfwk_lite
  │   │   ├── frameworks
  │   │   │   └── bundle_lite
  │   │   │   └── bundle.ninja
  │   │   └── services
  │   │   └── bundlemgr_lite
  │   │   ├── bundle_daemon
  │   │   │   └── bundle_daemon.ninja
  │   │   ├── bundlems.ninja
  │   │   └── tools
  │   │   └── bm.ninja
  │   ├── communication
  │   │   ├── ipc_lite
  │   │   │   └── liteipc_adapter.ninja
  │   │   └── softbus_lite
  │   │   └── softbus_lite.ninja
  │   ├── distributedschedule
  │   │   ├── dmsfwk_lite
  │   │   │   ├── dmslite.ninja
  │   │   │   └── moduletest
  │   │   │   └── dtbschedmgr_lite
  │   │   │   └── distributed_schedule_test_dms.ninja
  │   │   ├── safwk_lite
  │   │   │   └── foundation.ninja
  │   │   └── samgr_lite
  │   │   ├── communication
  │   │   │   └── broadcast
  │   │   │   └── broadcast.ninja
  │   │   ├── samgr
  │   │   │   ├── adapter
  │   │   │   │   └── samgr_adapter.ninja
  │   │   │   ├── samgr.ninja
  │   │   │   └── source
  │   │   │   └── samgr_source.ninja
  │   │   ├── samgr_client
  │   │   │   └── client.ninja
  │   │   ├── samgr_endpoint
  │   │   │   ├── endpoint_source.ninja
  │   │   │   └── store_source.ninja
  │   │   └── samgr_server
  │   │   └── server.ninja
  │   ├── graphic
  │   │   ├── surface
  │   │   │   ├── surface.ninja
  │   │   │   └── test
  │   │   │   └── lite_surface_unittest.ninja
  │   │   ├── ui
  │   │   │   └── ui.ninja
  │   │   ├── utils
  │   │   │   ├── graphic_hals.ninja
  │   │   │   ├── graphic_utils.ninja
  │   │   │   └── test
  │   │   │   ├── graphic_test_color.ninja
  │   │   │   ├── graphic_test_container.ninja
  │   │   │   ├── graphic_test_geometry2d.ninja
  │   │   │   ├── graphic_test_math.ninja
  │   │   │   └── graphic_test_style.ninja
  │   │   └── wms
  │   │   ├── wms_client.ninja
  │   │   └── wms_server.ninja
  │   └── multimedia
  │   ├── audio_lite
  │   │   └── frameworks
  │   │   └── audio_capturer_lite.ninja
  │   ├── camera_lite
  │   │   └── frameworks
  │   │   └── camera_lite.ninja
  │   ├── media_lite
  │   │   ├── frameworks
  │   │   │   ├── player_lite
  │   │   │   │   └── player_lite.ninja
  │   │   │   └── recorder_lite
  │   │   │   └── recorder_lite.ninja
  │   │   ├── interfaces
  │   │   │   └── kits
  │   │   │   └── player_lite
  │   │   │   └── js
  │   │   │   └── builtin
  │   │   │   └── audio_lite_api.ninja
  │   │   └── services
  │   │   └── media_server.ninja
  │   └── utils
  │   └── lite
  │   └── media_common.ninja
  ├── test
  │   ├── developertest
  │   │   ├── examples
  │   │   │   └── lite
  │   │   │   └── cxx_demo
  │   │   │   └── test
  │   │   │   └── unittest
  │   │   │   └── common
  │   │   │   └── CalcSubTest.ninja
  │   │   └── third_party
  │   │   └── lib
  │   │   └── cpp
  │   │   ├── gtest_main.ninja
  │   │   └── gtest.ninja
  │   └── xts
  │   ├── acts
  │   │   ├── aafwk_lite
  │   │   │   └── ability_posix
  │   │   │   └── module_ActsAbilityMgrTest.ninja
  │   │   ├── ai_lite
  │   │   │   └── ai_engine_posix
  │   │   │   └── base
  │   │   │   ├── module_ActsAiEngineTest.ninja
  │   │   │   └── src
  │   │   │   └── sample
  │   │   │   ├── asyncDemoPluginCode.ninja
  │   │   │   ├── sample_plugin_1_sync.ninja
  │   │   │   ├── sample_plugin_2_async.ninja
  │   │   │   └── syncDemoPluginCode.ninja
  │   │   ├── appexecfwk_lite
  │   │   │   └── bundle_mgr_posix
  │   │   │   └── module_ActsBundleMgrTest.ninja
  │   │   ├── communication_lite
  │   │   │   ├── lwip_posix
  │   │   │   │   └── module_ActsLwipTest.ninja
  │   │   │   └── softbus_posix
  │   │   │   └── module_ActsSoftBusTest.ninja
  │   │   ├── distributed_schedule_lite
  │   │   │   └── samgr_posix
  │   │   │   └── module_ActsSamgrTest.ninja
  │   │   ├── graphic_lite
  │   │   │   ├── graphic_utils
  │   │   │   │   ├── a
  │   │   │   │   │   └── module_ActsUiInterfaceTest1.ninja
  │   │   │   │   ├── color_posix
  │   │   │   │   │   └── module_ActsColorTest.ninja
  │   │   │   │   ├── geometry2d_posix
  │   │   │   │   │   └── module_ActsGeometyr2dTest.ninja
  │   │   │   │   ├── graphic_math_posix
  │   │   │   │   │   └── module_ActsGraphicMathTest.ninja
  │   │   │   │   ├── heap_base_posix
  │   │   │   │   │   └── module_ActsHeapBaseTest.ninja
  │   │   │   │   ├── list_posix
  │   │   │   │   │   └── module_ActsListTest.ninja
  │   │   │   │   ├── mem_api_posix
  │   │   │   │   │   └── module_ActsGraphMemApiTest.ninja
  │   │   │   │   ├── rect_posix
  │   │   │   │   │   └── module_ActsRectTest.ninja
  │   │   │   │   ├── transform_posix
  │   │   │   │   │   └── module_ActsTransformTest.ninja
  │   │   │   │   └── version_posix
  │   │   │   │   └── module_ActsGraphVersionTest.ninja
  │   │   │   ├── surface
  │   │   │   │   └── surface_posix
  │   │   │   │   └── module_ActsSurfaceTest.ninja
  │   │   │   └── ui
  │   │   │   ├── a
  │   │   │   │   └── module_ActsUiInterfaceTest.ninja
  │   │   │   ├── animator_posix
  │   │   │   │   └── module_ActsAnimatorTest.ninja
  │   │   │   ├── easing_equation_posix
  │   │   │   │   └── module_ActsEasingEquationTest.ninja
  │   │   │   ├── events_posix
  │   │   │   │   └── module_ActsEventsTest.ninja
  │   │   │   ├── flexlayout_posix
  │   │   │   │   └── module_ActsFlexlaoutTest.ninja
  │   │   │   ├── gridlayout_posix
  │   │   │   │   └── module_ActsGridLayoutTest.ninja
  │   │   │   ├── image_posix
  │   │   │   │   └── module_ActsImageTest.ninja
  │   │   │   ├── interpolation_posix
  │   │   │   │   └── module_ActsInterpoliationTest.ninja
  │   │   │   ├── layout_posix
  │   │   │   │   └── module_ActsLayoutTest.ninja
  │   │   │   ├── listlayout_posix
  │   │   │   │   └── module_ActsListlayoutTest.ninja
  │   │   │   ├── screen_posix
  │   │   │   │   └── module_ActsScreenTest.ninja
  │   │   │   ├── style_posix
  │   │   │   │   └── module_ActsStyleTest.ninja
  │   │   │   ├── theme_posix
  │   │   │   │   └── module_ActsThemeTest.ninja
  │   │   │   ├── ui_abstract_progress_posix
  │   │   │   │   └── module_ActsUIAbstractProgressTest.ninja
  │   │   │   ├── ui_analog_clock_posix
  │   │   │   │   └── module_ActsUIAnalogClockTest.ninja
  │   │   │   ├── uianimator_posix
  │   │   │   │   └── module_ActsUIAnimatorTest.ninja
  │   │   │   ├── ui_arc_lable_posix
  │   │   │   │   └── module_ActsUIArcLabelTest.ninja
  │   │   │   ├── ui_axis_posix
  │   │   │   │   └── module_ActsUIAxisTest.ninja
  │   │   │   ├── ui_box_porgress_posix
  │   │   │   │   └── module_ActsUIBoxProgressTest.ninja
  │   │   │   ├── ui_button_posix
  │   │   │   │   └── module_ActsUIButtonTest.ninja
  │   │   │   ├── ui_canvas_posix
  │   │   │   │   └── module_ActsUICanvasTest.ninja
  │   │   │   ├── ui_chart_posix
  │   │   │   │   └── module_ActsUIChartTest.ninja
  │   │   │   ├── ui_checbox_posix
  │   │   │   │   └── module_ActsUICheckboxTest.ninja
  │   │   │   ├── ui_circle_progress_posix
  │   │   │   │   └── module_ActsUICircleProgressTest.ninja
  │   │   │   ├── ui_digital_clock_posix
  │   │   │   │   └── module_ActsUIDigitalClockTest.ninja
  │   │   │   ├── ui_image_animator_posix
  │   │   │   │   └── module_ActsUIImageAnimatorTest.ninja
  │   │   │   ├── ui_image_posix
  │   │   │   │   └── module_ActsUIImageTest.ninja
  │   │   │   ├── ui_label_button_posix
  │   │   │   │   └── module_ActsUILabelButtonTest.ninja
  │   │   │   ├── ui_label_posix
  │   │   │   │   └── module_ActsUILabelTest.ninja
  │   │   │   ├── ui_list_posix
  │   │   │   │   └── module_ActsUIListTest.ninja
  │   │   │   ├── ui_picker_posix
  │   │   │   │   └── module_ActsUIPickerTest.ninja
  │   │   │   ├── ui_radio_button_posix
  │   │   │   │   └── module_ActsUIRadioButtonTest.ninja
  │   │   │   ├── ui_repeat_button_posix
  │   │   │   │   └── module_ActsUIRepeatButtonTest.ninja
  │   │   │   ├── ui_screenshot_posix
  │   │   │   │   └── module_ActsUIScreenshotTest.ninja
  │   │   │   ├── ui_scroll_view_posix
  │   │   │   │   └── module_ActsUIScrollViewTest.ninja
  │   │   │   ├── ui_slider_posix
  │   │   │   │   └── module_ActsUISliderTest.ninja
  │   │   │   ├── ui_surface_view_posix
  │   │   │   │   └── module_ActsUISurfaceViewTest.ninja
  │   │   │   ├── ui_swipe_view_posix
  │   │   │   │   └── module_ActsUISwipeViewTest.ninja
  │   │   │   ├── ui_text_posix
  │   │   │   │   └── module_ActsUITextTest.ninja
  │   │   │   ├── ui_texture_mapper_posix
  │   │   │   │   └── module_ActsUITextureMapperTest.ninja
  │   │   │   ├── ui_time_picker_posix
  │   │   │   │   └── module_ActsUITimePickerTest.ninja
  │   │   │   ├── ui_toggle_button_posix
  │   │   │   │   └── module_ActsUIToggleButtonTest.ninja
  │   │   │   ├── ui_view_group_posix
  │   │   │   │   └── module_ActsUIViewGroupTest.ninja
  │   │   │   └── ui_view_posix
  │   │   │   └── module_ActsUIViewTest.ninja
  │   │   ├── hiviewdfx_lite
  │   │   │   └── hilog_posix
  │   │   │   └── module_ActsHilogTest.ninja
  │   │   ├── kernel_lite
  │   │   │   ├── dyload_posix
  │   │   │   │   └── module_ActsDyloadTest.ninja
  │   │   │   ├── fs_posix
  │   │   │   │   ├── jffs
  │   │   │   │   │   └── module_ActsJFFS2Test.ninja
  │   │   │   │   ├── nfs
  │   │   │   │   │   └── module_ActsNFSTest.ninja
  │   │   │   │   ├── vfat
  │   │   │   │   │   └── module_ActsVFATTest.ninja
  │   │   │   │   └── vfat_storage
  │   │   │   │   └── module_ActsVFATstorageTest.ninja
  │   │   │   ├── futex_posix
  │   │   │   │   └── module_ActsFutexApiTest.ninja
  │   │   │   ├── io_posix
  │   │   │   │   └── module_ActsIoApiTest.ninja
  │   │   │   ├── ipc_posix
  │   │   │   │   ├── message_queue
  │   │   │   │   │   └── module_ActsIpcMqTest.ninja
  │   │   │   │   ├── pipe_fifo
  │   │   │   │   │   └── module_ActsIpcPipeTest.ninja
  │   │   │   │   ├── semaphore
  │   │   │   │   │   └── module_ActsIpcSemTest.ninja
  │   │   │   │   ├── shared_memory
  │   │   │   │   │   └── module_ActsIpcShmTest.ninja
  │   │   │   │   └── signal
  │   │   │   │   └── module_ActsIpcSignalTest.ninja
  │   │   │   ├── math_posix
  │   │   │   │   ├── complexTest.ninja
  │   │   │   │   └── module_ActsMathApiTest.ninja
  │   │   │   ├── mem_posix
  │   │   │   │   └── module_ActsMemApiTest.ninja
  │   │   │   ├── net_posix
  │   │   │   │   └── module_ActsNetTest.ninja
  │   │   │   ├── process_posix
  │   │   │   │   └── module_ActsProcessApiTest.ninja
  │   │   │   ├── sched_posix
  │   │   │   │   └── module_ActsSchedApiTest.ninja
  │   │   │   ├── sys_posix
  │   │   │   │   └── module_ActsSysApiTest.ninja
  │   │   │   ├── time_posix
  │   │   │   │   └── module_ActsTimeApiTest.ninja
  │   │   │   ├── util_posix
  │   │   │   │   └── module_ActsUtilApiTest.ninja
  │   │   │   └── utils
  │   │   │   ├── libfs.ninja
  │   │   │   ├── libmt_utils.ninja
  │   │   │   └── libutils.ninja
  │   │   ├── multimedia_lite
  │   │   │   └── media_lite_posix
  │   │   │   └── recorder_native
  │   │   │   └── module_ActsMediaRecorderTest.ninja
  │   │   ├── security_lite
  │   │   │   ├── datahuks_posix
  │   │   │   │   └── module_ActsSecurityDataTest.ninja
  │   │   │   └── permission_posix
  │   │   │   ├── capability
  │   │   │   │   ├── capability_shared.ninja
  │   │   │   │   ├── jffs
  │   │   │   │   │   └── module_ActsJFFS2CapabilityTest.ninja
  │   │   │   │   └── vfat
  │   │   │   │   └── module_ActsVFATCapabilityTest.ninja
  │   │   │   ├── dac
  │   │   │   │   ├── jffs
  │   │   │   │   │   └── module_ActsJFFS2DACTest.ninja
  │   │   │   │   └── vfat
  │   │   │   │   └── module_ActsVFATDACTest.ninja
  │   │   │   └── pms
  │   │   │   └── module_ActsPMSTest.ninja
  │   │   ├── startup_lite
  │   │   │   ├── bootstrap_posix
  │   │   │   │   └── module_ActsBootstrapTest.ninja
  │   │   │   └── syspara_posix
  │   │   │   └── module_ActsParameterTest.ninja
  │   │   └── utils_lite
  │   │   └── kv_store_posix
  │   │   └── module_ActsKvStoreTest.ninja
  │   └── tools
  │   └── lite
  │   ├── hcpptest
  │   │   ├── gmock_main.ninja
  │   │   ├── gmock.ninja
  │   │   ├── hcpptest_main.ninja
  │   │   └── hcpptest.ninja
  │   └── others
  │   └── query
  │   └── query.ninja
  ├── third_party
  │   ├── bounds_checking_function
  │   │   ├── libsec_shared.ninja
  │   │   └── libsec_static.ninja
  │   ├── freetype
  │   │   └── freetype.ninja
  │   ├── giflib
  │   │   └── libgif.ninja
  │   ├── iniparser
  │   │   └── iniparser.ninja
  │   ├── libjpeg
  │   │   └── libjpeg.ninja
  │   ├── libpng
  │   │   └── libpng.ninja
  │   ├── mbedtls
  │   │   ├── mbedtls_gt.ninja
  │   │   ├── mbedtls_shared.ninja
  │   │   └── mbedtls_static.ninja
  │   └── qrcodegen
  │   └── qrcodegen.ninja
  ├── utils
  │   └── native
  │   └── lite
  │   ├── kv_store
  │   │   └── src
  │   │   └── utils_kv_store.ninja
  │   └── os_dump
  │   └── os_dump.ninja
  └── vendor
  └── hisilicon
  └── hispark_aries
  └── hals
  ├── security
  │   └── permission_lite
  │   └── hal_pms.ninja
  └── utils
  ├── sys_param
  │   └── hal_sysparam.ninja
  └── token
  └── haltoken_shared.ninja

```

百篇博客分析.深挖内核地基

• 给鸿蒙内核源码加注释过程中，整理出以下文章。内容立足源码，常以生活场景打比方尽可能多的将内核知识点置入某种场景，具有画面感，容易理解记忆。说别人能听得懂的话很重要! 百篇博客绝不是百度教条式的在说一堆诘屈聱牙的概念，那没什么意思。更希望让内核变得栩栩如生，倍感亲切.确实有难度，自不量力，但已经出发，回头已是不可能的了。　
• 与代码有bug需不断debug一样，文章和注解内容会存在不少错漏之处，请多包涵，但会反复修正，持续更新，v**.xx 代表文章序号和修改的次数，精雕细琢，言简意赅，力求打造精品内容。

按功能模块:

基础工具	加载运行	进程管理	编译构建
双向链表 位图管理 用栈方式 定时器 原子操作 时间管理	ELF格式 ELF解析 静态链接 重定位 进程映像	进程管理 进程概念 Fork 特殊进程 进程回收 信号生产 信号消费 Shell编辑 Shell解析	编译环境 编译过程 环境脚本 构建工具 gn应用 忍者ninja
进程通讯	内存管理	前因后果	任务管理
自旋锁 互斥锁 进程通讯 信号量 事件控制 消息队列	内存分配 内存管理 内存汇编 内存映射 内存规则 物理内存	总目录 调度故事 内存主奴 源码注释 源码结构 静态站点	时钟任务 任务调度 任务管理 调度队列 调度机制 线程概念 并发并行 CPU 系统调用 任务切换
文件系统	硬件架构
文件概念 文件系统 索引节点 挂载目录 根文件系统 字符设备 VFS 文件句柄 管道文件	汇编基础 汇编传参 工作模式 寄存器 异常接管 汇编汇总 中断切换 中断概念 中断管理

百万汉字注解.精读内核源码

四大码仓中文注解 . 定期同步官方代码

鸿蒙研究站( weharmonyos ) | 每天死磕一点点，原创不易，欢迎转载，请注明出处。若能支持点赞更好，感谢每一份支持。