OpenHarmony模块化编译

原创已于 2025-09-19 14:45:41 修改 · 4.8k 阅读

40 ·

CC 4.0 BY-SA版权

文章标签：

#OpenHarmony

于 2023-11-27 16:43:13 首次发布

OpenHarmony 专栏收录该内容

12 篇文章

订阅专栏

本文介绍OpenHarmony模块化编译，包括环境配置（OpenHarmony 4.0、WSL2 Ubuntu 18.04、RK3568）、hb配置。为提高开发效率，使用模块化编译替换全量编译，以关机弹框应用为例说明编译步骤，还列举常用模块编译，如Full SDK、常见原生应用、foundation常用库等。

一、环境配置

OpenHarmony版本：OpenHarmony 4.0 Release
编译环境：WSL2 Ubuntu 18.04
平台设备：RK3568

二、配置hb

OpenHarmony 代码构建有build.sh和hb两种方式:

#方式一、build.sh
./build.sh --product-name rk3568 --ccache

#方式二、hb
hb set -p rk3568
hb build

下拉的4.0代码无法直接使用hb命令

OpenHarmony_4.0_release$ hb --help
hb_error: Please call hb utilities inside source root directory

可参考搭建开发环境-安装编译工具进行hb安装和环境配置。

2.1、安装hb

python3 -m pip install --user build/hb

2.2、配置环境变量

vim ~/.bashrc
#将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/.local/bin:$PATH

#更新环境变量
source ~/.bashrc

在源码目录执行"hb help"，界面打印以下信息即表示安装成功。

OpenHarmony_4.0_release$ hb help
[OHOS INFO] ----------------------------------------------------------------------------------------------------
[OHOS INFO] usage: hb build [option]
[OHOS INFO]
[OHOS INFO] optional arguments:
[OHOS INFO]   -h, --help            show this help message and exit
[OHOS INFO]   --target-cpu {arm,arm64,x86_64,x64}
[OHOS INFO]                         Default:''. Help:Specifies the desired cpu architecture for the build, each may support
[OHOS INFO]                         different cpu architectures, run 'hb set --all' to list product all supported cpu
[OHOS INFO]                         architectures
[OHOS INFO]   --target-os {android,ios}
[OHOS INFO]                         Default:''. Help:Specifies the desired os type for the build, each may support different os
[OHOS INFO]                         type, run 'hb set --all' to list product all supported os type
[OHOS INFO]   -p PRODUCT_NAME, --product-name PRODUCT_NAME
[OHOS INFO]                         Default:''. Help:Build a specified product. You could use this option like this: 1.'hb build
[OHOS INFO]                         --product-name rk3568@hihope' 2.'hb build --product-name rk3568'
...

注：可使用以下命令卸载hb

$ python3 -m pip uninstall ohos-build

三、了解模块编译

为了编译调试和开发验证往往使用模块化编译替换全量编译，节约编译时间，提高开发效率，OpenHarmony build.sh 和hb都支持模块化编译。
这里以关机弹框应用为例。
1、通过hdc 查看system/app应用包名或者IDE查看调出关机框log，可知关机弹框所在应用包名为com.ohos.powerdialog

# ls -al /system/app
com.ohos.powerdialog

2、在源码中搜索com.ohos.powerdialog包名定义出处，确定模块对应的源码路径。
可知系统关机弹框源码位于：base/powermgr/power_manager/power_dialog
在这里插入图片描述
3、确定build-target,查看base/powermgr/power_manager/power_dialog/BUILD.gn
可知系统关机框模块名power_dialog_hap

import("//build/ohos.gni")

group("dialog_hap") {
  deps = [ ":power_dialog_hap" ]
}

ohos_hap("power_dialog_hap") {
  hap_profile = "entry/src/main/module.json"

  deps = [
    ":power_dialog_js_assets",
    ":power_dialog_resources",
  ]

  certificate_profile = "signature/openharmony_sx.p7b"
  hap_name = "power_dialog"

  subsystem_name = "applications"
  part_name = "prebuilt_hap"
  module_install_dir = "app/com.ohos.powerdialog"
}
...

4、模块编译power_dialog_hap

#使用build.sh模块编译power_dialog_hap
./build.sh --product-name rk3568 --build-target power_dialog_hap

#使用hb编译power_dialog_hap
 hb build -p rk3568 -T power_dialog_hap

