
OpenHarmony应用编译 - 如何在源码中编译复杂应用(4.0-Release)
文档环境
开发环境:Windows 11
编译环境:Ubuntu 22.04
开发板型号:DAYU 200(RK3568)
系统版本:OpenHarmony-4.0-Release
功能简介
- 在 OpenHarmony 系统中预安装应用的 hap 包会随系统编译打包到镜像中,目前有两种编译预安装应用 hap 包的方式,一种为随系统编译时,编译应用源码生成 hap 包的方式,另一种是将已生成的 hap 包放入系统源码中,再进行打包的方式。后者需要开发者使用 DevEco Studio 或其它途径,把应用源码编译构建为 hap 包,再将 hap 放入系统源码中。
- 本文档将以 Launcher 为例,带大家了解如何通过 4.0Release 的系统源码编译应用的方式来打包预安装应用。
- 由于应用依赖和构建工具的升级和替换,3.2Release 系统编译构建应用的方式是 NPM+Webpack,而 4.0Release 使用 OHPM+Hvigor 的方式进行构建,差别较大。
4.0-Release 系统编译 Launcher
1.由于 Launcher 自身原因,导致需要做 2 处改动才可进行源码编译构建。本步骤并非所有项目通用,如果新建的项目可以跳过本步骤,后续 Launcher 或工具更新后也不需要本步骤。
(1)适配系统源码中 NODE_HOME 环境变量的配置,需要修改应用目录下 hvigorw 工具为最新。
文件位置:applications/standard/launcher/hvigorw
内容如下:
(2)由于系统编译应用目前不支持配置产品,所以需要把 Launcher 应用源码中有关 pad 的构建项删除。
文件位置:applications/standard/launcher/build-profile.json5
内容如下:
文件位置:applications/standard/launcher/feature/settings/build-profile.json5
内容如下:
2.删除或注释系统中默认的 Launcher 应用 hap 包编译方式。
文件位置:applications/standard/hap/BUILD.gn
3.在 applications/standard/launcher 目录中增加 BUILD.gn 文件。
内容如下:
说明:
- 此处产物名称 hap_name 定义为 Launcher_OS 是为了区分原系统源码中默认的 hap 包名称,实际可以填写为 Launcher 或任意值。
- BUILD.gn 的模板参数可以参考编译系统提供的模板。
4.在 applications/standard/hap/ohos.build 文件的 module_list 中增加 launcher_OS 模块编译。
5.执行源码编译指令。如果以下 2 个目录产物正确,则说明应用源码编译方式修改成功。
(1)在 out/rk3568/obj/applications/standard/launcher/launcher_OS 目录中,会生成 2 个 hap 的编译产物。
(2)在 out/rk3568/packages/phone/system/app/com.ohos.launcher 目录中,是实际系统环境中的 hap 包产物。
6.烧录系统验证功能。
Launcher 正常启动:
系统应用目录文件正确:
