百万汉字注解 >> 精读鸿蒙源码,中文注解分析, 深挖地基工程,大脑永久记忆,四大码仓每日同步更新< gitee | github | csdn | coding >

百篇博客分析 >> 故事说内核,问答式导读,生活式比喻,表格化说明,图形化展示,主流站点定期更新中< osc | 51cto | csdn | harmony >

编译鸿蒙

因sourecinsight多年的使用习惯,不舍得丢弃, 所以选择在windows + docker 编译鸿蒙.

本篇记录编译鸿蒙的过程,以备后续不用再去一大堆无效的误导式软文中搜寻芝麻大点有用的信息,那样真挺费时费心力.

编译环境

先安装 Docker Desktop 下载windows版本一直下一步.

在windows下拉取openharmony-docker官方镜像,Docker方式获取编译环境 强烈推荐这么做.

docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.3

2.36G, 拉取看网速, 大概10分钟后成功了,有了镜像

PS E:\harmony\kernel_liteos_a_note> docker images
REPOSITORY                                                               TAG       IMAGE ID       CREATED       SIZE  
swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker   0.0.3     50d0aa6ea9ba   2 weeks ago   2.36GB

vscode对docker的管理插件非常的强大,管理镜像和容器的工作就交给它了.

启动docker,创建好容器,本文的选择是这样的,当然大家可以灵活处理,命名. 本文使用E:\harmony\code-1.0 E:\harmony\docker,这两个文件夹一定要先创建好.

容器创建成功后可以在 vscode 右键容器inspect查看到绑定的目录.