得到hap位于：out/rk3568/obj/base/powermgr/power_manager/power_dialog/power_dialog.hap
可发现out/rk3568/obj/后路径与模块源码路径对应。
在这里插入图片描述

注意：模块编译需模块目录存在BUILD.gn。

四、常用模块编译

4.1 编译Full SDK

rm -rf out
./build.sh --product-name ohos-sdk

Full SDK生成目录：out/sdk/packages/ohos-sdk/

4.2 编译kernel

#使用build.sh编译指定产品kernel
./build.sh --product-name rk3568 --build-target kernel --gn-args linux_kernel_version="linux-5.10"

4.3 编译常见原生应用

4.3.1 编译系统资源应用SystemResources.hap

#使用build.sh编译systemres_hap
./build.sh --product-name rk3568 --build-target systemres_hap

#使用hb编译systemres_hap
 hb build -p rk3568 -T systemres_hap

得到hap位于：out/rk3568/obj/base/global/system_resources/systemres/SystemResources.hap

4.3.2 编译性能测试应用SmartPerf.hap

#使用build.sh编译SmartPerf
./build.sh --product-name rk3568 --build-target SmartPerf

#使用hb编译SmartPerf
 hb build -p rk3568 -T SmartPerf

得到hap位于：out/rk3568/obj/developtools/profiler/host/smartperf/client/client_ui/SmartPerf.hap

4.3.3 编译输入法选择框应用input_method_choose_dialog.hap

#使用build.sh编译input_method_choose_hap
./build.sh --product-name rk3568 --build-target input_method_choose_hap

#使用hb编译input_method_choose_hap
 hb build -p rk3568 -T input_method_choose_hap

得到hap位于：out/rk3568/obj/base/inputmethod/imf/services/dialog/input_method_choose_dialog.hap

4.3.4 编译授权管理应用permission_manager.hap

#使用build.sh编译permission_manager
./build.sh --product-name rk3568 --build-target permission_manager

#使用hb编译permission_manager
 hb build -p rk3568 -T permission_manager

得到hap位于：out/rk3568/obj/applications/standard/permission_manager/permissionmanager/permission_manager.hap

4.3.5 编译关机弹框应用power_dialog.hap

#使用build.sh模块编译power_dialog_hap
./build.sh --product-name rk3568 --build-target power_dialog_hap

#使用hb编译power_dialog_hap
 hb build -p rk3568 -T power_dialog_hap

得到hap位于：out/rk3568/obj/base/powermgr/power_manager/power_dialog/power_dialog.hap

4.4 编译foundation常用库

4.4.1 AMS libabilityms.z.so

./build.sh -p dayu210 --build-target abilityms

得到.so位于：out\rk3588\ability\ability_runtime\libabilityms.z.so

4.4.2 多模输入libmmi-server.z.so

./build.sh -p dayu210 --build-target libmmi-server

得到.so位于：out\rk3588\multimodalinput\input\libmmi-server.z.so

4.4.3 文件系统 libfileuri_native.z.so

./build.sh -p dayu210 --build-target foundation/filemanagement/app_file_service/interfaces/innerkits/native:fileuri_native

得到.so位于：out\rk3588\filemanagement\app_file_service\libfileuri_native.z.so

4.4.4 窗口管理 libwm.z.so

./build.sh -p dayu210 --build-target libwm

得到.so位于：out\rk3588\window\window_manager\libwm.z.so

4.4.5 窗口管理服务 libwms.z.so

 ./build.sh -p dayu210 --build-target libwms

得到.so位于：out\rk3588\window\window_manager\libwms.z.so

4.4.6 蓝牙libsocket.z.so

./build.sh -p rk3568 --build-target foundation/communication/bluetooth/frameworks/js/napi/src/socket:socket

得到.so位于：out\rk3568\communication\bluetooth\libsocket.z.so

4.5其他

4.5.1 升级服务 libupdateservice.z.so

./build.sh -p dayu210 --build-target base/update/updateservice:update_service

得到.so位于：out\rk3588\updater\update_service\libupdateservice.z.so

五、总结

Congratulations~✌ 通过本文，你已基本掌握：

OpenHarmony源码模块编译的原理
OpenHarmony源码常用模块、应用和库等编译、替换方法

接下来就可以更高效地进行OpenHarmony源码开发&创作了~

了解更多关于OpenHarmony文章↩