当前位置：首页 > news >正文

OpenHarmony模块化编译

news 2026/4/8 3:02:00

一、环境配置

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
...
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_haphb 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 编译系统资源应用

#使用build.sh编译systemres_hap
./build.sh --product-name rk3568 --build-target systemres_hap#使用hb编译systemres_haphb build -p rk3568 -T systemres_hap

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

4.3.2 编译性能测试应用

#使用build.sh编译SmartPerf
./build.sh --product-name rk3568 --build-target SmartPerf#使用hb编译SmartPerfhb build -p rk3568 -T SmartPerf

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

4.3.3 编译输入法选择框应用

#使用build.sh编译input_method_choose_hap
./build.sh --product-name rk3568 --build-target input_method_choose_hap#使用hb编译input_method_choose_haphb 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 编译授权管理应用

#使用build.sh编译permission_manager
./build.sh --product-name rk3568 --build-target permission_manager#使用hb编译permission_managerhb build -p rk3568 -T permission_manager

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

4.3.5 编译关机弹框应用

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

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