早就打算研究下 OH3.0 的編譯框架了，最近一直在搞移植，總算有點進展了，抽個空來分析下 3.0 的編譯框架。

大體看了下和 2.0 的差別不是特別大：《OpenHarmony 2.0 Canary編譯構建流程》。

OHOS3.0 的打包鏡像腳本由原來 2.0 的 buildadapteruild_image.sh，全部修改替換為 buildohosimagesuild_image.py，將打包 image 鏡像的部分制作成 build_target。

以前是通過 shell 腳本來調用，現在是通過 gn 和 ninja 來調用。主要文件在 buildohosimages 這個文件夾下。

沒有修改的部分就不說了，有需要的可以看我之前的帖子 這篇主要說下不一樣的地方，看 OH3.0 是如何將編譯好的文件打包成鏡像的。

增加編譯參數

3.0 之后在 builduild_scriptsuild_common.sh 增加了 build_cmd+=" build_target=images"。

這句的意思約等于在執行默認編譯命令 ./build.sh --product-name Hi3516DV300 會有個默認的參數 --build-target images。

具體流程是這樣的：

复制action_with_pydeps("${_platform}_${_image_name}_image"){
script="http://build/ohos/images/build_image.py"
depfile="$target_gen_dir/$target_name.d"
deps=["http://build/ohos/packages:${_platform}_install_modules"]

image_config_file=
"http://build/ohos/images/mkimage/${_image_name}_image_conf.txt"
output_image_file="$current_platform_dir/images/${_image_name}.img"

image_input_path="$current_platform_dir/${_image_name}"
if(_image_name=="userdata"){
image_input_path="$current_platform_dir/data"
}

sources=[
image_config_file,
system_module_info_list,
system_modules_list,
]
outputs=[output_image_file]
args=[
"--depfile",
rebase_path(depfile,root_build_dir),
"--image-name",
_image_name,
"--input-path",
rebase_path(image_input_path,root_build_dir),
"--image-config-file",
rebase_path(image_config_file,root_build_dir),
"--output-image",
rebase_path(output_image_file,root_build_dir),
"--build-image-tools-path",
rebase_path(build_image_tools_path,root_build_dir),
]
if(sparse_image){
args+=["--sparse-image"]
}
}

通常情況下，gn 會使用 action 運行一個腳本來生成一個文件，但是這里使用的是 action_with_pydeps，應該也是內置的目標類型。查看官方手冊是這么說明的：

輸入和文件，將操作讀取（或執行）的所有文件列為 inputs：

• 僅按從屬目標列出輸入是不夠的。它們必須由使用它們的目標直接列出，或者由 depfile 添加。

• 非系統 Python 導入是輸入！對于導入此類模塊的腳本，請使用 action_with_pydeps 來確保將所有依賴的 Python 文件捕獲為輸入。

复制image_list=[
"system",
"vendor",
"userdata",
"updater",
]
foreach(_image_name,image_list){......}

調用 python 腳本

复制ifos.path.exists(args.output_image_path):
os.remove(args.output_image_path)#刪除之前生成的鏡像文件夾
ifargs.image_name=='userdata':
_prepare_userdata(args.input_path)#準備好userdata.img需要的文件
ifos.path.isdir(args.input_path):
_make_image(args)
_dep_files=[]
for_root,_,_filesinos.walk(args.input_path):
for_filein_files:
_dep_files.append(os.path.join(_root,_file))
build_utils.write_depfile(args.depfile,
args.output_image_path,
_dep_files,
add_pydeps=False)
===================================================================
def_make_image(args):
ifargs.image_name=='system':
_prepare_root(args.input_path)#準備好system.img需要的文件
elifargs.image_name=='updater':
_prepare_updater(args.input_path)#準備好updater.img需要的文件
image_type="raw"
ifargs.sparse_image:
image_type="sparse"
mk_image_args=[
args.input_path,args.image_config_file,args.output_image_path,
image_type
]
env_path="../../build/ohos/images/mkimage"
ifargs.build_image_tools_path:
env_path='{}:{}'.format(env_path,args.build_image_tools_path)
os.environ['PATH']='{}:{}'.format(env_path,os.environ.get('PATH'))
mkimages.mk_images(mk_image_args)#而真正制作鏡像使用的下面的函數
===================================================================
#buildohosimagesmkimagemkimages.py
defmk_images(args):
......
if"system.img"indevice:
src_dir=build_rootdir(src_dir)
mkfs_tools,mk_configs=load_config(config_file)
mk_configs=src_dir+""+device+""+mk_configs

res=run_cmd(mkfs_tools+""+mk_configs)#制作鏡像命令使用的是mkfs_tools
===================================================================
if"ext4"inmk_configs:
fs_type="ext4"
mkfs_tools="mkextimage.py"#而mkfs_tools根據文件系統類型，分別調用對應的python腳本
elif"f2fs"inmk_configs:
mkfs_tools="mkf2fsimage.py"
fs_type="f2fs"
===================================================================
#buildohosimagesmkimagemkextimage.py#制作ext4文件系統
defbuild_run_mke2fs(args):
.....
blocks=int(int(args.fs_size)/BLOCKSIZE)
mke2fs_cmd+=("mke2fs"+str(mke2fs_opts)+"-t"+FS_TYPE+"-b"
+str(BLOCKSIZE)+""+args.device+""+str(blocks))
res=run_cmd(mke2fs_cmd)# mke2fs：制作文件系統
===================================================================
defbuild_run_e2fsdroid(args):
......
e2fsdroid_cmd+=("e2fsdroid"+e2fsdroid_opts+"-f"+
args.src_dir+"-a"+args.mount_point+
""+args.device)
res=run_cmd(e2fsdroid_cmd)# e2fsdroid：制作鏡像文件

無論前面執行了什么操作，最終都是為了執行 mke2fs、e2fsdroid。

關于這兩個命令：

• mke2fs：Linux 下的命令，用于建立 ext 文件系統。

• e2fsdroid：來自三方庫，third_partye2fsprogs。

詳情可以參考：

复制http://e2fsprogs.sourceforge.net