HarmonyOS应用基础知识

AppHarmonyOS的应用软件包以APP Pack(Application Package)形式发布,它是由一个或多个HAP(HarmonyOS Ability Package)以及描述每个HAP属性的pack.info组成 。HAP是Ability的部署包,HarmonyOS应用代码围绕Ability组件展开 。
一个HAP是由代码、资源、第三方库及应用配置文件组成的模块包,可分为entry和feature两种模块类型,如图1所示 。

  • entry:应用的主模块 。一个APP中,对于同一设备类型必须有且只有一个entry类型的HAP,可独立安装运行 。
  • feature:应用的动态特性模块 。一个APP可以包含一个或多个feature类型的HAP,也可以不含 。只有包含Ability的HAP才能够独立运行 。
图1 APP逻辑视图
HarmonyOS应用基础知识

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

文章插图
 
app对象的内部结构app对象包含应用的全局配置信息,内部结构说明参见表2 。
表2 app对象的内部结构说明
HarmonyOS应用基础知识

文章插图
 
app示例:
"app": {"bundleName": "com.huawei.hiworld.example","vendor": "huawei","version": {"code": 2,"name": "2.0"}"apiVersion": {"compatible": 3,"target": 3}}deviceConfig对象的内部结构deviceConfig包含在具体设备上的应用配置信息,可以包含default、car、tv、wearable、liteWearable、smartVision等属性 。default标签内的配置是适用于所有设备通用,其他设备类型如果有特殊的需求,则需要在该设备类型的标签下进行配置 。内部结构说明参见表3 。
表3 deviceConfig对象的内部结构说明
HarmonyOS应用基础知识

文章插图
 
default、car、tv、wearable、liteWearable、smartVision等对象的内部结构说明,可参见表4 。
表4 default/car/tv/wearable等对象的内部结构说明
HarmonyOS应用基础知识

文章插图
 
表5 network对象的内部结构说明
HarmonyOS应用基础知识


推荐阅读