Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 f3b4431c 编写于 作者: S shuaiyutao
浏览文件
操作

update structure docs 

Change-Id: Icd984a84847fcb1aecc80492d5bcdef20574ecbd
Signed-off-by: Nshuaiyutao <shuaiyutao1@huawei.com>
上级 9bfd5485
隐藏空白更改
内联 并排
Showing with 307 addition and 322 deletion
zh-cn/application-dev/quick-start/module-structure.md
浏览文件 @ f3b4431c
...@@ -15,29 +15,29 @@ module.json由app和module这两个部分组成，缺一不可。配置文件的 ...@@ -15,29 +15,29 @@ module.json由app和module这两个部分组成，缺一不可。配置文件的
| app | 表示应用的全局配置信息。同一个应用的不同HAP包的app配置必须保持一致。参考[app对象内部结构](#app对象内部结构)。 | 对象 | 否 | | app | 表示应用的全局配置信息。同一个应用的不同HAP包的app配置必须保持一致。参考[app对象内部结构](#app对象内部结构)。 | 对象 | 否 |
| module | 表示HAP包的配置信息。该标签下的配置只对当前HAP包生效。参考[module对象内部结构](#module对象内部结构)。 | 对象 | 否 | | module | 表示HAP包的配置信息。该标签下的配置只对当前HAP包生效。参考[module对象内部结构](#module对象内部结构)。 | 对象 | 否 |
module.json示例： module.json示例:
```json ```json
{ {
    "app": { "app": {
"bundleName": "com.application.music", "bundleName": "com.application.music",
        "vendor": "application", "vendor": "application",
        "versionCode": 1, "versionCode": 1,
        "versionName": "1.0", "versionName": "1.0",
        "minCompatibleVersionCode": 1, "minCompatibleVersionCode": 1,
        "apiCompatibleVersion": 7, "apiCompatibleVersion": 7,
        "apiTargetVersion": 8, "apiTargetVersion": 8,
        "apiReleaseType": "Release", "apiReleaseType": "Release",
        "debug": false, "debug": false,
        "icon" : "$media:app_icon", "icon": "$media:app_icon",
        "label": "$string:app_name", "label": "$string:app_name",
        "description": "$string:description_application", "description": "$string:description_application",
        "distributedNotificationEnabled": true, "distributedNotificationEnabled": true,
        "entityType": "game", "entityType": "game",
        "car": { "car": {
            "apiCompatibleVersion": 8 "apiCompatibleVersion": 8
         } }
    }, },
"module": { "module": {
"name": "myHapName", "name": "myHapName",
"type": "entry|feature|har", "type": "entry|feature|har",
...@@ -48,15 +48,8 @@ module.json示例： ...@@ -48,15 +48,8 @@ module.json示例：
"deviceTypes": [ "deviceTypes": [
"tablet", "tablet",
"tv", "tv",
"wearable", "wearable",
"liteWearable", "car",
"ar",
"vr",
"car",
"earphones",
"speaker",
"smartVision",
"linkIoT",
"router", "router",
], ],
"deliveryWithInstall": true, "deliveryWithInstall": true,
...@@ -174,20 +167,20 @@ module.json示例： ...@@ -174,20 +167,20 @@ module.json示例：
| 属性名称 | 含义 | 数据类型 | 是否可缺省 | | 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ------------------------------ | ------------------------------------------------------------ | -------- | ------------------------------------------- | | ------------------------------ | ------------------------------------------------------------ | -------- | ------------------------------------------- |
| bundleName | 该标签表示应用的包名，用于标识应用的唯一性。该标签不可缺省。标签的值命名规则：<br /> 1）字符串以字母、数字、下划线和符号”.”组成；<br /> 2）以字母开头；<br /> 3）最小长度7个字节，最大长度127个字节。<br /> 推荐采用反域名形式命名（如：com.example.xxx，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。<br /> 其中，随系统源码编译的应用需命名为”com.ohos.xxx”形式， ohos标识OpenHarmony系统应用。 | 字符串 | 否 | | bundleName | 该标签表示应用的包名，用于标识应用的唯一性。该标签不可缺省。标签的值命名规则 :<br /> 1）字符串以字母、数字、下划线和符号”.”组成；<br /> 2）以字母开头；<br /> 3）最小长度7个字节，最大长度127个字节。<br /> 推荐采用反域名形式命名（如 :com.example.xxx，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。<br /> 其中，随系统源码编译的应用需命名为”com.ohos.xxx”形式， ohos标识OpenHarmony系统应用。 | 字符串 | 否 |
| debug | 该标签标识应用是否可调试。 | 布尔值 | 该标签可以缺省，缺省为false。 | | debug | 该标签标识应用是否可调试。 | 布尔值 | 该标签可以缺省，缺省为false。 |
| icon | 该标签标识应用的图标，标签值为资源文件的索引。 | 字符串 | 该标签不可缺省。 | | icon | 该标签标识应用的图标，标签值为资源文件的索引。 | 字符串 | 该标签不可缺省。 |
| label | 该标签标识应用的的名称，标签值为资源文件的索引，以支持多语言。 | 字符串 | 该标签不可缺省。 | | label | 该标签标识应用的的名称，标签值为资源文件的索引，以支持多语言。 | 字符串 | 该标签不可缺省。 |
| description | 该标签标识App的描述信息，标签值是是字符串类型或对描述内容的资源索引，以支持多语言。 | 字符串 | 该标签可缺省，缺省值为空。 | | description | 该标签标识App的描述信息，标签值是是字符串类型或对描述内容的资源索引，以支持多语言。 | 字符串 | 该标签可缺省，缺省值为空。 |
| vendor | 该标签是对应用开发厂商的描述。该标签的值是字符串类型（最大255个字节）。 | 字符串 | 该标签可以缺省，缺省为空。 | | vendor | 该标签是对应用开发厂商的描述。该标签的值是字符串类型（最大255个字节）。 | 字符串 | 该标签可以缺省，缺省为空。 |
| versionCode | 该标签标识应用的版本号，该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新，数值越大表示版本越高。开发者可以将该值设置为任何正整数，但是必须确保应用的新版本都使用比旧版本更大的值。该标签不可缺省，versionCode 值应小于2的31方。 | 数值 | | | versionCode | 该标签标识应用的版本号，该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新，数值越大表示版本越高。开发者可以将该值设置为任何正整数，但是必须确保应用的新版本都使用比旧版本更大的值。该标签不可缺省，versionCode 值应小于2的31方。 | 数值 | |
| versionName | 该标签标识版本号的文字描述，用于向用户展示。<br />该标签仅由数字和点构成，推荐采用“A.B.C.D”四段式的形式。四段式推荐的含义如下所示。<br/>第一段：主版本号/Major，范围0-99，重大修改的版本，如实现新的大功能或重大变化。<br/>第二段：次版本号/Minor，范围0-99，表示实现较突出的特点，如新功能添加和大问题修复。<br/>第三段：特性版本号/Feature，范围0-99，标识规划的新版本特性。<br/>第四段：修订版本号/Patch，范围0-999，表示维护版本，修复bug。 | 字符串 | 该标签不可缺省 | | versionName | 该标签标识版本号的文字描述，用于向用户展示。<br />该标签仅由数字和点构成，推荐采用“A.B.C.D”四段式的形式。四段式推荐的含义如下所示。<br/>第一段 :主版本号/Major，范围0-99，重大修改的版本，如实现新的大功能或重大变化。<br/>第二段 :次版本号/Minor，范围0-99，表示实现较突出的特点，如新功能添加和大问题修复。<br/>第三段 :特性版本号/Feature，范围0-99，标识规划的新版本特性。<br/>第四段 :修订版本号/Patch，范围0-999，表示维护版本，修复bug。 | 字符串 | 该标签不可缺省 |
| minCompatibleVersionCode | 该标签标识应用运行需要的API最小版本。 | 数值 | 该标签可缺省。缺省值等于versionCode标签值。 | | minCompatibleVersionCode | 该标签标识应用运行需要的API最小版本。 | 数值 | 该标签可缺省。缺省值等于versionCode标签值。 |
| minAPIVersion | 该标签标识应用运行需要的API目标版本。 | 数值 | 该标签不可缺省。 | | minAPIVersion | 该标签标识应用运行需要的API目标版本。 | 数值 | 该标签不可缺省。 |
| targetAPIVersion | 该标签标识应用运行需要的API目标版本。 | 整形 | 该标签不可缺省。 | | targetAPIVersion | 该标签标识应用运行需要的API目标版本。 | 整形 | 该标签不可缺省。 |
| apiReleaseType | 该标签标识应用运行需要的API目标版本的类型，采用字符串类型表示。取值为“CanaryN”、“BetaN”或者“Release”，其中，N代表大于零的整数。<br />Canary：受限发布的版本。<br/>Beta：公开发布的Beta版本。<br/>Release：公开发布的正式版本。 | 字符串 | 该标签可缺省，缺省为“Release”。 | | apiReleaseType | 该标签标识应用运行需要的API目标版本的类型，采用字符串类型表示。取值为“CanaryN”、“BetaN”或者“Release”，其中，N代表大于零的整数。<br />Canary :受限发布的版本。<br/>Beta :公开发布的Beta版本。<br/>Release :公开发布的正式版本。 | 字符串 | 该标签可缺省，缺省为“Release”。 |
| distributedNotificationEnabled | 该标签标记该应用是否开启分布式通知。 | 布尔值 | 该标签可缺省，缺省值为true。 | | distributedNotificationEnabled | 该标签标记该应用是否开启分布式通知。 | 布尔值 | 该标签可缺省，缺省值为true。 |
| entityType | 该标签标记该应用的类别，具体有：游戏类(game)，影音类（media）、社交通信类（communication）、新闻类（news）、出行类（travel）、工具类（utility）、购物类（shopping）、教育类（education）、少儿类（kids）、商务类（business）、拍摄类（photography）。 | 字符串 | 该标签可以缺省，缺省为unspecified。 | | entityType | 该标签标记该应用的类别，具体有 :游戏类(game)，影音类（media）、社交通信类（communication）、新闻类（news）、出行类（travel）、工具类（utility）、购物类（shopping）、教育类（education）、少儿类（kids）、商务类（business）、拍摄类（photography）。 | 字符串 | 该标签可以缺省，缺省为unspecified。 |
### module对象内部结构 ### module对象内部结构
...@@ -205,7 +198,7 @@ hap包的配置信息，该标签下的配置只对当前hap包生效。 ...@@ -205,7 +198,7 @@ hap包的配置信息，该标签下的配置只对当前hap包生效。
| mainElement | 该标签标识hap的入口ability名称或者extension名称。只有配置为mainElement的ability或者extension才允许在服务中心露出。创建OpenHarmony原子化服务时，该标签不可缺省。 | 字符串 | OpenHarmony应用下，该标签可缺省。 | | mainElement | 该标签标识hap的入口ability名称或者extension名称。只有配置为mainElement的ability或者extension才允许在服务中心露出。创建OpenHarmony原子化服务时，该标签不可缺省。 | 字符串 | OpenHarmony应用下，该标签可缺省。 |
| deviceTypes | 该标签标识hap可以运行在哪类设备上，标签值采用字符串数组的表示，系统预定义的设备类型见表4。<br />与syscap不同的是，deviceTypes是以设备类型为粒度，而syscap是以设备能力(例如蓝牙、wifi)为粒度。 | 字符串数组 | 该标签不可缺省，可以为空值。 | | deviceTypes | 该标签标识hap可以运行在哪类设备上，标签值采用字符串数组的表示，系统预定义的设备类型见表4。<br />与syscap不同的是，deviceTypes是以设备类型为粒度，而syscap是以设备能力(例如蓝牙、wifi)为粒度。 | 字符串数组 | 该标签不可缺省，可以为空值。 |
| deliveryWithInstall | 该标签标识当前hap是否在用户主动安装的时候安装，true表示主动安装时安装，false表示主动安装时不安装。 | 布尔值 | 该标签不可缺省。 | | deliveryWithInstall | 该标签标识当前hap是否在用户主动安装的时候安装，true表示主动安装时安装，false表示主动安装时不安装。 | 布尔值 | 该标签不可缺省。 |
| installationFree | 表示当前HAP是否支持免安装特性。所有Hap包都需要配置不可缺省。<br/>true：表示支持免安装特性，且符合免安装约束。<br/>false：表示不支持免安装特性。<br/><br/>当entry.hap该字段配置为true时，与该entry.hap相关的所有feature.hap该字段也需要配置为ture。<br/>当entry.hap该字段配置为false时，与该entry.hap相关的各feature.hap该字段可按业务需求配置ture或false。 | 布尔值 | 该标签不可缺省。 | | installationFree | 表示当前HAP是否支持免安装特性。所有Hap包都需要配置不可缺省。<br/>true :表示支持免安装特性，且符合免安装约束。<br/>false :表示不支持免安装特性。<br/><br/>当entry.hap该字段配置为true时，与该entry.hap相关的所有feature.hap该字段也需要配置为true。<br/>当entry.hap该字段配置为false时，与该entry.hap相关的各feature.hap该字段可按业务需求配置true或false。 | 布尔值 | 该标签不可缺省。 |
| virtualMachine | 该标签用于标识当前hap运行的目标虚拟机类型，供云端分发使用，如应用市场和分发中心。<br/>该标签值为字符串。如果目标虚拟机类型为方舟虚拟机，则其值为”ark”； 如果目标虚拟机类型不是方舟虚拟机，则其值为”default”。该标签由IDE构建hap的时候自动插入。解包工具解析时，如果hap包没有该标签，设置该标签值为”default”。 | 字符串 | 该标签可缺省，缺省值为“default”。 | | virtualMachine | 该标签用于标识当前hap运行的目标虚拟机类型，供云端分发使用，如应用市场和分发中心。<br/>该标签值为字符串。如果目标虚拟机类型为方舟虚拟机，则其值为”ark”； 如果目标虚拟机类型不是方舟虚拟机，则其值为”default”。该标签由IDE构建hap的时候自动插入。解包工具解析时，如果hap包没有该标签，设置该标签值为”default”。 | 字符串 | 该标签可缺省，缺省值为“default”。 |
| uiSyntax | syntax定义该JS Component的语法类型。<br />hml标识该JS Component使用hml/css/js进行开发；<br/>ets标识该JS Component使用ets声明式语法进行开发。 | 字符串 | 该标签可缺省，默认值为hml | | uiSyntax | syntax定义该JS Component的语法类型。<br />hml标识该JS Component使用hml/css/js进行开发；<br/>ets标识该JS Component使用ets声明式语法进行开发。 | 字符串 | 该标签可缺省，默认值为hml |
| pages | 该标签是一个profile资源，用于列举JS Component中每个页面信息。pages使用参考pages示例。 | 对象 | 在有ability的场景下，该标签不可缺省。 | | pages | 该标签是一个profile资源，用于列举JS Component中每个页面信息。pages使用参考pages示例。 | 对象 | 在有ability的场景下，该标签不可缺省。 |
...@@ -221,23 +214,16 @@ hap包的配置信息，该标签下的配置只对当前hap包生效。 ...@@ -221,23 +214,16 @@ hap包的配置信息，该标签下的配置只对当前hap包生效。
| 平板 | tablet | tablet | 平板，带屏音箱 | | 平板 | tablet | tablet | 平板，带屏音箱 |
| 智慧屏 | smart TV | tv | | | 智慧屏 | smart TV | tv | |
| 智能手表 | smart watch | wearable | 智能手表，儿童手表，特指资源较丰富的的手表，具备电话功能 | | 智能手表 | smart watch | wearable | 智能手表，儿童手表，特指资源较丰富的的手表，具备电话功能 |
| 运动手表 | basic watch | liteWearable | 基本功能手表，运动手表 |
| 增强现实 | AR | ar | |
| 虚拟现实 | VR | vr | |
| 车机 | head unit | car | | | 车机 | head unit | car | |
| 耳机 | earphones | earphones | |
| 音箱 | speaker | speaker | 无屏音箱，有屏音箱，通过硬件profile |
| 智慧视觉设备 | Smart Vision | smartVision | 带摄像头的设备，通过硬件profile分开是否 |
| 联接类模组 | linkiot | linkIoT | Wi-Fi模组，蓝牙模组 |
| 路由器 | router | router | 路由器 | | 路由器 | router | router | 路由器 |
deviceTypes示例： deviceTypes示例 :
```json ```json
{ {
"module": { "module": {
"name": "myHapName", "name": "myHapName",
        "type": "har", "type": "har",
"deviceTypes" : [ "deviceTypes" : [
"wearable" "wearable"
] ]
...@@ -245,18 +231,18 @@ deviceTypes示例： ...@@ -245,18 +231,18 @@ deviceTypes示例：
} }
``` ```
pages示例： pages示例 :
```json ```json
{ {
"module": { "module": {
       "name": "myHapName", "name": "myHapName",
        "type": "har", "type": "har",
"deviceTypes" : [ "deviceTypes" : [
"wearable" "wearable"
], ],
        "pages": "$profile:pages_config" "pages": "$profile:pages_config"
    } }
} }
``` ```
...@@ -264,12 +250,12 @@ pages_config配置文件 ...@@ -264,12 +250,12 @@ pages_config配置文件
```json ```json
{ {
    "src": [ "src": [
        "pages/index/index", "pages/index/index",
        "pages/second/second", "pages/second/second",
        "pages/third/third", "pages/third/third",
        "pages/four/four" "pages/four/four"
    ] ]
} }
``` ```
...@@ -287,24 +273,24 @@ pages_config配置文件 ...@@ -287,24 +273,24 @@ pages_config配置文件
| value | 该标签表示数据项的值，标签值为字符串（最大长度255字节）。 | 字符串 | 可缺省，缺省为空。 | | value | 该标签表示数据项的值，标签值为字符串（最大长度255字节）。 | 字符串 | 可缺省，缺省为空。 |
| resource | 该标签标识定义用户自定义数据格式，标签值为标识该数据的资源的索引值。 | 字符串 | 可缺省，缺省为空。 | | resource | 该标签标识定义用户自定义数据格式，标签值为标识该数据的资源的索引值。 | 字符串 | 可缺省，缺省为空。 |
metadata示例： metadata示例 :
```json ```json
{  {
    "module": { "module": {
        "metadata": [ "metadata": [
            { {
                "name": "string", "name": "string",
                "value": "string", "value": "string",
                "resource": "$profile:config_file" "resource": "$profile:config_file"
            }, },
            { {
                "name": "string", "name": "string",
                "value": "string", "value": "string",
                "resource": "$profile:config_file" "resource": "$profile:config_file"
            } }
        ] ]
    } }
} }
``` ```
...@@ -325,41 +311,41 @@ abilities描述ability的配置信息，标签值为数组类型。 ...@@ -325,41 +311,41 @@ abilities描述ability的配置信息，标签值为数组类型。
| metadata | 该标签表示ability的元信息。metadata参考[metadata对象内部结构](#metadata对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 | | metadata | 该标签表示ability的元信息。metadata参考[metadata对象内部结构](#metadata对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 |
| visible | 该标签标识ability是否可以被其它应用调用，为布尔类型，true表示可以被其它应用调用， false表示不可以被其它应用调用。 | 布尔值 | 该标签可缺省，缺省值为false。 | | visible | 该标签标识ability是否可以被其它应用调用，为布尔类型，true表示可以被其它应用调用， false表示不可以被其它应用调用。 | 布尔值 | 该标签可缺省，缺省值为false。 |
| continuable | 该标签标识ability是否可以迁移，为布尔类型，true表示可以被迁移， false表示不可以被迁移。 | 布尔值 | 该标签可缺省，缺省值为false。 | | continuable | 该标签标识ability是否可以迁移，为布尔类型，true表示可以被迁移， false表示不可以被迁移。 | 布尔值 | 该标签可缺省，缺省值为false。 |
| skills | 该标签标识ability能够接收的意图的特征集，为数组格式。<br />配置规则： entry包可以配置多个具有入口能力的skills标签（配置了action.system.home和entity.system.home）的ability，其中第一个配置了skills标签的ability中的label和icon作为OpenHarmony服务或应用的label和icon。<br/>OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。<br/>OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 <br />skills内部结构参考[skills对象内部结构](#skills对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 | | skills | 该标签标识ability能够接收的意图的特征集，为数组格式。<br />配置规则 : entry包可以配置多个具有入口能力的skills标签（配置了action.system.home和entity.system.home）的ability，其中第一个配置了skills标签的ability中的label和icon作为OpenHarmony服务或应用的label和icon。<br/>OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。<br/>OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 <br />skills内部结构参考[skills对象内部结构](#skills对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 |
| backgroundModes | 该标签标识ability长时任务集合。指定用于满足特定类型的长时任务。<br />长时任务类型有如下：<br/>dataTransfer：通过网络/对端设备进行数据下载、备份、分享、传输等业务。<br/>audioPlayback：音频输出业务。<br/>audioRecording：音频输入业务。<br/>location：定位、导航业务。<br/>bluetoothInteraction：蓝牙扫描、连接、传输业务（穿戴）。<br/>multiDeviceConnection：多设备互联业务。<br/>wifiInteraction：Wifi扫描、连接、传输业务（克隆 多屏）。<br/>voip：音视频电话，VOIP业务。<br/>taskKeeping：计算业务。 <br/> | 字符串 | 可缺省，缺省为空。 | | backgroundModes | 该标签标识ability长时任务集合。指定用于满足特定类型的长时任务。<br />长时任务类型有如下 :<br/>dataTransfer :通过网络/对端设备进行数据下载、备份、分享、传输等业务。<br/>audioPlayback :音频输出业务。<br/>audioRecording :音频输入业务。<br/>location :定位、导航业务。<br/>bluetoothInteraction :蓝牙扫描、连接、传输业务（穿戴）。<br/>multiDeviceConnection :多设备互联业务。<br/>wifiInteraction :Wifi扫描、连接、传输业务（克隆 多屏）。<br/>voip :音视频电话，VOIP业务。<br/>taskKeeping :计算业务。 <br/> | 字符串 | 可缺省，缺省为空。 |
abilities示例 abilities示例
```json ```json
{ {
    "abilities": [{ "abilities": [{
        "name": "MainAbility", "name": "MainAbility",
        "srcEntrance": "./ets/login/MyLoginAbility.ts", "srcEntrance": "./ets/login/MyLoginAbility.ts",
        "launchType":"standard" "launchType":"standard"
        "description": "$string:description_main_ability", "description": "$string:description_main_ability",
        "icon": "$media:icon", "icon": "$media:icon",
        "label": "Login", "label": "Login",
        "permissions": [], "permissions": [],
        "metadata": [], "metadata": [],
        "visible": true, "visible": true,
        "continuable": true, "continuable": true,
        "skills": [{ "skills": [{
            "actions": ["action.system.home"], "actions": ["action.system.home"],
            "entities": ["entity.system.home"], "entities": ["entity.system.home"],
            "uris": [] "uris": []
        }], }],
        "backgroundModes": [ "backgroundModes": [
            "dataTransfer", "dataTransfer",
            "audioPlayback", "audioPlayback",
            "audioRecording", "audioRecording",
            "location", "location",
            "bluetoothInteraction", "bluetoothInteraction",
            "multiDeviceConnection", "multiDeviceConnection",
            "wifiInteraction", "wifiInteraction",
            "voip", "voip",
            "taskKeeping" "taskKeeping"
        ], ],
    }], }],
} }
``` ```
...@@ -389,54 +375,54 @@ skills示例 ...@@ -389,54 +375,54 @@ skills示例
```json ```json
{ {
    "abilities": [ "abilities": [
        { {
            "skills": [ "skills": [
                { {
                    "actions": [ "actions": [
                        "action.system.home" "action.system.home"
                    ], ],
                    "entities": [ "entities": [
                        "entity.system.home" "entity.system.home"
                    ], ],
                    "uris": [ "uris": [
                        { {
                            "scheme":"uri2", "scheme":"uri2",
                            "host":"host2", "host":"host2",
                            "port":"port2", "port":"port2",
                            "pathStartWith":"path2", "pathStartWith":"path2",
                            "pathRegex":"/query/.*", "pathRegex":"/query/.*",
                            "path":"path", "path":"path",
                            "type": "text/*" "type": "text/*"
                        }, },
                    ] ]
                } }
            ], ],
        } }
    ], ],
    "extensionAbilities": [ "extensionAbilities": [
        { {
            "skills": [ "skills": [
                { {
                    "actions": [ "actions": [
                    ], ],
                    "entities": [ "entities": [
                    ], ],
                    "uris": [ "uris": [
                        { {
                            "scheme":"uri2", "scheme":"uri2",
                            "host":"host2", "host":"host2",
                            "port":"port2", "port":"port2",
                            "pathStartWith":"path2", "pathStartWith":"path2",
                            "pathRegex":"/query/.*", "pathRegex":"/query/.*",
                            "path":"path", "path":"path",
                            "type": "text/*" "type": "text/*"
                        }, },
                    ] ]
                } }
            ], ],
        } }
    ], ],
} }
``` ```
...@@ -456,40 +442,40 @@ skills示例 ...@@ -456,40 +442,40 @@ skills示例
| type | 该标签标识extensionAbility的类型，取值为form、workScheduler、inputMethod、service、accessibility、dataShare、fileShare、staticSubscriber、wallpaper其中之一。 | 字符串 | 该标签不可缺省。 | | type | 该标签标识extensionAbility的类型，取值为form、workScheduler、inputMethod、service、accessibility、dataShare、fileShare、staticSubscriber、wallpaper其中之一。 | 字符串 | 该标签不可缺省。 |
| permissions | 该标签标识被其它应用的ability调用时需要申请的权限的集合，字符串数组类型，每个数组元素为一个权限名称，通常采用反向域名方式表示（最大255字节），可以是系统预定义的权限，也可以是该应用自定义的权限。如果是后者，需与defPermissions标签中定义的某个权限的name标签值一致。 | 字符串数组 | 该标签可缺省，缺省值为空。 | | permissions | 该标签标识被其它应用的ability调用时需要申请的权限的集合，字符串数组类型，每个数组元素为一个权限名称，通常采用反向域名方式表示（最大255字节），可以是系统预定义的权限，也可以是该应用自定义的权限。如果是后者，需与defPermissions标签中定义的某个权限的name标签值一致。 | 字符串数组 | 该标签可缺省，缺省值为空。 |
| uri | 该标签标识ability提供的数据uri，为字符数组类型（最大长度255），用反向域名的格式表示。该标签在type为dataShare类型的extensionAbility时，不可缺省。 | 字符串 | 该标签可缺省，缺省值为空。 | | uri | 该标签标识ability提供的数据uri，为字符数组类型（最大长度255），用反向域名的格式表示。该标签在type为dataShare类型的extensionAbility时，不可缺省。 | 字符串 | 该标签可缺省，缺省值为空。 |
| skills | 该标签标识ability能够接收的意图的特征集，为数组格式。<br />配置规则： entry包可以配置多个具有入口能力的skills标签（配置了action.system.home和entity.system.home）的ability，其中第一个配置了skills标签的ability中的label和icon作为OpenHarmony服务或应用的label和icon。<br/>OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。<br/>OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 <br />skills内部结构参考[skills对象内部结构](#skills对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 | | skills | 该标签标识ability能够接收的意图的特征集，为数组格式。<br />配置规则 : entry包可以配置多个具有入口能力的skills标签（配置了action.system.home和entity.system.home）的ability，其中第一个配置了skills标签的ability中的label和icon作为OpenHarmony服务或应用的label和icon。<br/>OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。<br/>OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 <br />skills内部结构参考[skills对象内部结构](#skills对象内部结构)。 | 数组 | 该标签可缺省，缺省值为空。 |
| metadata | 该标签表示extensionAbility的元信息。metadata内部结构参考[metadata对象内部结构](#metadata对象内部结构)。 | 对象 | 该标签可缺省，缺省值为空。 | | metadata | 该标签表示extensionAbility的元信息。metadata内部结构参考[metadata对象内部结构](#metadata对象内部结构)。 | 对象 | 该标签可缺省，缺省值为空。 |
| visible | 该标签标识extensionAbility是否可以被其它应用调用，为布尔类型。true表示可以被其它应用调用， false表示不可以被其它应用调用。 | | 该标签可缺省，缺省值为false。 | | visible | 该标签标识extensionAbility是否可以被其它应用调用，为布尔类型。true表示可以被其它应用调用， false表示不可以被其它应用调用。 | | 该标签可缺省，缺省值为false。 |
extensionAbility示例： extensionAbility示例 :
```json ```json
{ {
    "extensionAbilities": [ "extensionAbilities": [
        { {
            "name": "FormName", "name": "FormName",
            "srcEntrance": "./form/MyForm.ts", "srcEntrance": "./form/MyForm.ts",
            "icon": "$media:icon", "icon": "$media:icon",
            "label" : "$string:extension_name", "label" : "$string:extension_name",
            "description": "$string:form_description", "description": "$string:form_description",
            "type": "form",  "type": "form",
            "permissions": ["ohos.abilitydemo.permission.PROVIDER"], "permissions": ["ohos.abilitydemo.permission.PROVIDER"],
            "readPermission": "", "readPermission": "",
            "writePermission": "", "writePermission": "",
            "visible": true, "visible": true,
            "uri":"scheme://authority/path/query" "uri":"scheme://authority/path/query"
            "skills": [{ "skills": [{
                "actions": [], "actions": [],
                "entities": [], "entities": [],
                "uris": [] "uris": []
            }], }],
            "metadata": [ "metadata": [
                { {
                    "name": "ohos.extability.form", "name": "ohos.extability.form",
                    "resource": "$profile:form_config",  "resource": "$profile:form_config",
                } }
            ], ],
        } }
    ] ]
} }
``` ```
...@@ -504,19 +490,19 @@ extensionAbility示例： ...@@ -504,19 +490,19 @@ extensionAbility示例：
| --------- | ------------------------------------------------------------ | ------------------------------- | ----------------------------------------------------------- | ---------------------- | ------------------------------------------------------------ | | --------- | ------------------------------------------------------------ | ------------------------------- | ----------------------------------------------------------- | ---------------------- | ------------------------------------------------------------ |
| name | 必须，填写需要使用的权限名称。 | 字符串 | 自定义 | 无 | 未填写时，解析失败。 | | name | 必须，填写需要使用的权限名称。 | 字符串 | 自定义 | 无 | 未填写时，解析失败。 |
| reason | 可选，当申请的权限为user_grant权限时此字段必填。描述申请权限的原因。 | 字符串 | 显示文字长度不能超过256个字节。 | 空 | user_grant权限必填，否则不允许在应用市场上架。需做多语种适配。 | | reason | 可选，当申请的权限为user_grant权限时此字段必填。描述申请权限的原因。 | 字符串 | 显示文字长度不能超过256个字节。 | 空 | user_grant权限必填，否则不允许在应用市场上架。需做多语种适配。 |
| usedScene | 可选，当申请的权限为user_grant权限时此字段必填。描述权限使用的场景和时机。场景类型有：ability、when（调用时机）。可配置多个ability。 | ability：字符串数组when：字符串 | ability：ability的名称when：inuse（使用时）、always（始终） | ability：空when：inuse | user_grant权限必填ability，可选填when。 | | usedScene | 可选，当申请的权限为user_grant权限时此字段必填。描述权限使用的场景和时机。场景类型有 :ability、when（调用时机）。可配置多个ability。 | ability :字符串数组when :字符串 | ability :ability的名称when :inuse（使用时）、always（始终） | ability :空when :inuse | user_grant权限必填ability，可选填when。 |
requestPermissions示例： requestPermissions示例 :
```json ```json
{ {
    "usedScene": { "usedScene": {
        "abilities": [ "abilities": [
            "AudioAbility", "AudioAbility",
            "VedioAbility", "VedioAbility",
        ], ],
        "when": "inuse" "when": "inuse"
    } }
} }
``` ```
...@@ -526,9 +512,9 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收 ...@@ -526,9 +512,9 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收
1. extensions中指定type为form。 1. extensions中指定type为form。
2. metadata中指定form信息，其中： 2. metadata中指定form信息，其中 :
name：指定form的名称。使用ohos.extability.form作为form信息的标识。 name :指定form的名称。使用ohos.extability.form作为form信息的标识。
resource：指定form信息的资源位置。 resource :指定form信息的资源位置。
表11 forms对象的内部结构说明 表11 forms对象的内部结构说明
...@@ -538,13 +524,13 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收 ...@@ -538,13 +524,13 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收
| description | 表示卡片的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省，缺省为空。 | | description | 表示卡片的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省，缺省为空。 |
| src | 该标签标识JS卡片对应的UI代码。建议开发者通过自适应布局显示不同规格卡片，如果不同规格卡片布局相差较大，建议通过不同卡片来区分。 | 字符串 | 可缺省，缺省为空。 | | src | 该标签标识JS卡片对应的UI代码。建议开发者通过自适应布局显示不同规格卡片，如果不同规格卡片布局相差较大，建议通过不同卡片来区分。 | 字符串 | 可缺省，缺省为空。 |
| window | 该标签标识JS卡片的自适应能力。window结构参考表12。 | 对象 | 可缺省，缺省为空。 | | window | 该标签标识JS卡片的自适应能力。window结构参考表12。 | 对象 | 可缺省，缺省为空。 |
| isDefault | 表示该卡片是否为默认卡片，每个Ability有且只有一个默认卡片。 true：默认卡片。 false：非默认卡片。 | 布尔值 | 否 | | isDefault | 表示该卡片是否为默认卡片，每个Ability有且只有一个默认卡片。 true :默认卡片。 false :非默认卡片。 | 布尔值 | 否 |
| colorMode | 表示卡片的主题样式，取值范围如下： auto：自适应。 dark：深色主题。 light：浅色主题。 | 字符串 | 可缺省，缺省值为“auto”。 | | colorMode | 表示卡片的主题样式，取值范围如下 : auto :自适应。 dark :深色主题。 light :浅色主题。 | 字符串 | 可缺省，缺省值为“auto”。 |
| supportDimensions | 表示卡片支持的外观规格，取值范围： 1 * 2：表示1行2列的二宫格。 2 * 2：表示2行2列的四宫格。 2 * 4：表示2行4列的八宫格。 4 * 4：表示4行4列的十六宫格。 | 字符串数组 | 否 | | supportDimensions | 表示卡片支持的外观规格，取值范围 : 1 * 2 :表示1行2列的二宫格。 2 * 2 :表示2行2列的四宫格。 2 * 4 :表示2行4列的八宫格。 4 * 4 :表示4行4列的十六宫格。 | 字符串数组 | 否 |
| defaultDimension | 表示卡片的默认外观规格，取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 | | defaultDimension | 表示卡片的默认外观规格，取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 |
| updateDuration | 该标签标识卡片定时刷新的更新频率，单位为30分钟，取值为30的倍数值。卡片的最高频率为每30分钟刷新一次，和定点刷新二选一，二者都配置的情况下，定时优先。 | 数值 | 可缺省，缺省为空。 | | updateDuration | 该标签标识卡片定时刷新的更新频率，单位为30分钟，取值为30的倍数值。卡片的最高频率为每30分钟刷新一次，和定点刷新二选一，二者都配置的情况下，定时优先。 | 数值 | 可缺省，缺省为空。 |
| metadata | 该标签表示卡片的自定义信息。metadata内部结构参考表5。 | 对象 | 可缺省，缺省为空。 | | metadata | 该标签表示卡片的自定义信息。metadata内部结构参考表5。 | 对象 | 可缺省，缺省为空。 |
| formConfigAbility | 该标签标识卡片调整的Ability名称。标签值为字符串类型（最长127字符）。该标签值必须满足下面的格式：<br/>ability://单个ability名字<br/>单个ability名字必须为本应用的ability。 | 字符串 | 可缺省，缺省为空。 | | formConfigAbility | 该标签标识卡片调整的Ability名称。标签值为字符串类型（最长127字符）。该标签值必须满足下面的格式 :<br/>ability://单个ability名字<br/>单个ability名字必须为本应用的ability。 | 字符串 | 可缺省，缺省为空。 |
| formVisibleNotify | 该标签标识卡片是否被允许使用卡片可见性通知。标签值为true或false | 布尔值 | 该标签可缺省，默认值为false。 | | formVisibleNotify | 该标签标识卡片是否被允许使用卡片可见性通知。标签值为true或false | 布尔值 | 该标签可缺省，默认值为false。 |
表12 window内部结构说明 表12 window内部结构说明
...@@ -554,41 +540,41 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收 ...@@ -554,41 +540,41 @@ forms标签表示卡片的配置，form卡片是可以嵌入桌面上并接收
| designWidth | 指示页面设计的基线宽度，以像素为单位。 元素的大小由实际设备宽度缩放。 这个标签是一个整数。 | 数值 | 可缺省，缺省值为空。 | | designWidth | 指示页面设计的基线宽度，以像素为单位。 元素的大小由实际设备宽度缩放。 这个标签是一个整数。 | 数值 | 可缺省，缺省值为空。 |
| autoDesignWidth | 指定是否自动计算页面设计的基线宽度。 如果设置为true，则designWidth属性无效。基线宽度根据设备宽度和屏幕密度计算。 | 布尔值 | 可缺省，缺省值为空。 | | autoDesignWidth | 指定是否自动计算页面设计的基线宽度。 如果设置为true，则designWidth属性无效。基线宽度根据设备宽度和屏幕密度计算。 | 布尔值 | 可缺省，缺省值为空。 |
form示例： form示例 :
在开发视图的resources/base/profile下面定义配置文件form_config.json（文件名称可由开发者定义） 在开发视图的resources/base/profile下面定义配置文件form_config.json（文件名称可由开发者定义）
```json ```json
{ {
    "forms": [ "forms": [
        { {
            "name": "Form_Js", "name": "Form_Js",
            "description": "$string:form_description", "description": "$string:form_description",
            "src": "./js/pages/card/index", "src": "./js/pages/card/index",
            "window": { "window": {
                "designWidth": 720, "designWidth": 720,
                "autoDesignWidth": true "autoDesignWidth": true
            }, },
            "colorMode": "auto", "colorMode": "auto",
            "formConfigAbility": "ability://xxxxx", "formConfigAbility": "ability://xxxxx",
            "formVisibleNotify": false, "formVisibleNotify": false,
            "isDefault": true, "isDefault": true,
            "updateEnabled": true, "updateEnabled": true,
            "scheduledUpdateTime": "10:30", "scheduledUpdateTime": "10:30",
            "updateDuration": 1, "updateDuration": 1,
            "defaultDimension": "2*2", "defaultDimension": "2*2",
            "supportDimensions": [ "supportDimensions": [
                "2*2" "2*2"
            ], ],
           "metadata": [ "metadata": [
             { {
                "name": "string", "name": "string",
                "value": "string", "value": "string",
                "resource": "$profile:config_file" "resource": "$profile:config_file"
             } }
           ]  ]
        } }
    ] ]
} }
``` ```
...@@ -596,14 +582,14 @@ form示例： ...@@ -596,14 +582,14 @@ form示例：
```json ```json
{ {
"extensionAbilities": [ "extensionAbilities": [
{ {
"name": "MyForm", "name": "MyForm",
"type": "form",  "type": "form",
"metadata": [ "metadata": [
{ {
"name": "ohos.extability.form", "name": "ohos.extability.form",
"resource": "$profile:form_config", "resource": "$profile:form_config",
} }
], ],
} }
...@@ -615,9 +601,9 @@ form示例： ...@@ -615,9 +601,9 @@ form示例：
标识应用的快捷方式信息。标签值为数组，最多可以配置四个快捷方式。其包含四个子标签shortcutId、label、icon、intents。 标识应用的快捷方式信息。标签值为数组，最多可以配置四个快捷方式。其包含四个子标签shortcutId、label、icon、intents。
metadata中指定shortcut信息，其中： metadata中指定shortcut信息，其中 :
1）name：指定shortcuts的名称。使用ohos.ability.shortcut作为shortcuts信息的标识。 1）name :指定shortcuts的名称。使用ohos.ability.shortcut作为shortcuts信息的标识。
2）resource：指定shortcuts信息的资源位置。 2）resource :指定shortcuts信息的资源位置。
表13 shortcuts对象的内部结构说明 表13 shortcuts对象的内部结构说明
...@@ -626,63 +612,63 @@ metadata中指定shortcut信息，其中： ...@@ -626,63 +612,63 @@ metadata中指定shortcut信息，其中：
| shortcutId | 表示快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 否 | | shortcutId | 表示快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 否 |
| label | 表示快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值可以是描述性内容，也可以是标识label的资源索引。字符串最大长度为63字节。 | 字符串 | 可缺省，缺省为空。 | | label | 表示快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值可以是描述性内容，也可以是标识label的资源索引。字符串最大长度为63字节。 | 字符串 | 可缺省，缺省为空。 |
| icon | 该标签标识shortcut的图标，标签值为资源文件的索引。 | 字符串 | 该标签可缺省，缺省值为空。 | | icon | 该标签标识shortcut的图标，标签值为资源文件的索引。 | 字符串 | 该标签可缺省，缺省值为空。 |
| wants | 该标签标识快捷方式内定义的目标wants信息集合，每个want可配置两个子标签，bundleName，abilityName。<br />bundleName：快捷方式目标包名，字符串类型。<br />abilityName：快捷方式的目标组件名，字符串类型。 | 对象 | 该标签可缺省，缺省为空。 | | wants | 该标签标识快捷方式内定义的目标wants信息集合，每个want可配置两个子标签，bundleName，abilityName。<br />bundleName :快捷方式目标包名，字符串类型。<br />abilityName :快捷方式的目标组件名，字符串类型。 | 对象 | 该标签可缺省，缺省为空。 |
在开发视图的resources/base/profile下面定义配置文件shortcut_config.json（文件名称可由开发者定义）。 在开发视图的resources/base/profile下面定义配置文件shortcut_config.json（文件名称可由开发者定义）。
```json ```json
{ {
        "shortcuts": [ "shortcuts": [
            { {
                "shortcutId": "id_test1", "shortcutId": "id_test1",
                "label": "$string:shortcut", "label": "$string:shortcut",
                "icon": "$media:aa_icon", "icon": "$media:aa_icon",
                "wants": [ "wants": [
                    { {
                       "bundleName": "com.ohos.hello" "bundleName": "com.ohos.hello"
                       "abilityName": "MainAbility" "abilityName": "MainAbility"
                    } }
                ] ]
            } }
        ] ]
} }
``` ```
在config.json的module下面定义metadata信息，如下： 在config.json的module下面定义metadata信息，如下 :
```json ```json
{ {
    "module": { "module": {
        "name": "MyAbilityStage", "name": "MyAbilityStage",
        "abilities" : [ "abilities" : [
            { {
                "name" : "MyAbility", "name" : "MyAbility",
                "srcEntrance": "./abilities/MyAbility.ts", "srcEntrance": "./abilities/MyAbility.ts",
                "skills": [{ "skills": [{
                            "actions": ["action.system.home"], "actions": ["action.system.home"],
                            "entities": ["entity.system.home"], "entities": ["entity.system.home"],
                            "uris": [] "uris": []
                }], }],
                "metadata": [ "metadata": [
                    { {
                        "name": "ohos.ability.shortcut", "name": "ohos.ability.shortcut",
                        "resource": "$profile:shortcuts_config",  "resource": "$profile:shortcuts_config",
                    } }
                ], ],
            } }
        ] ]
    } }
} }
``` ```
#### commonEvents对象内部结构 #### commonEvents对象内部结构
commonEvents标签标识注册静态公共事件信息。标签值为数组。 commonEvents标签标识注册静态公共事件信息。标签值为数组。
metadata中指定commonEvent信息，其中： metadata中指定commonEvent信息，其中 :
1. name：指定commonEvent的名称。使用ohos.extability.staticSubscriber作为commonEvent信息的标识。 1. name :指定commonEvent的名称。使用ohos.extability.staticSubscriber作为commonEvent信息的标识。
2. resource：指定commonEvent信息的资源位置。 2. resource :指定commonEvent信息的资源位置。
表14 commonEvents对象内部结构 表14 commonEvents对象内部结构
...@@ -697,38 +683,38 @@ metadata中指定commonEvent信息，其中： ...@@ -697,38 +683,38 @@ metadata中指定commonEvent信息，其中：
```json ```json
{ {
    "commonEvents": [ "commonEvents": [
            { {
                "name": "abilityName", "name": "abilityName",
                "permission": "string", "permission": "string",
                "types": [ "types": [
                    "string", "string",
                    "string" "string"
                ], ],
                "events": [ "events": [
                    "string", "string",
                    "string" "string"
                ] ]
            } }
    ] ]
} }
``` ```
在module.json的extension组件下面定义metadata信息，如下： 在module.json的extension组件下面定义metadata信息，如下 :
```json ```json
"extensionAbilities": [ "extensionAbilities": [
    { {
        "name": "mySubscriber", "name": "mySubscriber",
        "srcEntrance": "./extension/my_subscriber.js", "srcEntrance": "./extension/my_subscriber.js",
        "type": "staticSubscriber", "type": "staticSubscriber",
        "metadata": [ "metadata": [
            { {
                "name": "ohos.extability.staticSubscriber", "name": "ohos.extability.staticSubscriber",
                "resource": "$profile:common_event_config",  "resource": "$profile:common_event_config",
            } }
        ], ],
    } }
] ]
``` ```
...@@ -745,7 +731,7 @@ metadata中指定commonEvent信息，其中： ...@@ -745,7 +731,7 @@ metadata中指定commonEvent信息，其中：
| apiVersion | 表示支持的apiVersion范围。参考表16。 | 对象数组 | 该标签可缺省，缺省值为空。 | | apiVersion | 表示支持的apiVersion范围。参考表16。 | 对象数组 | 该标签可缺省，缺省值为空。 |
| screenShape | 表示屏幕形状的支持策略。 | 对象数组 | 该标签可缺省，缺省值为空。 | | screenShape | 表示屏幕形状的支持策略。 | 对象数组 | 该标签可缺省，缺省值为空。 |
| screenWindow | 表示应用运行时窗口的分辨率支持策略。该字段仅支持对轻量级智能穿戴设备进行配置。 | 对象数组 | 该标签可缺省，缺省值为空。 | | screenWindow | 表示应用运行时窗口的分辨率支持策略。该字段仅支持对轻量级智能穿戴设备进行配置。 | 对象数组 | 该标签可缺省，缺省值为空。 |
| screenDensity | 该标签表示屏幕的像素密度（dpi：Dot Per Inch）。该字段可选，如果配置了该字段，取值必须合法。该标签为字符串数组，字符串范围如下。<br />sdpi：表示小规模的屏幕密度（Small-scale Dots per Inch），适用于dpi取值为（0,120]的设备。<br />mdpi：表示中规模的屏幕密度(Medium-scale Dots Per Inch)，适用于dpi取值为(120,160]的设备。<br />ldpi：表示大规模的屏幕密度(Large-scale Dots Per Inch)，适用于dpi取值为(160,240]的设备。<br /> xldpi：表示大规模的屏幕密度(Extra Large-scale Dots Per Inch)，适用于dpi取值为(240,320]的设备。<br />xxldpi：表示大规模的屏幕密度(Extra Extra Large-scale Dots Per Inch)，适用于dpi取值为(320，480]的设备。<br />xxxldpi：表示大规模的屏幕密度(Extra Extra Extra Large-scale Dots Per Inch)，适用于dpi取值为(480, 640]的设备。 | 对象数组 | 该标签可缺省，缺省值为空。 | | screenDensity | 该标签表示屏幕的像素密度（dpi :Dot Per Inch）。该字段可选，如果配置了该字段，取值必须合法。该标签为字符串数组，字符串范围如下。<br />sdpi :表示小规模的屏幕密度（Small-scale Dots per Inch），适用于dpi取值为（0,120]的设备。<br />mdpi :表示中规模的屏幕密度(Medium-scale Dots Per Inch)，适用于dpi取值为(120,160]的设备。<br />ldpi :表示大规模的屏幕密度(Large-scale Dots Per Inch)，适用于dpi取值为(160,240]的设备。<br /> xldpi :表示大规模的屏幕密度(Extra Large-scale Dots Per Inch)，适用于dpi取值为(240,320]的设备。<br />xxldpi :表示大规模的屏幕密度(Extra Extra Large-scale Dots Per Inch)，适用于dpi取值为(320，480]的设备。<br />xxxldpi :表示大规模的屏幕密度(Extra Extra Extra Large-scale Dots Per Inch)，适用于dpi取值为(480, 640]的设备。 | 对象数组 | 该标签可缺省，缺省值为空。 |
| countryCode | 该标签表示应用需要分发的国家地区码，具体值以ISO-3166-1标准为准。支持多个国家和地区枚举定义。该字段可选，如果配置了该字段，取值必须合法。标签值字符串数组，子串表示所支持的国家或地区，由两个大写字母组成。 | 对象数组 | 该标签可缺省，缺省值为空。 | | countryCode | 该标签表示应用需要分发的国家地区码，具体值以ISO-3166-1标准为准。支持多个国家和地区枚举定义。该字段可选，如果配置了该字段，取值必须合法。标签值字符串数组，子串表示所支持的国家或地区，由两个大写字母组成。 | 对象数组 | 该标签可缺省，缺省值为空。 |
表16 apiVersion对象的内部结构说明 表16 apiVersion对象的内部结构说明
...@@ -753,28 +739,28 @@ metadata中指定commonEvent信息，其中： ...@@ -753,28 +739,28 @@ metadata中指定commonEvent信息，其中：
| 属性名称 | 含义 | 数据类型 | 是否可缺省 | | 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | ------------------------------------------------------------ | -------- | -------------------- | | -------- | ------------------------------------------------------------ | -------- | -------------------- |
| policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 | | policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 |
| value | 支持的取值为API Version存在的整数值，例如4、5、6。场景示例：某应用，针对相同设备型号，同时在网的为使用API 5和API 6开发的两个软件版本，则允许上架2个entry类型的安装包，分别支持到对应设备侧软件版本的分发。 | 数组 | 可缺省，缺省值为空。 | | value | 支持的取值为API Version存在的整数值，例如4、5、6。场景示例 :某应用，针对相同设备型号，同时在网的为使用API 5和API 6开发的两个软件版本，则允许上架2个entry类型的安装包，分别支持到对应设备侧软件版本的分发。 | 数组 | 可缺省，缺省值为空。 |
表17 screenShape对象的内部结构说明 表17 screenShape对象的内部结构说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 | | 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | ------------------------------------------------------------ | -------- | -------------------- | | -------- | ------------------------------------------------------------ | -------- | -------------------- |
| policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 | | policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 |
| value | 支持的取值为circle（圆形）、rect（矩形）。场景示例：针对智能穿戴设备，可为圆形表盘和矩形表盘分别提供不同的HAP。 | 数组 | 可缺省，缺省值为空。 | | value | 支持的取值为circle（圆形）、rect（矩形）。场景示例 :针对智能穿戴设备，可为圆形表盘和矩形表盘分别提供不同的HAP。 | 数组 | 可缺省，缺省值为空。 |
表18 screenWindow对象的内部结构说明 表18 screenWindow对象的内部结构说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 | | 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | ------------------------------------------------------------ | -------- | -------------------- | | -------- | ------------------------------------------------------------ | -------- | -------------------- |
| policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 | | policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 |
| value | 单个字符串的取值格式为：“宽 * 高”，取值为整数像素值，例如“454 * 454”。 | 数组 | 可缺省，缺省值为空。 | | value | 单个字符串的取值格式为 :“宽 * 高”，取值为整数像素值，例如“454 * 454”。 | 数组 | 可缺省，缺省值为空。 |
表19 screenDensity对象的内部结构说明 表19 screenDensity对象的内部结构说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 | | 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | ------------------------------------------------------------ | -------- | -------------------- | | -------- | ------------------------------------------------------------ | -------- | -------------------- |
| policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 | | policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 |
| value | 该标签表示屏幕的像素密度（dpi：Dot Per Inch）。 | 数组 | 可缺省，缺省值为空。 | | value | 该标签表示屏幕的像素密度（dpi :Dot Per Inch）。 | 数组 | 可缺省，缺省值为空。 |
表20 countryCode对象的内部结构说明 表20 countryCode对象的内部结构说明
...@@ -783,7 +769,7 @@ metadata中指定commonEvent信息，其中： ...@@ -783,7 +769,7 @@ metadata中指定commonEvent信息，其中：
| policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 | | policy | 表示该子属性取值的黑白名单规则。配置为“exclude”或“include”。“include”表示该字段取值为白名单，满足value枚举值匹配规则的表示匹配该属性。 | 字符串 | 可缺省，缺省值为空。 |
| value | 该标签表示应用需要分发的国家地区码。 | 数组 | 可缺省，缺省值为空。 | | value | 该标签表示应用需要分发的国家地区码。 | 数组 | 可缺省，缺省值为空。 |
distroFilter示例： distroFilter示例 :
在开发视图的resources/base/profile下面定义配置文件distroFilter_config.json（文件名称可由开发者定义）。 在开发视图的resources/base/profile下面定义配置文件distroFilter_config.json（文件名称可由开发者定义）。
...@@ -806,21 +792,21 @@ distroFilter示例： ...@@ -806,21 +792,21 @@ distroFilter示例：
] ]
``` ```
在module.json的extensionAbilities组件下面定义metadata信息，如下： 在module.json的extensionAbilities组件下面定义metadata信息，如下 :
```json ```json
"extensionAbilities": [ "extensionAbilities": [
    { {
        "name": "mySubscriber", "name": "mySubscriber",
        "srcEntrance": "./extension/my_subscriber.js", "srcEntrance": "./extension/my_subscriber.js",
        "type": "staticSubscriber",  "type": "staticSubscriber",
        "metadata": [ "metadata": [
            { {
                "name": "ohos.extability.staticSubscriber", "name": "ohos.extability.staticSubscriber",
                "resource": "$profile:distroFilter_config",  "resource": "$profile:distroFilter_config",
            } }
        ], ],
    } }
] ]
``` ```
......
zh-cn/application-dev/quick-start/package-structure.md
浏览文件 @ f3b4431c
...@@ -129,7 +129,7 @@ app实例： ...@@ -129,7 +129,7 @@ app实例：
### deviceConfig对象的内部结构 ### deviceConfig对象的内部结构
deviceConfig包含设备上的应用配置信息，可以包含default，tv，car，wearable，liteWearable等属性。default标签内的配置是适用于所有通用设备，其他设备类型如果有特殊的需求，则需要在该设备类型的标签下进行配置。内部结构说明参见表5。 deviceConfig包含设备上的应用配置信息，可以包含default，tv，car，wearable等属性。default标签内的配置是适用于所有通用设备，其他设备类型如果有特殊的需求，则需要在该设备类型的标签下进行配置。内部结构说明参见表5。
表5 deviceConfig对象的内部结构说明 表5 deviceConfig对象的内部结构说明
...@@ -140,9 +140,8 @@ deviceConfig包含设备上的应用配置信息，可以包含default，tv，ca ...@@ -140,9 +140,8 @@ deviceConfig包含设备上的应用配置信息，可以包含default，tv，ca
| tv | 表示智慧屏特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 | | tv | 表示智慧屏特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 |
| car | 表示车机特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 | | car | 表示车机特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 |
| wearable | 表示智能穿戴特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 | | wearable | 表示智能穿戴特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 |
| liteWearable | 表示轻量级智能穿戴特有的应用配置信息。参考表6。 | 对象 | 可缺省，缺省值为空 |
default、tablet、tv、car、wearable、liteWearble等对象的内部结构说明，可参见表6。 default、tablet、tv、car、wearable等对象的内部结构说明，可参见表6。
表6 不同设备的内部结构说明 表6 不同设备的内部结构说明
...@@ -222,7 +221,7 @@ module对象包含HAP包的配置信息，内部结构说明参见表11。 ...@@ -222,7 +221,7 @@ module对象包含HAP包的配置信息，内部结构说明参见表11。
| name | 表示HAP的类名。采用反向域名 方式表示，前缀要与同级的package标签指定的包名一致，也可采用"."开头的命名方式。字符串长度不超过255字节。<br /> 该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 否 | | name | 表示HAP的类名。采用反向域名 方式表示，前缀要与同级的package标签指定的包名一致，也可采用"."开头的命名方式。字符串长度不超过255字节。<br /> 该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 否 |
| description | 表示HAP的描述信息。字符串长度不超过255字节。如果字符串超出长度或者需要支持多语言，可以采用资源索引的方式添加描述内容。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 可缺省，缺省值为空 | | description | 表示HAP的描述信息。字符串长度不超过255字节。如果字符串超出长度或者需要支持多语言，可以采用资源索引的方式添加描述内容。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 可缺省，缺省值为空 |
| supportedModes | 表示应用支持的运行模式，当前只定义了驾驶模式（drive）。该标签只适用于车机。 | 字符串数组 | 可缺省，缺省值为空 | | supportedModes | 表示应用支持的运行模式，当前只定义了驾驶模式（drive）。该标签只适用于车机。 | 字符串数组 | 可缺省，缺省值为空 |
| deviceType | 表示允许Ability运行的设备类型。系统预定义的设备类型包括：tablet(平板)、tv（智慧屏）、car(车机)、wearable(智能穿戴)、liteWearable(轻量级智能穿戴)等。 | 字符串数组 | 否 | | deviceType | 表示允许Ability运行的设备类型。系统预定义的设备类型包括：tablet(平板)、tv（智慧屏）、car(车机)、wearable(智能穿戴)等。 | 字符串数组 | 否 |
| distro | 表示HAP发布的具体描述。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。参考表12。 | 对象 | 否 | | distro | 表示HAP发布的具体描述。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。参考表12。 | 对象 | 否 |
| metaData | 表示HAP的元信息。参考表13。 | 对象 | 可缺省，缺省值为空 | | metaData | 表示HAP的元信息。参考表13。 | 对象 | 可缺省，缺省值为空 |
| abilities | 表示当前模块内的所有Ability。采用对象数据格式。其中的每个元素表示一个快捷方式对象。参考表17。 | 对象数组 | 可缺省，缺省值为空 | | abilities | 表示当前模块内的所有Ability。采用对象数据格式。其中的每个元素表示一个快捷方式对象。参考表17。 | 对象数组 | 可缺省，缺省值为空 |
...@@ -230,7 +229,7 @@ module对象包含HAP包的配置信息，内部结构说明参见表11。 ...@@ -230,7 +229,7 @@ module对象包含HAP包的配置信息，内部结构说明参见表11。
| shortcuts | 表示应用的快捷方式信息。采用对象数组格式，其中的每个元素表示一个快捷方式对象。参考表25。 | 对象数组 | 可缺省，缺省值为空 | | shortcuts | 表示应用的快捷方式信息。采用对象数组格式，其中的每个元素表示一个快捷方式对象。参考表25。 | 对象数组 | 可缺省，缺省值为空 |
| reqPermissions | 表示应用运行时向系统申请的权限。参考表21。 | 对象数组 | 可缺省，缺省值为空 | | reqPermissions | 表示应用运行时向系统申请的权限。参考表21。 | 对象数组 | 可缺省，缺省值为空 |
| colorMode | 表示应用自身的颜色模式。<br /> dark：表示按照深色模式选取资源。<br /> light：表示按照浅色模式选取资源。<br /> auto：表示跟随系统的颜色模式值选取资源。<br /> 该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 可缺省，缺省值为"auto" | | colorMode | 表示应用自身的颜色模式。<br /> dark：表示按照深色模式选取资源。<br /> light：表示按照浅色模式选取资源。<br /> auto：表示跟随系统的颜色模式值选取资源。<br /> 该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。 | 字符串 | 可缺省，缺省值为"auto" |
| distroFilter | 表示应用的分发规则。<br /> 该标签用于定义HAP包对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Verion、屏幕形状、屏幕分辨率。在进行分发时，通过deviceType与这三个属性的匹配关系，唯一确定一个用于分发到设备的HAP。参考表29。 | 对象 | 可缺省，缺省值为空。但当应用中包含多个entry模块时，必须配置该标签。 | | distroFilter | 表示应用的分发规则。<br /> 该标签用于定义HAP包对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Version、屏幕形状、屏幕分辨率。在进行分发时，通过deviceType与这三个属性的匹配关系，唯一确定一个用于分发到设备的HAP。参考表29。 | 对象 | 可缺省，缺省值为空。但当应用中包含多个entry模块时，必须配置该标签。 |
| reqCapabilities | 表示运行应用程序所需的设备能力 | 字符串数组 | 可缺省，缺省为空 | | reqCapabilities | 表示运行应用程序所需的设备能力 | 字符串数组 | 可缺省，缺省为空 |
| commonEvents | 静态广播，参考表35。 | 对象数组 | 可缺省，缺省为空 | | commonEvents | 静态广播，参考表35。 | 对象数组 | 可缺省，缺省为空 |
| allowClassMap | HAP的元信息。标记值为true或false。如果标记值为true，则hap使用OpenHarmony框架提供的Java对象代理机制。默认值为false。 | 布尔值 | 不可缺省，缺省值为false | | allowClassMap | HAP的元信息。标记值为true或false。如果标记值为true，则hap使用OpenHarmony框架提供的Java对象代理机制。默认值为false。 | 布尔值 | 不可缺省，缺省值为false |
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或