"HostConfig": {
    "Binds": [
        "E:\\harmony\\code-1.0:/home/harmony",
        "E:\\harmony\\docker:/home/docker"
    ],

本文这样做的目的为了在windows上能方便的查看文件.harmony目录用于下载编译源码目录,另外一个docker放其他无关文件 repo方式下载源码 进入容器,vscode右键容器 Attach shell,再进入/home/harmony目录

root@5e3abe332c5a:/home/harmony#repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
....
root@5e3abe332c5a:/home/harmony#repo sync -c

这个过程也是比网速.慢慢等吧. 下载完成之后的样子

root@5e3abe332c5a:/home/harmony# ls
applications  base  build  build.py  developtools  device  docs  domains  drivers  foundation  kernel  ohos_config.json   prebuilts  test  third_party  utils  vendor

编译过程

在源码的根目录执行如下命令安装鸿蒙的编译模块hb

root@5e3abe332c5a:/home/harmony#python3 -m pip install --user build/lite

hb全称应该是harmonyos build system,在鸿蒙内核源码分析(编译过程篇)中有详细介绍.

root@5e3abe332c5a:/home/harmony/# hb -v
[OHOS INFO] hb version 0.3.8
root@5e3abe332c5a:/home/harmony/# hb -h
usage: hb

OHOS build system

positional arguments:
  {build,set,env,clean,deps}
    build               Build source code
    set                 OHOS build settings
    env                 Show OHOS build env
    clean               Clean output
    deps                OHOS components deps

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit

设置编译路径,选择当前路径 .

root@5e3abe332c5a:/home/harmony#hb set
[OHOS INFO] Input code path: .
OHOS Which product do you need?  (Use arrow keys)

hisilicon
❯ ipcamera_hispark_aries
wifiiot_hispark_pegasus
ipcamera_hispark_taurus

直接回车,代表选择了ipcamera_hispark_aries,这三个对应平台的关系如下

Hi3518：ipcamera_hispark_aries@hisilicon
Hi3861：wifiiot_hispark_pegasus@hisilicon
Hi3516：ipcamera_hispark_taurus@hisilicon

hb build -*为编译方式,可以选择全编,编单个模块,只编译ndk,看具体的开发场景.

root@5e3abe332c5a:/home/harmony# hb build -h
usage: hb build [-h] [-b BUILD_TYPE] [-c COMPILER] [-t [TEST [TEST ...]]] [--dmverity] [--tee] [-p PRODUCT]
                [-f] [-n] [-T [TARGET [TARGET ...]]] [-v] [-shs]
                [component [component ...]]

positional arguments:
  component             name of the component

optional arguments:
  -h, --help            show this help message and exit
  -b BUILD_TYPE, --build_type BUILD_TYPE
                        release or debug version
  -c COMPILER, --compiler COMPILER
                        specify compiler
  -t [TEST [TEST ...]], --test [TEST [TEST ...]]
                        compile test suit
  --dmverity            Enable dmverity
  --tee                 Enable tee
  -p PRODUCT, --product PRODUCT
                        build a specified product with {product_name}@{company}, eg: camera@huawei
  -f, --full            full code compilation
  -n, --ndk             compile ndk
  -T [TARGET [TARGET ...]], --target [TARGET [TARGET ...]]
                        Compile single target
  -v, --verbose         show all command lines while building
  -shs, --sign_haps_by_server
                        sign haps by server

本文选择全编 -f,拼电脑性能,搞开发一定要搞台好电脑,时间就是生命,内存最好32G,过程大概10分钟.

root@5e3abe332c5a:/home/harmony#hb build -f

查看编译结果

每个的目录含义如下

目录名          描述
applications    应用程序样例，包括wifi-iot，camera等
base            基础软件服务子系统集&硬件服务子系统集
build           组件化编译、构建和配置脚本
docs            说明文档
domains         增强软件服务子系统集
drivers         驱动子系统
foundation      系统基础能力子系统集
kernel          内核子系统
prebuilts       编译器及工具链子系统
test            测试子系统
third_party     开源第三方组件
utils           常用的工具集
vendor          厂商提供的软件
build.py        编译脚本文件
out             编译后生成

编译输出

out为编译结果输出目录

out/hispark_aries/ipcamera_hispark_aries

进入目录

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries# ls
args.gn      build.log      bundle_daemon_tool.map  dev_tools       libs              NOTICE_FILE  OHOS_Image.asm  rootfs            suites     toggleButtonTest.map  userfs            vendor
bin          build.ninja    config                  etc             liteos.bin        obj          OHOS_Image.bin  rootfs_jffs2.img  test       toolchain.ninja       userfs_jffs2.img
bm_tool.map  build.ninja.d  data                    foundation.map  media_server.map  OHOS_Image   OHOS_Image.map  server.map        test_info  unstripped            usr

系列篇会详细讲解启动过程,此处进入bin目录瞅瞅都有些啥好宝贝.

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries/bin# ls
ai_server        module_ActsAbilityMgrTest.bin   module_ActsGraphVersionTest.bin  module_ActsJFFS2CapabilityTest.bin  module_ActsNFSTest.bin           module_ActsSurfaceTest.bin         os_dump
apphilogcat      module_ActsBootstrapTest.bin    module_ActsHeapBaseTest.bin      module_ActsJFFS2DACTest.bin         module_ActsParameterTest.bin     module_ActsSysApiTest.bin          query.bin
appspawn         module_ActsBundleMgrTest.bin    module_ActsHilogTest.bin         module_ActsJFFS2Test.bin            module_ActsPMSTest.bin           module_ActsTimeApiTest.bin         shell
bundle_daemon    module_ActsColorTest.bin        module_ActsIoApiTest.bin         module_ActsKvStoreTest.bin          module_ActsProcessApiTest.bin    module_ActsTransformTest.bin       tftp
CalcSubTest.bin  module_ActsDyloadTest.bin       module_ActsIpcMqTest.bin         module_ActsListTest.bin             module_ActsRectTest.bin          module_ActsUiInterfaceTest1.bin    wms_server
foundation       module_ActsFutexApiTest.bin     module_ActsIpcPipeTest.bin       module_ActsLwipTest.bin             module_ActsSamgrTest.bin         module_ActsUtilApiTest.bin
hilogcat         module_ActsGeometyr2dTest.bin   module_ActsIpcSemTest.bin        module_ActsMathApiTest.bin          module_ActsSchedApiTest.bin      module_ActsVFATCapabilityTest.bin
init             module_ActsGraphicMathTest.bin  module_ActsIpcShmTest.bin        module_ActsMemApiTest.bin           module_ActsSecurityDataTest.bin  module_ActsVFATDACTest.bin
media_server     module_ActsGraphMemApiTest.bin  module_ActsIpcSignalTest.bin     module_ActsNetTest.bin              module_ActsSoftBusTest.bin       module_ActsVFATTest.bin

这难道都是ELF格式可执行程序? 用readelf命令试下shell就知道了.果然是shell程序,加载它将创建激动人心的shell进程

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries/bin# readelf -h shell
ELF Header:
  Magic:   7f 45 4c 46 01 01 01 00 00 00 00 00 00 00 00 00
  Class:                             ELF32
  Data:                              2's complement, little endian
  Version:                           1 (current)
  OS/ABI:                            UNIX - System V
  ABI Version:                       0
  Type:                              DYN (Shared object file)
  Machine:                           ARM
  Version:                           0x1
  Entry point address:               0x1000
  Start of program headers:          52 (bytes into file)
  Start of section headers:          25268 (bytes into file)
  Flags:                             0x5000200, Version5 EABI, soft-float ABI
  Size of this header:               52 (bytes)
  Size of program headers:           32 (bytes)
  Number of program headers:         11
  Size of section headers:           40 (bytes)
  Number of section headers:         27
  Section header string table index: 26

再随便选择一个module_ActsListTest.bin看下,这些是鸿蒙用于测试的代码生成的.也是一个个的独立程序.可以在工程里找到他们的身影list_test.cpp,ActsListTest.json等文件

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries/bin# readelf -h module_ActsListTest.bin 
ELF Header:
  Magic:   7f 45 4c 46 01 01 01 00 00 00 00 00 00 00 00 00        
  Class:                             ELF32
  Data:                              2's complement, little endian
  Version:                           1 (current)
  OS/ABI:                            UNIX - System V
  ABI Version:                       0
  Type:                              DYN (Shared object file)     
  Machine:                           ARM
  Version:                           0x1
  Entry point address:               0xb000
  Start of program headers:          52 (bytes into file)
  Start of section headers:          172256 (bytes into file)
  Flags:                             0x5000200, Version5 EABI, soft-float ABI
  Size of this header:               52 (bytes)
  Size of program headers:           32 (bytes)
  Number of program headers:         11
  Size of section headers:           40 (bytes)
  Number of section headers:         27
  Section header string table index: 26

解读

仔细比较下这两个ELF的头文件看哪里不一样

  Entry point address:               0x1000
  Entry point address:               0xb000

这是.text代码段的入口地址,但注意这并不是 main函数的地址,真正的入口地址是_start,由它再调用main. 具体看 v51.xx (ELF反汇编篇) | 程序的入口函数并不是main < csdn | 51cto | osc >

有详细说明,readelf的功能很强大,有兴趣的可以玩下这个命令,看看elf里面究竟装的啥.

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries/bin# readelf -help
readelf: option requires an argument -- 'p'
Usage: readelf <option(s)> elf-file(s)
 Display information about the contents of ELF format files       
 Options are:
  -a --all               Equivalent to: -h -l -S -s -r -d -V -A -I
  -h --file-header       Display the ELF file header
  -l --program-headers   Display the program headers
     --segments          An alias for --program-headers
  -S --section-headers   Display the sections' header
     --sections          An alias for --section-headers
  -g --section-groups    Display the section groups
  -t --section-details   Display the section details
  -e --headers           Equivalent to: -h -l -S
  -s --syms              Display the symbol table
     --symbols           An alias for --syms
  --dyn-syms             Display the dynamic symbol table
  -n --notes             Display the core notes (if present)      
  -r --relocs            Display the relocations (if present)
  -u --unwind            Display the unwind info (if present)
  -d --dynamic           Display the dynamic section (if present)
  -V --version-info      Display the version sections (if present)
  -A --arch-specific     Display architecture specific information (if any)
  -c --archive-index     Display the symbol/file index in an archive
  -D --use-dynamic       Use the dynamic section info when displaying symbols
  -x --hex-dump=<number|name>
                         Dump the contents of section <number|name> as bytes
  -p --string-dump=<number|name>
                         Dump the contents of section <number|name> as strings
  -R --relocated-dump=<number|name>
                         Dump the contents of section <number|name> as relocated bytes
  -z --decompress        Decompress section before dumping it
  -w[lLiaprmfFsoRtUuTgAckK] or
  --debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,
               =frames-interp,=str,=loc,=Ranges,=pubtypes,
               =gdb_index,=trace_info,=trace_abbrev,=trace_aranges,
               =addr,=cu_index,=links,=follow-links]
                         Display the contents of DWARF debug sections
  --dwarf-depth=N        Do not display DIEs at depth N or greater
  --dwarf-start=N        Display DIEs starting with N, at the same depth
                         or deeper
  --ctf=<number|name>    Display CTF info from section <number|name>
  --ctf-parent=<number|name>
                         Use section <number|name> as the CTF parent

  --ctf-symbols=<number|name>
                         Use section <number|name> as the CTF external symtab

  --ctf-strings=<number|name>
                         Use section <number|name> as the CTF external strtab

  -I --histogram         Display histogram of bucket list lengths
  -W --wide              Allow output width to exceed 80 characters
  @<file>                Read options from <file>
  -H --help              Display this information
  -v --version           Display the version number of readelf

