HarmonyOS—编译构建概述

编译构建是将应用/服务的源代码、资源、第三方库等，通过编译工具转换为可直接在硬件设备上运行的二进制机器码，然后再将二进制机器码封装为HAP/APP软件包，并为HAP/APP包进行签名的过程。其中，HAP是可以直接运行在模拟器或真机设备中的软件包；APP则是用于应用/服务上架到华为应用市场。HAP和APP的关系说明请参考工程介绍。

HarmonyOS应用/服务支持API Version 4~9，但API Version 4~7与API Version 8~9在编译构建体系、工程目录及配置文件等存在差异，接下来将详细介绍两者之间的差异。

构建体系

HarmonyOS应用/服务API Version 4~7和API Version 8~9的构建工具和构建插件不同。

• API Version 4~7构建体系是由Gradle构建工具和构建插件组成；
• API Version 8~9构建体系是由Hvigor构建工具和构建插件组成。

Gradle构建工具作为业界流行的自动化构建开源工具，本章节不再赘述，接下来为大家介绍Hvigor构建体系。

Hvigor构建工具：一款全新基于TS实现的前端构建任务编排工具，结合npm包管理机制，主要提供任务管理机制，任务注册编排、工程模型管理、配置管理等关键能力，更符合ArkTS/JS开发者的开发习惯。

构建插件hvigor-ohos-plugin：是基于Hvigor构建工具开发的一个插件，利用Hvigor的任务编排机制实现应用/服务构建任务流的执行，完成HAP/APP的构建打包，应用于应用/服务的构建。

DevEco Studio会自动配置配套版本的编译工具和构建插件依赖，关于构建工具和构建插件的版本配套关系可参考DevEco Studio版本说明。如需修改构建工具和构建插件版本，API 9及以上版本和API 8版本工程的修改位置不同：

• API 9及以上版本需修改hvigor目录下的hvigor-config.json5文件，示例如下。

{
  “hvigorVersion”: "2.2.1",
  "dependencies": {
        "@ohos/hvigor-ohos-plugin": "2.2.1"
  }
}

• API 8版本需要在工程级的package.json文件中配置相应的版本依赖，示例如下。

{
  ...
  "dependencies": {
    "@ohos/hvigor": "1.4.0",
    "&#