HAP编译构建指导
概述
基本概念
术语 | 含义 |
---|---|
HAP | Harmony Ability Package,一个HAP文件包含应用的所有内容,由代码、资源、三方库及应用配置文件组成,其文件后缀名为.hap。 |
Ability | 应用的重要组成部分,是应用所具备能力的抽象。Ability是系统调度应用的最小单元,是能够完成一个独立功能的组件,一个应用可以包含一个或多个Ability。 |
FA | Feature Ability,是FA模型的Ability框架下具有UI界面的Ability类型,用于与用户进行交互。Feature Ability唯一对应一种模板,即Page模板(Page Ability)。 |
PA | Particle Ability,是在FA模型的Ability框架下无界面的Ability,主要为Feature Ability提供服务与支持,例如作为后台服务提供计算能力,或作为数据仓库提供数据访问能力。Particle Ability有三种模板,分别为Service模板(Service Ability)、Data模板(Data Ability)、以及Form模板(Form Ability)。 |
FA模型 | 两种Ability框架模型结构的其中一种。是Ability框架在API 8及更早版本采用FA模型。FA模型将Ability分为FA(Feature Ability)和PA(Particle Ability)两种类型,其中FA支持Page Ability模板,PA支持Service ability、Data ability、以及Form ability模板。 |
Stage模型 | 两种Ability框架模型结构的其中一种。从API 9开始支持。Stage模型将Ability分为Ability和ExtensionAbility两大类,其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility。 |
功能简介
提供HAP编译构建功能,支持FA模型、Stage模型。
开发指导
编译子系统提供的模板
ohos_hap
声明一个HAP目标,该目标会生成一个HAP,最终将会打包到system镜像中。
支持的变量 | 说明 |
---|---|
hap_profile | HAP的config.json,Stage模型对应module.json。 |
raw_assets | 原始assets,这些assets会直接拷贝到HAP的assets目录下。 |
resources | 资源文件,编译后放置在assets/entry/resources目录下 |
js_assets | js资源,编译后放置在assets/js/default目录下。 |
ets_assets | ets资源,编译后放置在assets/js/default目录下 |
deps | 当前目标的依赖 |
shared_libraries | 当前目标依赖的native库 |
hap_name | HAP的名字,可选,默认为目标名 |
final_hap_path | 用户可以制定生成的HAP的位置,可选,final_hap_path中会覆盖hap_name。 |
subsystem_name | HAP从属的子系统名,需要和ohos.build中的名字对应,否则将导致无法安装到system镜像中。 |
part_name | HAP从属的部件名,同subsystem_name。 |
js2abc | 是否需要将该HAP的js代码转换为ARK的字节码。< |