参数中文说明

    -a  --all 显示全部信息，等价于 -h -l -S-s -r -d -V -A -I.
    -h  --file-header 显示elf文件开始的文件头信息.
    -l  --program-headers --segments 显示程序头（段头）信息(如果有的话)。
    -S  --section-headers --sections 显示节头信息(如果有的话)。
    -g  --section-groups 显示节组信息(如果有的话)。
    -t  --section-details 显示节的详细信息(-S 的)。
    -s  --syms --symbols 显示符号表段中的项（如果有的话）。
    -e  --headers 显示全部头信息，等价于: -h -l -S
    -n  --notes 显示note段（内核注释）的信息。
    -r  --relocs 显示可重定位段的信息。
    -u  --unwind 显示unwind段信息。当前只支持 IA64ELF 的 unwind 段信息。
    -d  --dynamic 显示动态段的信息。
    -V  --version-info 显示版本段的信息。
    -A  --arch-specific 显示CPU构架信息。
    -D  --use-dynamic 使用动态段中的符号表显示符号，而不是使用符号段。
    -x  --hex-dump= 以16进制方式显示指定段内内容。number 指定段表中段的索引，或字符串指定文件中的段名。
    -w[liaprmfFsoR] --debug-dump[=line，=info，=abbrev，=pubnames，=aranges，=macro，=frames，=frames-interp，=str，=loc，=Ranges] 显示调试段中指定的内容。
    -I  --histogram 显示符号的时候，显示 bucketlist 长度的柱状图。
    -v  --version 显示 readelf 的版本信息。
    -H  --help 显示 readelf 所支持的命令行选项。
    -W  --wide 宽行输出。
    @file   可以将选项集中到一个文件中，然后使用这个 @file 选项载入。

