应用基础知识
APP
H
armonyOS 的应用软件包以 APP Pack(Application Package)形式发布,它是由一个或多个 HAP(
HarmonyOS Ability Package)以及描述每个 HAP属性的 package.json 组成。HAP 是 Ability 的部署包,HarmonyOS 应用代码围绕 Ability 组件展开。
一个 HAP 是由代码、资源、第三方库及应用清单文件组成的
模块包,可分为entry 和 feature 两种模块类型。
• entry:应用的主模块。一个 APP 中,对于同一设备类型必须有且只有一个entry 类型的 HAP,可独立安装运行。
• feature:应用的动态特性模块。一个 APP 可以包含一个或多个 feature 类型的 HAP,也可以不含。只有包含 Ability 的 HAP 才能够独立运行。
Ability
Ability 是应用所具备的能力的抽象,一个应用可以包含一个或多个 Ability。
Ability 分为两种类型:FA(Feature Ability)和 AA(Atomic Ability)。
FA/AA 是应用的基本组成单元,能够实现特定的业务功能。FA 有 UI 界面,而AA 无 UI 界面。
库文件
库文件是应用依赖的第三方代码形式,存放在 l
IBS 目录,是.so 文件。
资源文件
应用的资源文件(字符串、图片、音频等)存放于 resources 目录下,便于开发者使用和维护,详见资源文件分类。
清单文件
清单文件 (config.json) 是应用的 Ability 信息,用于声明应用的Ability,以及应用所需权限等信息,详见应用清单文件。
package.json
描述应用软件包中每个 HAP 的属性,由 IDE 编译生成,应用市场根据该文件进行拆包和 HAP 的分类存储。HAP 的具体属性包括:
• delivery-with-install: 用于标识该 HAP 是否需要在主动安装时进行安装。
• name:HAP 文件名。
• module-type:模块类型,entry 或 feature。
•
device-type:用于标识支持该 HAP 运行的设备类型。
应用配置文件
应用的每个 HAP 的根目录下都存在一个“config.json”清单文件。该文件描述应用的全局配置信息、在具体设备上的配置信息、HAP 包的配置信息,主要涵盖以下几个方面:
• 应用的全局配置信息:包含应用的包名、生产厂商、版本号等基本信息。
• 应用在具体设备上的配置信息。
• HAP 包的配置信息:包含每个 Ability 必须定义的基本属性(如包名、类名、类型以及 Ability 提供的能力),应用访问系统或其他应用受保护部分所需的权限等。
文件约定
清单文件“config.json”采用 JSON 文件格式,由属性和值两部分构成:
• 属性
属性出现顺序不分先后,且每个属性最多只允许出现一次。
• 值
每个属性的值为 JSON 的基本数据类型(数值、字符串、布尔值、值的有序列表(array)、对象(object)、
null 类型)。如果属性值需要引用资源文件,可参见资源文件。
清单元素
此部分提供“config.json”文件中所有属性的详细解释。
“config.json”文件中的配置标签包括“app”、“deviceConfig”和
“module”三大标签,缺一不可。
更多详细内容请下载附件查看