【鸿蒙南向实战开发】OpenHarmony应用编译 - 如何在源码中编译复杂应用

概述

文档环境

1.开发环境：Windows 11

2.编译环境：Ubuntu 22.04

3.开发板型号：DAYU 200（RK3568）

4.系统版本：OpenHarmony-4.0-Release

5.涉及仓库：applications_launcher

功能简介

●在 OpenHarmony 系统中预安装应用的 hap 包会随系统编译打包到镜像中，目前有两种编译预安装应用 hap 包的方式，一种为随系统编译时，编译应用源码生成 hap 包的方式，另一种是将已生成的 hap 包放入系统源码中，再进行打包的方式。后者需要开发者使用 DevEco Studio 或其它途径，把应用源码编译构建为 hap 包，再将 hap 放入系统源码中。

●在 OpenHarmony 应用编译 - 如何在源码中编译复杂应用（3.2-Release）文章中，介绍了如何在 3.2Release 版本的系统源码中编译系统应用 Launcher。本文档将继续以 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

内容如下：

#!/bin/bash

# ----------------------------------------------------------------------------
#  Hvigor startup script, version 1.0.0
#
#  Required ENV vars:
#  ------------------
#    NODE_HOME - location of a Node home dir
#    or
#    Add /usr/local/nodejs/bin to the PATH environment variable
# ----------------------------------------------------------------------------

HVIGOR_APP_HOME="`pwd -P`"
HVIGOR_WRAPPER_SCRIPT=${HVIGOR_APP_HOME}/hvigor/hvigor-wrapper.js
warn() {
	echo ""
	echo -e "\033[1;33m`date '+[%Y-%m-%d %H:%M:%S]'`$@\033[0m"
}

error() {
	echo ""
	echo -e "\033[1;31m`date '+[%Y-%m-%d %H:%M:%S]'`$@\033[0m"
}

fail() {
	error "$@"
	exit 1
}

# Determine node to start hvigor wrapper script
if [ -n "${NODE_HOME}" ];then
   EXECUTABLE_NODE="${NODE_HOME}/bin/node"
   if [ ! -x "$EXECUTABLE_NODE" ];then
       fail "ERROR: NODE_HOME is set to an invalid directory,check $NODE_HOME\n\nPlease set NODE_HOME in your environment to the location where your nodejs installed"
   fi
else
   EXECUTABLE_NODE="node"
   which ${EXECUTABLE_NODE} > /dev/null 2>&1 || fail "ERROR: NODE_HOME is not set and not 'node' command found in your path"
fi

# Check hvigor wrapper script
if [ ! -r "$HVIGOR_WRAPPER_SCRIPT" ];then
	fail "ERROR: Couldn't find hvigor/hvigor-wrapper.js in ${HVIGOR_APP_HOME}"
fi

# start hvigor-wrapper script
exec "${EXECUTABLE_NODE}" \
	"${HVIGOR_WRAPPER_SCRIPT}" "$@"
​

（2）由于系统编译应用目前不支持配置产品，所以需要把 Launcher 应用源码中有关 pad 的构建项删除。

文件位置：applications/standard/launcher/build-profile.json5

内容如下：

{
  	...
    {
      "name": "phone_launcher",
      "srcPath": "./product/phone",
      "targets": [
        {
          "name": "default",
          "applyToProducts": [
            "default",
          ],
        },
      ],
    },
    {
      "name": "launcher_settings",
      "srcPath": "./feature/settings",
      "targets": [
        {
          "name": "default",
          "applyToProducts": [
            "default",
          ],
        },
      ],
    }
  ],
}

文件位置：applications/standard/launcher/feature/settings/build-profile.json5

内容如下：

{
  "apiType": 'stageMode',
  "buildOption": {
  },
  "targets": [
    {
      "name": "default",
    }
  ],
  "entryModules": ["phone_launcher"]
}

2.删除或注释系统中默认的 Launcher 应用 hap 包编译方式。

文件位置：applications/standard/hap/BUILD.gn

group("hap") {
  deps = [
    	...
      # "//applications/standard/hap:launcher_hap", // 直接删除或注释，不参与编译
      # "//applications/standard/hap:launcher_settings_hap",  // 直接删除或注释，不参与编译
    	...
  ]
 }

3.在 applications/standard/launcher 目录中增加 BUILD.gn 文件。

内容如下：

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

ohos_app("launcher_OS") {
  part_name = "prebuilt_hap"
  subsystem_name = "applications" 
  hap_name = "Launcher_OS"   
  certificate_profile = "./signature/launcher.p7b"
  module_libs_dir = "entry"
  module_install_dir = "app/com.ohos.launcher"
  js_build_mode = "release"
  build_level = "module"
  assemble_type = "assembleHap"
}

说明：

●此处产物名称 hap_name 定义为 Launcher_OS 是为了区分原系统源码中默认的 hap 包名称，实际可以填写为 Launcher 或任意值。
●BUILD.gn 的模板参数可以参考编译系统提供的模板。

4.在 applications/standard/hap/ohos.build 文件的 module_list 中增加 launcher_OS 模块编译。

{
  "subsystem": "applications",
  "parts": {
    "prebuilt_hap": {
	  	...
      "module_list": [
       	...
       "//applications/standard/launcher: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 正常启动：

系统应用目录文件正确：

写在最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）文档包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习文档能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

鸿蒙（HarmonyOS NEXT）5.0最新学习路线

有了路线图，怎么能没有学习文档呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V3.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

●ArkTS实践
●UIAbility应用
●网络案例
……

获取以上完整鸿蒙HarmonyOS学习文档，请点击→纯血版全套鸿蒙HarmonyOS学习文档