具体的加载过程和elf格式后续有专门的篇幅详细介绍,此处不做说明.

用户进程

用grep过滤下干扰的*.bin,剩下的就是平台(Hi3518)需要内核创建的用户态进程.

root@5e3abe332c5a:/home/harmony/out/hispark_aries/ipcamera_hispark_aries/bin# ls | grep -v .bin
ai_server
apphilogcat
appspawn
bundle_daemon
foundation
hilogcat
init
media_server
os_dump
shell
tftp
wms_server

这些服务含义和仓库如下.

ai_server       AI业务子系统            https://gitee.com/openharmony/ai_engine
apphilogcat     小型系统的流水日志功能   https://gitee.com/openharmony/hiviewdfx_hilog_lite
                                       base\hiviewdfx\hilog_lite\services\apphilogcat\hiview_applogcat.c
appspawn        应用孵化模块进程        https://gitee.com/openharmony/startup_appspawn_lite
bundle_daemon   用户程序框架内部工具接口 https://gitee.com/openharmony/appexecfwk_appexecfwk_lite
foundation      foundation系统进程      https://gitee.com/openharmony/distributedschedule_safwk_lite
hilogcat        管理日志打印            https://gitee.com/openharmony/hiviewdfx_hilog_lite
                                       base\hiviewdfx\hilog_lite\services\hilogcat\hiview_logcat.c
