第一个harmonyOS应用,HarmonyOS应用基础知识

HarmonyOS的应用软件包以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才能够独立运行。

图1APP逻辑视图

Ability

Ability是应用所具备的能力的抽象，一个应用可以包含一个或多个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配置文件的内部结构说明

app对象的内部结构

app对象包含应用的全局配置信息，内部结构说明参见表2。

表2app对象的内部结构说明

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。

表3deviceConfig对象的内部结构说明

default、car、tv、wearable、liteWearable、smartVision等对象的内部结构说明，可参见表4。

表4default/car/tv/wearable等对象的内部结构说明

表5network对象的内部结构说明

表6securityConfig对象的内部结构说明

deviceConfig示例：

"deviceConfig": {

"default": {

"process": "com.huawei.hiworld.example",

"directLaunch": false,

"supportBackup": false,

"network": {

"usesCleartext": true,

"securityConfig": {

"domainSettings": {

"cleartextPermitted": true,

"domains": [

{

"subDomains": true,

"name": "example.ohos.com"

}

]

}

}

}

}

}

module对象的内部结构

module对象包含HAP包的配置信息，内部结构说明参见表7。

表7module对象的内部结构说明

module示例：

"module": {

"package": "com.example.myapplication.entry",

"name": ".MyOHOSAbilityPackage",

"description": "$string:description_application",

"supportedModes": [

"drive"

], ], "deviceType": [

"car"

], "distro": {

"deliveryWithInstall": true,

"moduleName": "ohos_entry",

"moduleType": "entry"

}, "abilities": [

... ], "shortcuts": [

... ], "js": [

... ], "reqPermissions": [

... ], "defPermissions": [

... ]}

表8distro对象的内部结构说明

distro示例：

"distro": {

"deliveryWithInstall": true,

"moduleName": "ohos_entry",

"moduleType": "entry"

}

表9abilities对象的内部结构说明

abilities示例：

"abilities": [

{ "name": ".MainAbility",

"description": "$string:description_main_ability",

"icon": "$media:hiworld.png",

"label": "HiMusic",

"type": "page",

"formEnabled": false,

"launchType": "standard",

"orientation": "unspecified",

"permissions": [

], "visible": false,

"skills": [

{ "actions": [

"action.system.home"

], "entities": [

"entity.system.home"

] } ], "configChanges": [

"locale",

"layout",

"fontSize",

"orientation"

], "directLaunch": false,

"process": "string",

"backgroundModes": [

"dataTransfer",

"audioPlayback",

"audioRecording",

"pictureInPicture",

"voip",

"location",

"bluetoothInteraction",

"wifiInteraction",

"screenFetch"

], }]

表10skills对象的内部结构说明

skills示例：

"skills": [

{ "actions": [

"action.system.home"

], "entities": [

"entity.system.home"

], "uris": [

{ "scheme": "http",

"host": "www.xxx.com",

"port": "8080",

"path": "query/student/name",

"type": "text"

} ] }]

表11form对象的内部结构说明

form示例：

"form": {

"formEntity": [

"homeScreen",

"searchbox"

],

"minHeight": 100,

"maxHeight": 200,

"minWidth": 100,

"maxWidth": 200

}

表12js对象的内部结构说明

js示例：

"js": [

{ "name": "default",

"pages": [

"pages/index/index",

"pages/detail/detail"

], "window": {

"designWidth": 750,

"autoDesignWidth": false

} }]

表13shortcuts对象的内部结构说明

示例：

"shortcuts": [

{ "shortcutId": "id",

"label": "$string:shortcut",

"intents": [

{ "targetBundle": "com.huawei.hiworld.himusic",

"targetClass": "com.huawei.hiworld.himusic.entry.MainAbility"

} ] }]

配置文件示例

以JSON文件为config.json的一个简单示例，该示例的应用声明为三个Ability。

{

"app": {

"bundleName": "com.huawei.hiworld.himusic",

"vendor": "huawei",

"version": {

"code": 2,

"name": "2.0"

} "apiVersion": {

"compatible": 3,

"target": 3

} }, "deviceConfig": {

"default": {

} }, "module": {

"package": "com.huawei.hiworld.himusic.entry",

"name": ".MainApplication",

"supportedModes": [

"drive"

], "distro": {

"moduleType": "entry",

"deliveryWithInstall": true,

"moduleName": "hap-car"

}, "deviceType": [

"car"

], "abilities": [

{ "name": ".MainAbility",

"description": "himusic main ability",

"icon": "$media:ic_launcher",

"label": "HiMusic",

"launchType": "standard",

"orientation": "unspecified",

"visible": true,

"skills": [

{ "actions": [

"action.system.home"

], "entities": [

"entity.system.home"

] } ], "type": "page",

"formEnabled": false

}, { "name": ".PlayService",

"description": "himusic play ability",

"icon": "$media:ic_launcher",

"label": "HiMusic",

"launchType": "standard",

"orientation": "unspecified",

"visible": false,

"skills": [

{ "actions": [

"action.play.music",

"action.stop.music"

], "entities": [

"entity.audio"

] } ], "type": "service",

"formEnabled": false,

"backgroundModes": [

"audioPlayback"

] }, { "name": ".UserADataAbility",

"type": "data",

"uri": "dataability://com.huawei.hiworld.himusic.UserADataAbility",

"visible": true

} ], "reqPermissions": [{

"name": "ohos.permission.DISTRIBUTED_DATASYNC",

"reason": "",

"usedScene": {

"ability": [

"com.huawei.hiworld.himusic.entry.MainAbility",

"com.huawei.hiworld.himusic.entry.PlayService"

], "when": "inuse"

} } ] }}