鸿蒙应用构建体系深度解析：ABC、HAP、HAR、HSP与APP的技术全貌

ABC 字节码文件

ABC（Ark Bytecode，方舟字节码）是鸿蒙生态中 ArkTS/TS/JS 源代码经过方舟编译器转换后的二进制中间产物，采用 .abc 作为文件后缀。

该文件是应用逻辑的完整二进制表达，涵盖了所有类定义、方法实现、字段布局、调试元数据、字符串常量池及字面量信息。对鸿蒙应用的逆向分析工作均围绕 ABC 文件展开------系统内置的 ark_disasm 反汇编器与社区开源的 abc-decompiler 反编译工具均以 ABC 文件为直接输入，解析并还原应用实现细节。

由于未经保护的 ABC 文件存在极高的逆向风险，核心算法与业务逻辑极易暴露。针对此类安全挑战，建议开发者采用专业级加固方案实施底层防护。业界已有厂商如 Virbox Protector 宣布将提供鸿蒙应用专项加固服务，从字节码层面阻断非法分析。

HAP 模块包

HAP（Harmony Ability Package）是鸿蒙应用的基本组成单元，封装了代码实现、资源资产、第三方依赖及配置信息，按职能划分为两类：

entry：主入口模块，同一设备类型下必须唯一存在，具备独立部署与运行能力。
feature：动态特性模块，可选配置，支持零到多个。仅当其包含 Ability 时方可独立调度。

标准 HAP 包的目录组织示例如下：

text 复制代码

entry_default
├─ets
│   ├─modules.abc
│   └─sourceMaps.map
├─libs
│   └─arm64-v8a
│       └─libentry.so
├─resources
│   └─base
│       ├─media
│       │   ├─app_background.png
│       │   ├─app_foreground.png
│       │   ├─app_layered_image.json
│       │   ├─background.png
│       │   ├─foreground.png
│       │   └─layered_image.json
│       └─profile
│           ├─backup_config.json
│           └─main_pages.json
├─.pages.info
├─module.json
├─pack.info
├─pkgContextInfo.json
└─resources.index

ets 目录 存储应用核心逻辑，modules.abc 为编译后的字节码主体，sourceMaps.map 维护源码映射关系。

libs 目录 按指令集架构（如 arm64-v8a）分级存放 native 动态链接库。

resources 目录 集中管理图片、配置、音频等资源文件。

根目录配置文件构成模块元数据体系：module.json 定义模块描述、Ability 清单及权限声明；pack.info 记录包版本与设备适配信息；pkgContextInfo.json 描述构建环境与依赖关系；resources.index 建立资源索引以优化加载性能；.pages.info 维护页面路由信息。

pack.info 配置样例：

json 复制代码

{
  "summary": {
    "app": {
      "bundleName": "com.example.arks",
      "bundleType": "app",
      "version": {
        "code": 1000000,
        "name": "1.0.0"
      }
    },
    "modules": [
      {
        "mainAbility": "EntryAbility",
        "deviceType": [
          "phone",
          "tablet",
          "2in1",
          "wearable"
        ],
        "abilities": [
          {
            "name": "EntryAbility",
            "label": "$string:EntryAbility_label"
          }
        ],
        "extensionAbilities": [
          {
            "name": "EntryBackupAbility",
            "forms": []
          }
        ],
        "distro": {
          "moduleType": "entry",
          "installationFree": false,
          "deliveryWithInstall": true,
          "moduleName": "entry"
        },
        "apiVersion": {
          "compatible": 18,
          "releaseType": "Release",
          "target": 18
        }
      }
    ]
  },
  "packages": [
    {
      "deviceType": [
        "phone",
        "tablet",
        "2in1",
        "wearable"
      ],
      "moduleType": "entry",
      "deliveryWithInstall": true,
      "name": "entry-default"
    }
  ]
}

该文件直观呈现应用包名、版本迭代、设备覆盖策略及模块分发规则。

开发调试阶段，通过 hdc install package_name.hap 命令即可完成 HAP 包的设备部署。

HAR 与 HSP 共享包

HAR（Harmony Archive）是静态共享机制，支持跨模块复用 ArkUI 组件、工具类及资源文件。其生命周期完全依附于主工程，构建时被物理复制至依赖模块，无法独立部署。权限配置在编译期自动合并，避免重复申请。

HSP（Harmony Shared Package）提供动态共享能力，与宿主应用同进程、同包名、共享生命周期。多 HAP/HSP 引用同一 HSP 时，包体积仅增加一份副本，显著优化整体大小；运行时支持懒加载，提升启动效率。集成态 HSP 更支持组织内跨应用共享。

核心差异对比：

维度	HAR（静态共享）	HSP（动态共享）
集成方式	编译期代码复制	运行时按需加载，物理隔离
体积影响	线性膨胀各依赖方	应用级单实例，全局优化
加载时机	主包启动时同步加载	支持延迟加载，加速启动
更新策略	强制随 HAP 版本同步	可独立热更新
适用场景	基础组件、工具集、UI 控件	业务插件、大型特性模块

APP 分发包

APP 文件专用于鸿蒙应用市场分发，与本地调试用的 HAP 形成明确区分。

每个 APP 包聚合一个或多个 HAP 模块，并包含描述整体属性的 pack.info 文件。标准应用至少包含一个 entry 模块，按需叠加 feature 模块。

APP 包本质为带签名的压缩容器，封装所有待分发模块及依赖的 HSP。上架版本必须采用正式发布证书签名，与开发调试证书体系分离，构成应用分发安全链的最后一环。

构建流转全景

鸿蒙应用从代码到用户的完整路径可归纳为：ArkTS/JS 源码 → 方舟编译器产出 ABC 字节码 → 字节码与资源打包成 HAP/HSP 模块 → 通过 HAR 实现编译期代码复用 → 最终签名封装为 APP 分发包，完成商店上架与终端交付。