init            用户态祖宗进程          1号进程, -> 鸿蒙内核源码分析(特殊进程篇)
media_server    播放模块框架实现        https://gitee.com/openharmony/multimedia_media_lite
os_dump         备份文件系统            utils\native\lite\os_dump\os_dump.c
shell           窥视内核的窗口          3号进程, -> 鸿蒙内核源码分析(shell篇)
tftp            传输文件                third_party\curl\lib\tftp.c
wms_server      窗口管理服务            https://gitee.com/openharmony/graphic_wms

在整个项目工程中能轻易找到他们的入口函数.比如appspawn的启动过程

//base\startup\appspawn_lite\services\src\main.c
int main(int argc, char const argv[])
{
    sleep(1);
    HILOG_INFO(HILOG_MODULE_HIVIEW, "[appspawn] main, enter.");

    // 1. ipc module init
    HOS_SystemInit();

    // 2. register signal for SIGCHLD
    SignalRegist();

    // 3. keep process alive
    HILOG_INFO(HILOG_MODULE_HIVIEW, "[appspawn] main, entering wait.");
    while (1) {
        // pause only returns when a signal was caught and the signal-catching function returned.
        // pause only returns -1, no need to process the return value.
        (void)pause();
    }
}

鸿蒙将服务做成了组件,为最上层的应用程度提供管理/工具类的服务.但这些都是framework层的工作,超出了内核源码分析的范畴.希望后续有机会能去剖析它们.

鸿蒙源码百篇博客 往期回顾

在给 鸿蒙内核源码加中文注释 过程中,整理出以下文章.内容立足源码,常以生活场景打比方尽可能多的将内核知识点置入某种场景,具有画面感.百篇博客绝不是百度教条式的在说一堆诘屈聱牙的概念,那没什么意思.更希望让内核变得栩栩如生,倍感亲切.确实有难度,自不量力,但已经出发,回头已是不可能的了.:P

写文章比写代码累多了,越深入研究,越觉得没写好,所以文章和注解会反复修正, .xx代表修改的次数, 将持续完善源码注解和文档内容，精雕细琢，言简意赅, 尽全力打磨精品内容.

• v51.xx (ELF反汇编篇) | 程序的入口函数并不是main < csdn | 51cto | osc >

• v50.xx (编译环境篇) | 编译鸿蒙看这篇或许真的够了 < csdn | 51cto | osc >

• v49.xx (信号消费篇) | 两次切换用户栈和内核栈 < csdn | 51cto | osc >

• v48.xx (信号生产篇) | 如何安装和发送异步信号 < csdn | 51cto | osc >

• v47.xx (进程回收篇) | 进程在临终前如何向老祖宗托孤 < csdn | 51cto | osc >

• v46.xx (特殊进程篇) | 龙生龙,凤生凤,老鼠生儿会打洞 < csdn | 51cto | osc >

• v45.xx (fork篇) | fork是如何做到调用一次,返回两次的 < csdn | 51cto | osc >

• v44.xx (中断管理篇) | 硬中断的实现像观察者模式 < csdn | 51cto | osc >

• v43.xx (中断概念篇) | 外人眼中权势滔天的当红海公公 < csdn | 51cto | osc >

• v42.xx (中断切换篇) | 中断切换又在切换什么 < csdn | 51cto | osc >

• v41.xx (任务切换篇) | 汇编告诉任务到底在切换什么 < csdn | 51cto | osc >

• v40.xx (汇编汇总篇) | 所有的汇编代码都在呢 < csdn | 51cto | osc >

• v39.xx (异常接管篇) | 社会很单纯,复杂的是人 < csdn | 51cto | osc >

• v38.xx (寄存器篇) | 看完再也不对寄存器怕怕 < csdn | 51cto | osc >

• v37.xx (系统调用篇) | 系统调用到底经历了什么 < csdn | 51cto | osc >

• v36.xx (工作模式篇) | cpu是韦小宝,有哪七个老婆 < csdn | 51cto | osc >

• v35.xx (时间管理篇) | tick是操作系统的基本时间单位 < csdn | 51cto | osc >

• v34.xx (原子操作篇) | 是谁在为原子操作保驾护航 < csdn | 51cto | osc >

• v33.xx (消息队列篇) | 进程间如何异步解耦传递大数据 < csdn | 51cto | osc >

• v32.xx (cpu篇) | 整个内核就是一个死循环 < csdn | 51cto | osc >

• v31.xx (定时器篇) | 内核最高优先级任务是谁 < csdn | 51cto | osc >

• v30.xx (事件控制篇) | 任务间多对多的同步方案 < csdn | 51cto | osc >

• v29.xx (信号量篇) | 信号量解决任务的什么问题 < csdn | 51cto | osc >

• v28.xx (进程通讯篇) | 九种进程间通讯方式速揽 < csdn | 51cto | osc >

• v27.xx (互斥锁篇) | 比自旋锁丰满的互斥锁 < csdn | 51cto | osc >

• v26.xx (自旋锁篇) | 自旋锁当立贞节牌坊 < csdn | 51cto | osc >

• v25.xx (并发并行篇) | 两个字永远记住二者区别 < csdn | 51cto | osc >

• v24.xx (进程概念篇) | 进程在管理哪些资源 < csdn | 51cto | osc >

• v23.xx (汇编传参篇) | 汇编如何传递复杂的参数 < csdn | 51cto | osc >

• v22.xx (汇编基础篇) | cpu在哪里打卡上班 < csdn | 51cto | osc >

• v21.xx (线程概念篇) | 是谁在不断的折腾cpu < csdn | 51cto | osc >

• v20.xx (用栈方式篇) | 栈是构建底层运行的基础 < csdn | 51cto | osc >

• v19.xx (位图管理篇) | 为何进程和线程优先级都是32个 < csdn | 51cto | osc >

• v18.xx (源码结构篇) | 梳理内核源文件的作用和含义 < csdn | 51cto | osc >

• v17.xx (物理内存篇) | 怎么管理物理内存 < csdn | 51cto | osc >

• v16.xx (内存规则篇) | 内存管理到底在管什么 < csdn | 51cto | osc >

• v15.xx (内存映射篇) | 虚拟内存虚在哪里 < csdn | 51cto | osc >

• v14.xx (内存汇编篇) | 什么是虚拟内存的实现基础 < csdn | 51cto | osc >

• v13.xx (源码注释篇) | 鸿蒙必须成功,也必然成功 < csdn | 51cto | osc >

• v12.xx (内存管理篇) | 虚拟内存全景图是怎样的 < csdn | 51cto | osc >

• v11.xx (内存分配篇) | 内存有哪些分配方式 < csdn | 51cto | osc >

• v10.xx (内存主奴篇) | 紫禁城的主子和奴才如何相处 < csdn | 51cto | osc >

• v09.xx (调度故事篇) | 用故事说内核调度过程 < csdn | 51cto | osc >

• v08.xx (总目录) | 百万汉字注解 百篇博客分析 < csdn | 51cto | osc >

• v07.xx (调度机制篇) | 任务是如何被调度执行的 < csdn | 51cto | osc >

• v06.xx (调度队列篇) | 内核有多少个调度队列 < csdn | 51cto | osc >

• v05.xx (任务管理篇) | 任务池是如何管理的 < csdn | 51cto | osc >

• v04.xx (任务调度篇) | 任务是内核调度的单元 < csdn | 51cto | osc >

• v03.xx (时钟任务篇) | 谁是触发调度的最大动力 < csdn | 51cto | osc >

• v02.xx (进程管理篇) | 进程是内核资源管理单元 < csdn | 51cto | osc >

• v01.xx (双向链表篇) | 谁是内核最重要结构体 < csdn | 51cto | osc >

进入 >> osc | csdn | 51cto | 掘金 | 公众号 | 头条号 | gitee | github

各大站点搜 "鸿蒙内核源码分析" .原创不易,欢迎转载,但请注明出处.

热爱是所有的理由和答案 - turing