1# module.json5配置文件 2 3## 配置文件示例 4 5先通过一个示例，整体认识一下module.json5配置文件。 6<!--RP1--> 7```json 8{ 9 "module": { 10 "name": "entry", 11 "type": "entry", 12 "description": "$string:module_desc", 13 "srcEntry": "./ets/entryability/EntryAbility.ets", 14 "mainElement": "EntryAbility", 15 "deviceTypes": [ 16 "default", 17 "tablet" 18 ], 19 "deliveryWithInstall": true, 20 "installationFree": false, 21 "pages": "$profile:main_pages", 22 "virtualMachine": "ark", 23 "appStartup": "$profile:app_startup_config", 24 "metadata": [ 25 { 26 "name": "string", 27 "value": "string", 28 "resource": "$profile:distributionFilter_config" 29 } 30 ], 31 "abilities": [ 32 { 33 "name": "EntryAbility", 34 "srcEntry": "./ets/entryability/EntryAbility.ets", 35 "description": "$string:EntryAbility_desc", 36 "icon": "$media:layered_image", 37 "label": "$string:EntryAbility_label", 38 "startWindowIcon": "$media:icon", 39 "startWindowBackground": "$color:start_window_background", 40 "exported": true, 41 "skills": [ 42 { 43 "entities": [ 44 "entity.system.home" 45 ], 46 "actions": [ 47 "ohos.want.action.home" 48 ] 49 } 50 ], 51 "continueType": [ 52 "continueType1" 53 ], 54 "continueBundleName": [ 55 "com.example.myapplication1", 56 "com.example.myapplication2" 57 ] 58 } 59 ], 60 "definePermissions": [ 61 { 62 "name": "ohos.abilitydemo.permission.PROVIDER", 63 "grantMode": "system_grant", 64 "availableLevel": "system_core", 65 "provisionEnable": true, 66 "distributedSceneEnable": false, 67 "label": "$string:EntryAbility_label" 68 } 69 ], 70 "requestPermissions": [ 71 { 72 "name": "ohos.abilitydemo.permission.PROVIDER", 73 "reason": "$string:reason", 74 "usedScene": { 75 "abilities": [ 76 "FormAbility" 77 ], 78 "when": "inuse" 79 } 80 } 81 ], 82 "targetModuleName": "feature", 83 "targetPriority": 50, 84 "querySchemes": [ 85 "app1Scheme", 86 "app2Scheme" 87 ], 88 "routerMap": "$profile:router_map", 89 "appEnvironments": [ 90 { 91 "name": "name1", 92 "value": "value1" 93 } 94 ], 95 "hnpPackages": [ 96 { 97 "package": "hnpsample.hnp", 98 "type": "public" 99 } 100 ], 101 "fileContextMenu": "$profile:menu" 102 } 103} 104``` 105<!--RP1End--> 106 107## 配置文件标签 108 109module.json5配置文件包含以下标签。 110 111 112 **表1** module.json5配置文件标签说明 113 114| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 115| -------- | -------- | -------- | -------- | 116| name | 标识当前Module的名称，确保该名称在整个应用中唯一。命名规则如下 ：<br/>- 由字母、数字和下划线组成，且必须以字母开头。<br/>- 最大长度31字节。<br/>应用升级时允许修改该名称，但需要应用适配Module相关数据目录的迁移，详见[文件管理接口](../reference/apis-core-file-kit/js-apis-file-fs.md#fscopydir10)。 | 字符串 | 该标签不可缺省。 | 117| type | 标识当前Module的类型。支持的取值如下：<br/>- entry：应用的主模块。<br/>- feature：应用的动态特性模块。<br/>- har：静态共享包模块。<br/>- shared：动态共享包模块。 | 字符串 | 该标签不可缺省。 | 118| srcEntry | 标识当前Module所对应入口UIAbility或者ExtensionAbility的代码路径，需要和mainElement字段指向同一个UIAbility或者ExtensionAbility，取值为长度不超过127字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 119| description | 标识当前Module的描述信息，开发者可以通过该字段描述当前模块的功能与作用，取值为长度不超过255字节的字符串，可以采用字符串资源索引格式。 | 字符串 | 该标签可缺省，缺省值为空。 | 120| <!--DelRow-->process | 标识当前Module的进程名，取值为长度不超过31字节的字符串。如果在HAP标签下配置了process，则该Module的所有UIAbility、DataShareExtensionAbility、ServiceExtensionAbility都运行在该进程中。<br/>**说明：**<br/>开启[多实例特权](../../device-dev/subsystems/subsys-app-privilege-config-guide.md#可由设备厂商配置的特权)生效，三方应用配置不生效。 | 字符串 | 该标签可缺省，缺省为app.json5文件下app标签下的bundleName。 | 121| mainElement | 标识当前Module的入口UIAbility名称或者ExtensionAbility名称，需要和srcEntry字段指向同一个UIAbility或者ExtensionAbility，取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 122| [deviceTypes](#devicetypes标签) | 标识当前Module可以运行在哪类设备上。<br/>**说明：**<br/>当存在多个模块时，各模块中的配置可以不一致，但必须包含所需的设备类型以确保正常运行。 | 字符串数组 | 该标签不可缺省。 | 123| deliveryWithInstall | 标识当前Module是否在用户主动安装的时候安装，即该Module对应的HAP是否跟随应用一起安装。<br/>- true：主动安装时安装。<br/>- false：主动安装时不安装。 | 布尔值 | 该标签不可缺省。 | 124| installationFree | 标识当前Module是否支持免安装特性。<br/>- true：表示支持免安装特性，且符合免安装约束。<br/>- false：表示不支持免安装特性。<br/>**说明：**<br/>当[bundleType](./app-configuration-file.md#配置文件标签)为原子化服务时，该字段需要配置为true。反之，该字段需要配置为false。 | 布尔值 | 该标签不可缺省。 | 125| virtualMachine | 标识当前Module运行的目标虚拟机类型，供云端分发使用，如应用市场和分发中心。如果目标虚拟机类型为ArkTS引擎，则其值为“ark+版本号”。 | 字符串 | 该标签由IDE构建HAP的时候自动插入。 | 126| [pages](#pages标签) | 标识当前Module的profile资源，用于列举每个页面信息，取值为长度不超过255字节的字符串。 | 字符串 | 在有UIAbility的场景下，该标签不可缺省。 | 127| [metadata](#metadata标签) | 标识当前Module的自定义元信息，可通过资源引用的方式配置[distributionFilter](#distributionfilter标签)、[shortcuts](#shortcuts标签)等信息。只对当前Module、UIAbility、ExtensionAbility生效。 | 对象数组 | 该标签可缺省，缺省值为空。 | 128| [abilities](#abilities标签) | 标识当前Module中UIAbility的配置信息，只对当前UIAbility生效。 | 对象数组 | 该标签可缺省，缺省值为空。 | 129| [extensionAbilities](#extensionabilities标签) | 标识当前Module中ExtensionAbility的配置信息，只对当前ExtensionAbility生效。 | 对象数组 | 该标签可缺省，缺省值为空。 | 130| [definePermissions](#definepermissions标签) | 标识系统资源hap定义的权限，不支持应用自定义权限。 | 对象数组 | 该标签可缺省，缺省值为空。 | 131| [requestPermissions](../security/AccessToken/declare-permissions.md#在配置文件中声明权限)| 标识当前应用运行时需向系统申请的权限集合。 | 对象数组 | 该标签可缺省，缺省值为空。 | 132| [testRunner](#testrunner标签) | 标识用于测试当前Module的测试框架的配置。 | 对象 | 该标签可缺省，缺省值为空。 | 133| [atomicService](#atomicservice标签)| 标识当前应用是原子化服务时，有关原子化服务的相关配置。| 对象 | 该标签可缺省，缺省值为空。 | 134| [dependencies](#dependencies标签)| 标识当前模块运行时依赖的共享库列表。| 对象数组 | 该标签可缺省，缺省值为空。 | 135| targetModuleName | 标识当前包所指定的目标module，确保该名称在整个应用中唯一。取值为长度不超过31字节的字符串，不支持中文。配置该字段的Module具有overlay特性。仅在动态共享包（HSP）中适用。 |字符串|该标签可缺省，缺省值为空。| 136| targetPriority | 标识当前Module的优先级，取值范围为1~100。配置targetModuleName字段之后，才需要配置该字段。仅在动态共享包（HSP）中适用。 |整型数值|该标签可缺省，缺省值为1。| 137| [proxyData](#proxydata标签) | 标识当前Module提供的数据代理列表。| 对象数组 | 该标签可缺省，缺省值为空。| 138| isolationMode | 标识当前Module的多进程配置项。支持的取值如下：<br/>- nonisolationFirst：优先在非独立进程中运行。<br/>- isolationFirst：优先在独立进程中运行。<br/>- isolationOnly：只在独立进程中运行。<br/>- nonisolationOnly：只在非独立进程中运行。 |字符串|该标签可缺省，缺省值为nonisolationFirst。| 139| generateBuildHash |标识当前HAP/HSP是否由打包工具生成哈希值。当配置为true时，如果系统OTA升级时应用versionCode保持不变，可根据哈希值判断应用是否需要升级。<br/>该字段仅在[app.json5文件](./app-configuration-file.md)中的generateBuildHash字段为false时使能。<br/>**说明：**<br/>该字段仅对预置应用生效。|布尔值|该标签可缺省，缺省值为false。| 140| compressNativeLibs | 标识libs库是否以压缩存储的方式打包到HAP。<br/>- true：libs库以压缩方式存储。<br/>- false：libs库以不压缩方式存储。 | 布尔值 | 该标签可缺省，缺省值为false。 | 141| libIsolation | 用于区分同应用不同HAP下的.so文件，以防止.so冲突。<br/>- true：当前HAP的.so文件会储存在libs目录中以Module名命名的路径下。<br/>- false：当前HAP的.so文件会直接储存在libs目录中。 | 布尔值 | 该标签可缺省，缺省值为false。 | 142| fileContextMenu | 标识当前HAP的右键菜单配置项。取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 143| querySchemes | 标识允许当前应用进行跳转查询的URL schemes，只允许entry类型模块配置，最多50个，每个字符串取值不超过128字节。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 144| [routerMap](#routermap标签) | 标识当前模块配置的路由表路径。取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 145| [appEnvironments](#appenvironments标签) | 标识当前模块配置的应用环境变量，只允许entry和feature模块配置。 | 对象数组 | 该标签可缺省，缺省值为空。 | 146| appStartup | 标识当前Module启动框架配置路径，仅在Entry中生效。 | 字符串 | 该标签可缺省，缺省值为空。 | 147| [hnpPackages](#hnppackages标签) | 标识当前应用包含的Native软件包信息。只允许entry类型模块配置。 | 对象数组 | 该标签可缺省，缺省值为空。 | 148 149## deviceTypes标签 150 151 **表2** deviceTypes标签说明 152<!--RP2--> 153| 设备类型 | 枚举值 | 说明 | 154| -------- | -------- | -------- | 155| 平板 | tablet | - | 156| 智慧屏 | tv | - | 157| 智能手表 | wearable | 系统能力较丰富的手表，具备电话功能。 | 158| 车机 | car | - | 159| PC/2in1 | 2in1 | 即PC设备，主要交互方式以多窗口、多任务及键盘鼠标操作为主，充分发挥设备的生产力属性。在OpenHarmony文档中，所有“2in1”均代表“PC/2in1”。 | 160| 默认设备 | default | 能够使用全部系统能力的设备。 | 161<!--RP2End--> 162 163deviceTypes示例： 164 165 166```json 167{ 168 "module": { 169 "name": "myHapName", 170 "type": "feature", 171 "deviceTypes" : [ 172 "tablet" 173 ] 174 } 175} 176``` 177 178 179## pages标签 180 181该标签是一个profile文件资源，用于指定描述页面信息的配置文件。 182 183 184```json 185{ 186 "module": { 187 // ... 188 "pages": "$profile:main_pages", // 通过profile下的资源文件配置 189 } 190} 191``` 192 193在开发视图的resources/base/profile下面定义配置文件main_pages.json，其中文件名"main_pages"可自定义，需要和pages标签指定的信息对应。配置文件中列举了当前应用组件中的页面信息，包含页面的路由信息和显示窗口相关的配置。 194 195 **表3** pages标签说明 196 197| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 198| -------- | -------- | -------- | -------- | 199| src | 标识当前Module中所有页面的路由信息，包括页面路径和页面名称。其中，页面路径是以当前Module的src/main/ets为基准。该标签取值为一个字符串数组，其中每个元素表示一个页面。 | 字符串数组 | 该标签不可缺省。 | 200| window | 标识用于定义与显示窗口相关的配置。 | 对象 | 该标签可缺省，缺省值为空。 | 201 202 203 **表4** window标签说明 204 205| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 206| -------- | -------- | -------- | -------- | 207| designWidth | 标识页面设计基准宽度。以此为基准，根据实际设备宽度来缩放元素大小。 | 数值 | 可缺省，缺省值为720px。 | 208| autoDesignWidth | 标识页面设计基准宽度是否自动计算。当配置为true时，designWidth将会被忽略，设计基准宽度由设备宽度与屏幕密度计算得出。 | 布尔值 | 可缺省，缺省值为false。 | 209 210```json 211{ 212 "src": [ 213 "pages/index/mainPage", 214 "pages/second/payment", 215 "pages/third/shopping_cart", 216 "pages/four/owner" 217 ], 218 "window": { 219 "designWidth": 720, 220 "autoDesignWidth": false 221 } 222} 223``` 224 225 226## metadata标签 227 228该标签标识HAP的自定义元信息，标签值为数组类型，包含name、value、resource三个子标签。 229 230**表5** metadata标签说明 231 232| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 233| -------- | -------- | -------- | -------- | 234| name | 标识数据项的名称，取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 235| value | 标识数据项的值，取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 236| resource | 标识定义用户自定义数据格式，取值为长度不超过255字节的字符串，内容为标识该数据的资源索引。| 字符串 | 该标签可缺省，缺省值为空。 | 237 238metadata标签可配置主窗的默认大小和位置（单位为vp），name为ohos.ability.window.height表示主窗默认高度，name为ohos.ability.window.width表示主窗默认宽度，name为ohos.ability.window.left表示主窗默认左边的位置，其配置格式为(对齐方式)(+|-偏移量)，对齐方式包括center、left和right，默认值为left，偏移量为0时可以省略，name为ohos.ability.window.top表示主窗顶部的位置，对齐方式包括center、top和bottom，默认值为top，两者同时省略按照系统默认层叠规格。 239 240metadata标签可配置使能移除启动页功能，name为enable.remove.starting.window，value可配置为true/false，未配置则默认为false。 241 242resource属性值使用“\$profile:文件名”的方式指定文件所在位置，\$profile表示资源的路径为工程中的/resources/base/profile目录下。例如\$profile:shortcuts_config指定了/resources/base/profile/shortcuts_config.json配置文件。 243 244```json 245{ 246 "module": { 247 "metadata": [{ 248 "name": "module_metadata", 249 "value": "a test demo for module metadata", 250 "resource": "$profile:shortcuts_config" 251 }], 252 253 "abilities": [{ 254 "metadata": [{ 255 "name": "ability_metadata", 256 "value": "a test demo for ability", 257 "resource": "$profile:config_file" 258 }, 259 { 260 "name": "ability_metadata_2", 261 "value": "a string test", 262 "resource": "$profile:config_file" 263 }, 264 { 265 "name": "ohos.ability.window.height", 266 "value": "987" 267 }, 268 { 269 "name": "ohos.ability.window.width", 270 "value": "1300" 271 }, 272 { 273 "name": "ohos.ability.window.left", 274 "value": "right-50" 275 }, 276 { 277 "name": "ohos.ability.window.top", 278 "value": "center+50" 279 }, 280 { 281 "name": "enable.remove.starting.window", 282 "value": "true" 283 }], 284 }], 285 286 "extensionAbilities": [{ 287 "metadata": [{ 288 "name": "extensionAbility_metadata", 289 "value": "a test for extensionAbility", 290 "resource": "$profile:config_file" 291 }, 292 { 293 "name": "extensionAbility_metadata_2", 294 "value": "a string test", 295 "resource": "$profile:config_file" 296 }], 297 }] 298 } 299} 300``` 301 302 303## abilities标签 304 305abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 306 307 **表6** abilities标签说明 308 309| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 310| -------- | -------- | -------- | -------- | 311| name | 标识当前UIAbility组件的名称，确保该名称在整个应用中唯一。取值为长度不超过127字节的字符串，不支持中文。 | 字符串 | 该标签不可缺省。 | 312| srcEntry | 标识入口UIAbility的代码路径，取值为长度不超过127字节的字符串。 | 字符串 | 该标签不可缺省。 | 313| [launchType](../application-models/uiability-launch-type.md) | 标识当前UIAbility组件的启动模式，支持的取值如下：<br/>- multiton：多实例模式，每次启动创建一个新实例。<br/>- singleton：单实例模式，仅第一次启动创建新实例。<br/>- specified：指定实例模式，运行时由开发者决定是否创建新实例。<br/>- standard：multiton的曾用名，效果与多实例模式一致。 | 字符串 | 该标签可缺省，该标签缺省为“singleton”。 | 314| description | 标识当前UIAbility组件的描述信息，开发者可以通过该字段描述当前组件的功能与作用，取值为长度不超过255字节的字符串。要求采用描述信息的资源索引，以支持多语言。 | 字符串 | 该标签可缺省，缺省值为空。 | 315| icon | 标识当前UIAbility组件的[图标](../application-models/application-component-configuration-stage.md#生成机制)，取值为图标资源文件的索引。 | 字符串 | 该标签可缺省，缺省值为空。 | 316| label | 标识当前UIAbility组件对用户显示的[名称](../application-models/application-component-configuration-stage.md#生成机制)，要求采用该名称的资源索引，以支持多语言。取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 317| permissions | 标识当前UIAbility组件自定义的权限信息。当其他应用访问该UIAbility时，需要申请相应的权限信息。<br/>一个数组元素为一个权限名称。通常采用反向域名格式（不超过255字节），取值为系统预定义的权限。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 318| [metadata](#metadata标签) | 标识当前UIAbility组件的元信息。 | 对象数组 | 该标签可缺省，缺省值为空。 | 319| exported | 标识当前UIAbility组件是否可以被其他应用调用。<br/>- true：表示可以被其他应用调用。<br/>- false：表示不可以被其他应用调用，包括无法被aa工具命令拉起应用。 | 布尔值 | 该标签可缺省，缺省值为false。 | 320| continuable | 标识当前UIAbility组件是否支持跨端迁移。<br/>- true：表示支持迁移。<br/>- false：表示不支持迁移。 | 布尔值 | 该标签可缺省，缺省值为false。 | 321| [skills](#skills标签) | 标识当前UIAbility组件或ExtensionAbility组件能够接收的[Want](../application-models/want-overview.md)特征集，为数组格式。<br/>配置规则：<br/>- 对于Entry类型的HAP，应用可以配置多个具有入口能力的skills标签（即配置了ohos.want.action.home和entity.system.home）。<br/>- 对于Feature类型的HAP，只有应用可以配置具有入口能力的skills标签，服务不允许配置。 | 对象数组 | 该标签可缺省，缺省值为空。 | 322| backgroundModes | 标识当前UIAbility组件的长时任务集合，指定用于满足特定类型的长时任务。<br/>长时任务类型有如下：<br/>- dataTransfer：通过网络/对端设备进行数据下载、备份、分享、传输等。<br/>- audioPlayback：音频播放。<br/>- audioRecording：录音。<br/>- location：定位、导航。<br/>- bluetoothInteraction：蓝牙扫描、连接、传输（穿戴）。<br/>- multiDeviceConnection：多设备互联。<br/>- taskKeeping：计算。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 323| startWindowIcon | 标识当前UIAbility组件启动页面图标资源文件的索引，取值为长度不超过255字节的字符串。 | 字符串 | 该标签不可缺省。 | 324| startWindowBackground | 标识当前UIAbility组件启动页面背景颜色资源文件的索引，取值为长度不超过255字节的字符串。<br/>取值示例：$color:red。| 字符串 | 该标签不可缺省。 | 325| removeMissionAfterTerminate | 标识当前UIAbility组件销毁后，是否从任务列表中移除任务。<br/>- true表示销毁后移除任务。<br/>- false表示销毁后不移除任务。 | 布尔值 | 该标签可缺省，缺省值为false。 | 326| orientation | 标识当前UIAbility组件启动时的方向，支持配置枚举和启动方向资源索引。枚举支持的取值如下：<br/>- unspecified：未指定方向，由系统自动判断显示方向。<br/>- landscape：横屏。<br/>- portrait：竖屏。<br/>- follow_recent：跟随背景窗口的旋转模式。<br/>- landscape_inverted：反向横屏。<br/>- portrait_inverted：反向竖屏。<br/>- auto_rotation：随传感器旋转。<br/>- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。<br/>- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。<br/>- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。<br/>- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。<br/>- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。<br/>- locked：传感器开关关闭，方向锁定。<br/>- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。<br/>- follow_desktop：跟随桌面的旋转模式。<br/> 配置启动方向的资源索引时，取值为长度不超过255字节的字符串。<br/> 启动方向资源索引配置示例：$string:orientation。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | 327| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：<br/>- fullscreen：全屏模式。<br/>- split：分屏模式。<br/>- floating：悬浮窗模式。 | 字符串数组 | 该标签可缺省，缺省值为<br/>["fullscreen", "split", "floating"]。 | 328| <!--DelRow-->priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。<br/>**说明：**<br/>三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | 329| maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | 330| minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | 331| maxWindowWidth | 标识当前UIAbility组件支持的最大的窗口宽度，宽度单位为vp。<br/>最小取值为minWindowWidth，最大取值为平台支持的最大窗口宽度。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的窗口宽度。 | 332| minWindowWidth | 标识当前UIAbility组件支持的最小的窗口宽度， 宽度单位为vp。<br/>最小取值为平台支持的最小窗口宽度，最大取值为maxWindowWidth。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的窗口宽度。 | 333| maxWindowHeight | 标识当前UIAbility组件支持的最大的窗口高度， 高度单位为vp。<br/>最小取值为minWindowHeight，最大取值为平台支持的最大窗口高度。 窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。| 数值 | 该标签可缺省，缺省值为平台支持的最大的窗口高度。 | 334| minWindowHeight | 标识当前UIAbility组件支持的最小的窗口高度， 高度单位为vp。<br/>最小取值为平台支持的最小窗口高度，最大取值为maxWindowHeight。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。| 数值 | 该标签可缺省，缺省值为平台支持的最小的窗口高度。 | 335| <!--DelRow-->excludeFromMissions | 标识当前UIAbility组件是否在最近任务列表中显示。<br/>- true：表示不在任务列表中显示。<br/>- false：表示在任务列表中显示。<br/>**说明：**<br/>三方应用的配置不生效，当前配置仅在系统应用中有效，若要使系统应用配置生效，需申请应用特权AllowAbilityExcludeFromMissions，详见[应用特权配置指导](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。| 布尔值 | 该标签可缺省，缺省值为false。 | 336| recoverable | 标识当前UIAbility组件是否支持在检测到应用故障后，恢复到应用原界面。<br/>- true：支持检测到出现故障后，恢复到原界面。<br/>- false：不支持检测到出现故障后，恢复到原界面。 | 布尔值 | 该标签可缺省，缺省值为false。 | 337| <!--DelRow-->unclearableMission | 标识当前UIAbility组件是否支持从最近任务列表中移除。<br/>- true：表示在任务列表中不可移除。<br/>- false：表示在任务列表中可以移除。<br/>**说明：**<br/>三方应用的配置不生效，当前配置仅在系统应用中有效，若要使系统应用配置生效，需申请应用特权AllowMissionNotCleared，详见[应用特权配置指导](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 | 布尔值 | 该标签可缺省，缺省值为false。 | 338| isolationProcess | 标识组件能否运行在独立的进程中。<br/>- true：表示能运行在独立的进程中。<br/>- false：表示不能运行在独立的进程中。 | 布尔值 | 该标签可缺省，缺省值为false。 | 339| excludeFromDock | 标识当前UIAbility组件是否支持从dock区域隐藏图标。<br/>- true：表示在dock区域隐藏。<br/>- false：表示不能在dock区域隐藏。 | 布尔值 | 该标签可缺省，缺省值为false。 | 340| preferMultiWindowOrientation | 标识当前UIAbility组件多窗布局方向：<br/>- default：缺省值，参数不配置默认值，建议其他应用类配置。<br/>- portrait：多窗布局方向为竖向，建议竖向游戏类应用配置。<br/>- landscape：多窗布局方向为横向，配置后支持横屏悬浮窗和上下分屏，建议横向游戏类应用配置。<br/>- landscape_auto：多窗布局动态可变为横向，需要配合API enableLandScapeMultiWindow/disableLandScapeMultiWindow使用，建议视频类应用配置。 | 字符串 | 该标签可缺省，缺省值为default。 | 341| continueType | 标识当前UIAbility组件的跨端迁移类型。 | 字符串数组 | 该标签可缺省，缺省值为当前组件的名称。 | 342| continueBundleName | 标识当前应用支持跨端迁移的其它应用名称列表。<br/>**说明：**<br/>不能配置为本应用包名，仅为了做异包名迁移使用。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 343| process | 标识组件的进程标签。<br/>**说明：**<br/>仅在[2in1](./module-configuration-file.md#devicetypes标签)设备上生效，UIAbility组件和type为embeddedUI的ExtensionAbility组件标签一致时运行在同一个进程中。 | 字符串 | 该标签可缺省，缺省值为空。 | 344 345abilities示例： 346 347<!--RP3--> 348```json 349{ 350 "abilities": [{ 351 "name": "EntryAbility", 352 "srcEntry": "./ets/entryability/EntryAbility.ets", 353 "launchType":"singleton", 354 "description": "$string:description_main_ability", 355 "icon": "$media:layered_image", 356 "label": "Login", 357 "permissions": [], 358 "metadata": [], 359 "exported": true, 360 "continuable": true, 361 "skills": [{ 362 "actions": ["ohos.want.action.home"], 363 "entities": ["entity.system.home"], 364 "uris": [] 365 }], 366 "backgroundModes": [ 367 "dataTransfer", 368 "audioPlayback", 369 "audioRecording", 370 "location", 371 "bluetoothInteraction", 372 "multiDeviceConnection", 373 "wifiInteraction", 374 "voip", 375 "taskKeeping" 376 ], 377 "startWindowIcon": "$media:icon", 378 "startWindowBackground": "$color:red", 379 "removeMissionAfterTerminate": true, 380 "orientation": "$string:orientation", 381 "supportWindowMode": ["fullscreen", "split", "floating"], 382 "maxWindowRatio": 3.5, 383 "minWindowRatio": 0.5, 384 "maxWindowWidth": 2560, 385 "minWindowWidth": 1400, 386 "maxWindowHeight": 300, 387 "minWindowHeight": 200, 388 "excludeFromMissions": false, 389 "unclearableMission": false, 390 "excludeFromDock": false, 391 "preferMultiWindowOrientation": "default", 392 "isolationProcess": false, 393 "continueType": [ 394 "continueType1", 395 "continueType2" 396 ], 397 "continueBundleName": [ 398 "com.example.myapplication1", 399 "com.example.myapplication2" 400 ], 401 "process": ":processTag" 402 }] 403} 404``` 405<!--RP3End--> 406 407## skills标签 408 409该标签标识UIAbility组件或者ExtensionAbility组件能够接收的[Want](../application-models/want-overview.md)的特征。 410 411 **表7** skills标签说明 412 413| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 414| -------- | -------- | -------- | -------- | 415| actions | 标识能够接收的Action值集合，取值通常为系统预定义的action值，也允许自定义。<br>一个skill中不建议配置多个action，否则可能导致无法匹配预期场景。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 416| entities | 标识能够接收的Entity值的集合。<br>一个skill中不建议配置多个entity，否则可能导致无法匹配预期场景。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 417| uris | 标识与Want中URI（Uniform Resource Identifier）相匹配的集合。数组允许的最大数量为512。 | 对象数组 | 该标签可缺省，缺省值为空。 | 418| permissions | 标识当前UIAbility组件自定义的权限信息。当其他应用访问该UIAbility时，需要申请相应的权限信息。<br/>一个数组元素为一个权限名称。通常采用反向域名格式（不超过255字节），取值为系统预定义的权限。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 419| domainVerify | 标识是否开启域名校验。 | 布尔值 | 该标签可缺省，缺省值为false。 | 420 421 422 **表8** uris标签说明 423 424| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 425| -------- | -------- | -------- | -------- | 426| scheme | 标识URI的协议名部分，常见的有http、https、file、ftp等。 | 字符串 | uris中仅配置type时可以缺省，缺省值为空，否则不可缺省。 | 427| host | 标识URI的主机地址部分，该字段在scheme存在时才有意义。常见的方式：<br/>- 域名方式，如example.com。<br/>- IP地址方式，如10.10.10.1。 | 字符串 | 该标签可缺省，缺省值为空。 | 428| port | 标识URI的端口部分。如http默认端口为80，https默认端口是443，ftp默认端口是21。该字段在scheme和host都存在时才有意义。 | 字符串 | 该标签可缺省，缺省值为空。 | 429| path \| pathStartWith \| pathRegex | 标识URI的路径部分，path、pathStartWith和pathRegex配置时三选一。path标识URI与want中的路径部分全匹配，pathStartWith标识URI与want中的路径部分允许前缀匹配，pathRegex标识URI与want中的路径部分允许正则匹配。该字段在scheme和host都存在时才有意义。 | 字符串 | 该标签可缺省，缺省值为空。 | 430| type | 标识与Want相匹配的数据类型，使用MIME（Multipurpose Internet Mail Extensions）类型规范和[UniformDataType](../reference/apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型规范。可与scheme同时配置，也可以单独配置。 | 字符串 | 该标签可缺省，缺省值为空。 | 431| utd | 标识与Want相匹配的[标准化数据类型](../reference/apis-arkdata/js-apis-data-uniformTypeDescriptor.md)，适用于分享等场景。 | 字符串 | 该标签可缺省，缺省值为空。 | 432| maxFileSupported | 对于指定类型的文件，标识一次能接收或打开的最大数量，适用于分享等场景，需要与utd配合使用。| 整数 | 该标签可缺省，缺省值为0。| 433| linkFeature | 标识URI提供的功能类型（如文件打开、分享、导航等），用于实现应用间跳转。取值为长度不超过127字节的字符串，不支持中文。同一Bundle中声明的linkFeature数量不能超过150个。详情见[linkFeature标签说明](../application-models/app-uri-config.md#linkfeature标签说明)。 | 字符串 | 该标签可缺省，缺省值为空。| 434 435skills示例： 436 437 438```json 439{ 440 "abilities": [ 441 { 442 "skills": [ 443 { 444 "actions": [ 445 "ohos.want.action.home" 446 ], 447 "entities": [ 448 "entity.system.home" 449 ], 450 "uris": [ 451 { 452 "scheme":"http", 453 "host":"example.com", 454 "port":"80", 455 "path":"path", 456 "type": "text/*", 457 "linkFeature": "Login" 458 } 459 ], 460 "permissions": [], 461 "domainVerify": false 462 } 463 ] 464 } 465 ] 466} 467``` 468 469## extensionAbilities标签 470 471描述extensionAbilities的配置信息，标签值为数组类型，该标签下的配置只对当前extensionAbilities生效。 472 473 **表9** extensionAbilities标签说明 474 475| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 476| -------- | -------- | -------- | -------- | 477| name | 标识当前ExtensionAbility组件的名称，确保该名称在整个应用中唯一，取值为长度不超过127字节的字符串。 | 字符串 | 该标签不可缺省。 | 478| srcEntry | 标识当前ExtensionAbility组件所对应的代码路径，取值为长度不超过127字节的字符串。 | 字符串 | 该标签不可缺省。 | 479| description | 标识当前ExtensionAbility组件的描述，开发者可以通过该字段描述当前组件的功能与作用，取值为长度不超过255字节的字符串，可以是对描述内容的资源索引，用于支持多语言。 | 字符串 | 该标签可缺省，缺省值为空。 | 480| icon | 标识当前ExtensionAbility组件的图标，取值为资源文件的索引。如果ExtensionAbility组件被配置为MainElement，该标签必须配置。 | 字符串 | 该标签可缺省，缺省值为空。 | 481| label | 标识当前ExtensionAbility组件对用户显示的名称，取值为该名称的资源索引，以支持多语言，字符串长度不超过255字节。如果ExtensionAbility被配置当前Module的mainElement时，该标签必须配置，且要确保应用内唯一。 | 字符串 | 该标签可缺省，缺省值为空。 | 482| type | 标识当前ExtensionAbility组件的类型，支持的取值如下：<br/>- form：卡片的ExtensionAbility。<br/>- workScheduler：延时任务的ExtensionAbility。<br/>- inputMethod：输入法的ExtensionAbility。<!--Del--><br/>- service：后台运行的service组件。<!--DelEnd--><br/>- accessibility：辅助能力的ExtensionAbility。<!--Del--><br/>- fileAccess：公共数据访问的ExtensionAbility，允许应用程序提供文件和文件夹给文件管理类应用展示。<br/>- dataShare：数据共享的ExtensionAbility。<br/>- staticSubscriber：静态广播的ExtensionAbility。<!--DelEnd--><br/>- wallpaper：壁纸的ExtensionAbility。<br/>- backup：数据备份的ExtensionAbility。<!--Del--><br/>- window：该ExtensionAbility会在启动过程中创建一个window，为开发者提供界面开发。开发者开发出来的界面将通过UIExtensionComponent控件组合到其他应用的窗口中。<!--DelEnd--><br/>- thumbnail：获取文件缩略图的ExtensionAbility，开发者可以对自定义文件类型的文件提供缩略。<br/>- preview：该ExtensionAbility会将文件解析后在一个窗口中显示，开发者可以通过将此窗口组合到其他应用窗口中。<br/>- print：打印框架的ExtensionAbility。<br/>- push：推送的ExtensionAbility。<br/>- driver：驱动框架的ExtensionAbility。<br/>- remoteNotification：远程通知的ExtensionAbility。<br/>- remoteLocation：远程定位的ExtensionAbility。<br/>- voip：网络音视频通话的ExtensionAbility。<br/>- action：自定义操作业务模板的ExtensionAbility，为开发者提供基于UIExtension的自定义操作业务模板。<!--Del--><br/>- adsService：广告业务的ExtensionAbility，提供广告业务框架。<!--DelEnd--><br/>- embeddedUI：嵌入式UI扩展能力，提供跨进程界面嵌入的能力。<br/>- insightIntentUI：为开发者提供能被小艺意图调用，以窗口形态呈现内容的扩展能力。<br/>- ads：广告业务的ExtensionAbility，与AdComponent控件组合使用，将广告页面展示到其他应用中。仅支持设备厂商使用。<br/>- photoEditor：图片编辑业务的ExtensionAbility，为开发者提供基于UIExtension的图片编辑业务模版。<br/>- appAccountAuthorization：应用账号授权扩展能力的ExtensionAbility，用于处理账号授权请求，比如账号登录授权。<br/>- autoFill/password：用于账号和密码自动填充业务的ExtensionAbility，支持数据的保存、填充能力。<br/>- hms/account：应用账号管理能力的ExtensionAbility。<!--Del--><br/>- sysDialog/atomicServicePanel：提供构建原子化服务服务面板的基础能力的ExtensionAbility，使用时基于UIExtensionAbility实现。<br/>- sysDialog/userAuth：本地用户鉴权的ExtensionAbility。<br/>- sysDialog/common：通用弹窗的ExtensionAbility。<br/>- sysDialog/power：关机重启弹窗的ExtensionAbility。<br/>- sysDialog/print：打印模态弹窗的ExtensionAbility。<br/>- sysDialog/meetimeCall：畅连通话的ExtensionAbility。<br/>- sysDialog/meetimeContact：畅连联系人的ExtensionAbility。<br/>- sysPicker/meetimeMessage：畅连消息的ExtensionAbility。<br/>- sysPicker/meetimeContact：畅连联系人列表的ExtensionAbility。<br/>- sysPicker/meetimeCallLog：畅连通话记录列表的ExtensionAbility。<br/>- sysPicker/share：系统分享的ExtensionAbility。<br/>- sysPicker/mediaControl：投播组件的ExtensionAbility。<br/>- sysPicker/photoPicker：三方应用通过对应的UIExtensionType拉起图库picker界面。<br/>- sysPicker/filePicker：文件下载弹窗的ExtensionAbility。<br/>- sysPicker/audioPicker：音频管理弹窗的ExtensionAbility。<br/>- sysPicker/photoEditor：图片编辑弹窗的ExtensionAbility。<br/>- sys/commonUI：非通用的ExtensionAbility，提供业务属性强相关的嵌入式显示或弹框。<!--DelEnd--><br/>- autoFill/smart：用于情景化场景自动填充业务的ExtensionAbility，支持数据的保存、填充能力。<!--Del--><br/>- uiService：弹窗服务组件，在启动过程中会创建window，并支持双向通信。<!--DelEnd--><br/>- statusBarView：一步直达的ExtensionAbility。<br/>- recentPhoto：最近照片推荐的ExtensionAbility。<br/>- fence：地理围栏的ExtensionAbility。<br/>- callerInfoQuery：企业联系人查询的ExtensionAbility。<!--Del--><br/>**说明：**<br/>其中service、adsService、staticSubscriber、window、sys/commonUI、fileAccess、sysDialog类型、sysPicker类型、dataShare类型和uiService类型，三方应用的配置不生效，当前配置仅在系统应用中有效。<!--DelEnd--> | 字符串 | 该标签不可缺省。 | 483| permissions | 标识当前ExtensionAbility组件自定义的权限信息。当其他应用访问该ExtensionAbility时，需要申请相应的权限信息。<br/>一个数组元素为一个权限名称。通常采用反向域名格式（最大255字节），取值为[系统预定义的权限](../security/AccessToken/app-permissions.md)。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 484| readPermission | 标识读取当前ExtensionAbility组件数据所需的权限，取值为长度不超过255字节的字符串。仅当ExtensionAbility组件的type为dataShare时支持配置该标签。 | 字符串 | 该标签可缺省，缺省值为空。 | 485| writePermission | 标识向当前ExtensionAbility组件写数据所需的权限，取值为长度不超过255字节的字符串。仅当ExtensionAbility组件的type为dataShare时支持配置该标签。 | 字符串 | 该标签可缺省，缺省值为空。 | 486| uri | 标识当前ExtensionAbility组件提供的数据URI，取值为长度不超过255字节的字符数组，用反向域名的格式表示。<br/>**说明：**<br/>该标签在type为dataShare类型的ExtensionAbility时，不可缺省。 | 字符串 | 该标签可缺省，缺省值为空。 | 487|skills | 标识当前ExtensionAbility组件能够接收的[Want](../application-models/want-overview.md)的特征集。<br/>配置规则：entry包可以配置多个具有入口能力的skills标签（配置了ohos.want.action.home和entity.system.home）的ExtensionAbility，其中第一个配置了skills标签的ExtensionAbility中的label和icon作为服务或应用的label和icon。<br/>**说明：**<br/>服务的Feature包不能配置具有入口能力的skills标签。<br/>应用的Feature包可以配置具有入口能力的skills标签。 | 数组 | 该标签可缺省，缺省值为空。 | 488| [metadata](#metadata标签) | 标识当前ExtensionAbility组件的元信息。<br/>**说明：**<br/>该标签在type为form时，不可缺省，且必须存在一个name为ohos.extension.form的对象值，其对应的resource值不能缺省，为卡片的二级资源引用。 | 对象数组 | 该标签可缺省，缺省值为空。 | 489| exported | 标识当前ExtensionAbility组件是否可以被其他应用调用。<br/>- true：表示可以被其他应用调用。<br/>- false：表示不可以被其他应用调用，包括无法被aa工具命令拉起应用。 | 布尔值 | 该标签可缺省，缺省值为false。 | 490| extensionProcessMode | 标识当前ExtensionAbility组件的多进程实例模型,当前只对UIExtensionAbility以及从UIExtensionAbility扩展的ExtensionAbility生效。<br/>- instance：表示该ExtensionAbility每个实例一个进程。<br/>- type：表示该ExtensionAbility实例都运行在同一个进程里，与其他ExtensionAbility分离进程。<br/>- bundle：表示该ExtensionAbility实例都运行在应用统一进程里，与其他配置了bundle模型的ExtensionAbility共进程。<br>- runWithMainProcess：表示该ExtensionAbility和应用主进程共进程，只有一步直达的ExtensionAbility可以配置runWithMainProcess。 | 字符串 | 该标签可缺省，缺省值为空。 | 491| dataGroupIds | 标识当前ExtensionAbility组件的dataGroupId集合。如果当前ExtensionAbility组件所在的应用在应用市场申请的证书里groupIds也申请了某个dataGroupId，那么当前ExtensionAbility组件可以和应用共享这一个dataGroupId生成的目录，所以ExtensionAbility组件的dataGroupId需要是应用的证书中groupIds字段里配置的才能生效。 且该字段仅在当前ExtensionAbility组件存在独立的沙箱目录时生效。详见[dataGroupId申请流程](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ime-kit-security-V5#section4219152220459)。 | 字符串数组 | 该标签可缺省，缺省值为空。 | 492| process | 标识组件的进程标签，只有type为embeddedUI时可以配置该字段。<br/>**说明：**<br/>仅在[2in1](./module-configuration-file.md#devicetypes标签)设备上生效，UIAbility组件和ExtensionAbility组件标签一致时运行在同一个进程中。 | 字符串 | 该标签可缺省，缺省值为空。 | 493 494extensionAbilities示例： 495 496 497```json 498{ 499 "extensionAbilities": [ 500 { 501 "name": "FormName", 502 "srcEntry": "./form/MyForm.ts", 503 "icon": "$media:icon", 504 "label" : "$string:extension_name", 505 "description": "$string:form_description", 506 "type": "form", 507 "permissions": ["ohos.abilitydemo.permission.PROVIDER"], 508 "readPermission": "", 509 "writePermission": "", 510 "exported": true, 511 "uri":"scheme://authority/path/query", 512 "skills": [{ 513 "actions": [], 514 "entities": [], 515 "uris": [], 516 "permissions": [] 517 }], 518 "metadata": [ 519 { 520 "name": "ohos.extension.form", 521 "resource": "$profile:form_config", 522 } 523 ], 524 "extensionProcessMode": "instance", 525 "dataGroupIds": [ 526 "testGroupId1" 527 ] 528 } 529 ] 530} 531``` 532 533## shortcuts标签 534 535shortcuts标识应用的快捷方式信息。标签值为数组，包含四个子标签shortcutId、label、icon、wants。 536 537metadata中指定shortcut信息，其中： 538 539- name：指定shortcuts的名称，使用ohos.ability.shortcuts作为shortcuts信息的标识。 540 541- resource：指定shortcuts信息的资源位置。 542 543**表11** shortcuts标签说明 544 545| 属性名称 | 含义 | 类型 | 是否可缺省 | 546| -------- | -------- | -------- | -------- | 547| shortcutId | 标识快捷方式的ID，取值为长度不超过63字节的字符串。**不推荐通过资源索引的方式（$string）配置该字段。** | 字符串 | 该标签不可缺省。 | 548| label | 标识快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值为长度不超过255字节的字符串，可以是描述性内容，也可以是标识label的资源索引。 | 字符串 | 该标签可缺省，缺省值为空。 | 549| icon | 标识快捷方式的图标，取值为资源文件的索引。 | 字符串 | 该标签可缺省，缺省值为空。 | 550| [wants](#wants标签) | 标识快捷方式内定义的目标wants信息集合，在调用launcherBundleManager的startShortcut接口时，会拉起wants标签里的第一个目标组件，推荐只配置一个wants元素。 | 对象 | 该标签可缺省，缺省为空。 | 551 552 5531. 在/resources/base/profile/目录下配置shortcuts_config.json配置文件。 554 555 ```json 556 { 557 "shortcuts": [ 558 { 559 "shortcutId": "id_test1", 560 "label": "$string:shortcut", 561 "icon": "$media:aa_icon", 562 "wants": [ 563 { 564 "bundleName": "com.ohos.hello", 565 "moduleName": "entry", 566 "abilityName": "EntryAbility", 567 "parameters": { 568 "testKey": "testValue" 569 } 570 } 571 ] 572 } 573 ] 574 } 575 ``` 576 5772. 在module.json5配置文件的abilities标签中，针对需要添加快捷方式的UIAbility进行配置metadata标签，使shortcut配置文件对该UIAbility生效。 578 579 ```json 580 { 581 "module": { 582 // ... 583 "abilities": [ 584 { 585 "name": "EntryAbility", 586 "srcEntry": "./ets/entryability/EntryAbility.ets", 587 // ... 588 "skills": [ 589 { 590 "entities": [ 591 "entity.system.home" 592 ], 593 "actions": [ 594 "ohos.want.action.home" 595 ] 596 } 597 ], 598 "metadata": [ 599 { 600 "name": "ohos.ability.shortcuts", 601 "resource": "$profile:shortcuts_config" 602 } 603 ] 604 } 605 ] 606 } 607 } 608 ``` 609### wants标签 610 611此标签用于标识快捷方式内定义的目标wants信息集合。 612 613**表11-1** wants标签说明 614 615| 属性名称 | 含义 | 类型 | 是否可缺省 | 616| -------- | -------- | -------- | -------- | 617| bundleName | 表示快捷方式的目标包名。 | 字符串 | 该标签不可缺省。 | 618| moduleName | 表示快捷方式的目标模块名。 | 字符串 | 该标签可缺省。 | 619| abilityName| 表示快捷方式的目标组件名。 | 字符串 | 该标签不可缺省。 | 620| parameters | 表示拉起快捷方式时的自定义数据，仅支持配置字符串类型的数据。其中键值均最大支持1024长度的字符串。 | 对象 | 该标签可缺省。 | 621 622data标签示例： 623 624```json 625{ 626 "wants": [ 627 { 628 "bundleName": "com.ohos.hello", 629 "moduleName": "entry", 630 "abilityName": "EntryAbility", 631 "parameters": { 632 "testKey": "testValue" 633 } 634 } 635 ] 636} 637``` 638 639## distributionFilter标签 640 641该标签用于定义HAP对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。 642 643> **说明：** 644> 该标签从API10及以后版本开始生效，API9及以前版本使用distroFilter标签。 645 646- **适用场景：** 当一个工程中存在多个Entry，且多个Entry配置的deviceTypes存在交集时，则需要通过该标签进行区分。比如下面的两个Entry都支持tablet类型，就需要通过该标签进行区分。 647 ```json 648 // entry1支持的设备类型 649 { 650 "module": { 651 "name": "entry1", 652 "type": "entry", 653 "deviceTypes" : [ 654 "tv", 655 "tablet" 656 ] 657 } 658 } 659 ``` 660 ```json 661 // entry2支持的设备类型 662 { 663 "module": { 664 "name": "entry2", 665 "type": "entry", 666 "deviceTypes" : [ 667 "car", 668 "tablet" 669 ] 670 } 671 } 672 ``` 673 674- **配置规则：** 该标签支持配置四个属性，包括屏幕形状([screenShape](#screenshape标签))、窗口分辨率([screenWindow](#screenwindow标签))、屏幕像素密度([screenDensity](#screendensity标签) )、设备所在国家与地区([countryCode](#countrycode标签))，详见下表。 675 676 在分发应用包时，通过deviceTypes与这四个属性的匹配关系，唯一确定一个用于分发到设备的HAP。 677 678 * 如果需要配置该标签，则至少包含一个属性。 679 * 如果一个Entry中配置了任意一个或多个属性，则其他Entry也必须包含相同的属性。 680 * screenShape和screenWindow属性仅用于轻量级智能穿戴设备。 681 682- **配置方式：** 该标签需要配置在/resources/base/profile资源目录下，并在metadata的resource字段中引用。 683 684 685**表12** distributionFilter标签配置说明 686 687| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 688| -------- | -------- | -------- | -------- | 689| [screenShape](#screenshape标签) | 标识屏幕形状的支持策略。 | 对象数组 | 该标签可缺省，缺省值为空。 | 690| [screenWindow](#screenwindow标签) | 标识应用运行时的窗口分辨率的支持策略。| 对象数组 | 该标签可缺省，缺省值为空。 | 691| [screenDensity](#screendensity标签) | 标识屏幕的像素密度（dpi：Dot Per Inch）的支持策略。 | 对象数组 | 该标签可缺省，缺省值为空。 | 692| [countryCode](#countrycode标签) | 标识国家与地区的支持策略，取值参考ISO-3166-1标准。支持多个国家和地区枚举定义。 | 对象数组 | 该标签可缺省，缺省值为空。 | 693 694### screenShape标签 695 696**表13** screenShape标签说明 697 698| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 699| -------- | -------- | -------- | -------- | 700| policy | 标识条件属性的过滤规则。<br/>- exclude：表示需要排除的value属性。<br/>- include：表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 | 701| value | 支持的取值为circle（圆形）、rect（矩形）。例如，针对智能穿戴设备，可为圆形表盘和矩形表盘分别提供不同的HAP。 | 字符串数组 | 该标签不可缺省。 | 702 703### screenWindow标签 704 705**表14** screenWindow标签说明 706 707| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 708| -------- | -------- | -------- | -------- | 709| policy | 标识条件属性的过滤规则。当前取值仅支持“include”。<br/>- include：表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 | 710| value | 单个字符串的取值格式为“宽 \* 高”，取值为整数像素值，例如“454 \* 454”。 | 字符串数组 | 该标签不可缺省。 | 711 712### screenDensity标签 713 714**表15** screenDensity标签说明 715 716| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 717| -------- | -------- | -------- | -------- | 718| policy | 标识条件属性的过滤规则。<br/>- exclude：表示需要排除的value属性。<br/>- include：表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 | 719| value | 标识屏幕的像素密度（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]的设备。 | 字符串数组 | 该标签不可缺省。 | 720 721### countryCode标签 722 723**表16** countryCode标签说明 724 725| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 726| -------- | -------- | -------- | -------- | 727| policy | 标识条件属性的过滤规则。<br/>- exclude：表示需要排除的value属性。<br/>- include：表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 | 728| value | 标识应用需要分发的国家地区码。 | 字符串数组 | 该标签不可缺省。 | 729 730 731示例如下： 732 7331. 在开发视图的resources/base/profile下面定义配置文件distributionFilter_config.json，文件名可以自定义。 734 ```json 735 { 736 "distributionFilter": { 737 "screenShape": { 738 "policy": "include", 739 "value": [ 740 "circle", 741 "rect" 742 ] 743 }, 744 "screenWindow": { 745 "policy": "include", 746 "value": [ 747 "454*454", 748 "466*466" 749 ] 750 }, 751 "screenDensity": { 752 "policy": "exclude", 753 "value": [ 754 "ldpi", 755 "xldpi" 756 ] 757 }, 758 "countryCode": { // 支持在中国分发 759 "policy": "include", 760 "value": [ 761 "CN" 762 ] 763 } 764 } 765 } 766 ``` 767 768 7692. 在module.json5配置文件的module标签中定义metadata信息。 770 771 772 ```json 773 { 774 "module": { 775 // ... 776 "metadata": [ 777 { 778 "name": "ohos.module.distribution", 779 "resource": "$profile:distributionFilter_config", 780 } 781 ] 782 } 783 } 784 ``` 785 786 787## testRunner标签 788 789此标签用于支持对测试框架的配置。 790 791**表17** testRunner标签说明 792 793| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 794| -------- | -------- | -------- | -------- | 795| name | 标识测试框架对象名称，取值为长度不超过255字节的字符串。 | 字符串 | 不可缺省。 | 796| srcPath | 标识测试框架代码路径，取值为长度不超过255字节的字符串。 | 字符串 | 不可缺省。 | 797 798testRunner标签示例： 799 800 801```json 802{ 803 "module": { 804 // ... 805 "testRunner": { 806 "name": "myTestRunnerName", 807 "srcPath": "etc/test/TestRunner.ts" 808 } 809 } 810} 811``` 812 813## atomicService标签 814 815此标签用于支持对原子化服务的配置。此标签仅在app.json中bundleType指定为atomicService时使能。 816 817**表18** atomicService标签说明 818 819| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 820| -------- | -------- | -------- | -------- | 821| preloads | 标识原子化服务中预加载列表。 | 对象数组 | 该标签可缺省，缺省值为空。 | 822 823 824**表19** preloads标签说明 825 826| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 827| -------- | -------- | -------- | -------- | 828| moduleName | 标识原子化服务中当前模块被加载时，需预加载的模块名。不能配置自身modulename，且必须有对应的模块，取值为长度不超过31字节的字符串。 | 字符串 | 该标签不可缺省。 | 829 830 831atomicService标签示例： 832 833```json 834{ 835 "module": { 836 "atomicService": { 837 "preloads":[ 838 { 839 "moduleName":"feature" 840 } 841 ] 842 } 843 } 844} 845``` 846 847## dependencies标签 848 849此标签标识模块运行时依赖的共享库列表。 850 851**表20** dependencies标签说明 852 853| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 854| ----------- | ------------------------------ | -------- | ---------- | 855| bundleName | 标识当前模块依赖的共享包包名。取值为长度7~128字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 856| moduleName | 标识当前模块依赖的共享包模块名。取值为长度不超过31字节的字符串。 | 字符串 | 该标签不可缺省。 | 857| versionCode | 标识当前共享包的版本号。取值范围为0~2147483647。 | 数值 | 该标签可缺省，缺省值为空。 | 858 859dependencies标签示例： 860 861```json 862{ 863 "module": { 864 "dependencies": [ 865 { 866 "bundleName":"com.share.library", 867 "moduleName": "library", 868 "versionCode": 10001 869 } 870 ] 871 } 872} 873``` 874 875## proxyData标签 876 877此标签标识模块提供的数据代理列表，仅限entry和feature配置。 878 879**表21** proxyData标签说明 880| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 881| ----------- | ------------------------------ | -------- | ---------- | 882| uri | 标识用于访问该数据代理的URI，不同的数据代理配置的URI不可重复，且需要满足`datashareproxy://当前应用包名/xxx`的格式。取值为长度不超过255字节的字符串。 | 字符串 | 该标签不可缺省。 | 883| requiredReadPermission | 标识从该数据代理中读取数据所需要的权限，若不配置，则其他应用无法使用该代理。非系统应用配置的权限的等级需为system_basic或system_core，系统应用配置的权限的等级没有限制。权限等级可以参考[权限列表](../security/AccessToken/app-permissions.md)。取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 884| requiredWritePermission | 标识向该数据代理中写入数据所需要的权限，若不配置，则其他应用无法使用该代理。非系统应用配置的权限的等级需为system_basic或system_core，系统应用配置的权限的等级没有限制。权限等级可以参考[权限列表](../security/AccessToken/app-permissions.md)。取值为长度不超过255字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 885| [metadata](#metadata标签) | 标识该数据代理的元信息，只支持配置name和resource字段。 | 对象 | 该标签可缺省，缺省值为空。 | 886 887proxyData标签示例： 888 889```json 890{ 891 "module": { 892 "proxyData": [ 893 { 894 "uri":"datashareproxy://com.ohos.datashare/event/Meeting", 895 "requiredReadPermission": "ohos.permission.GET_BUNDLE_INFO", 896 "requiredWritePermission": "ohos.permission.GET_BUNDLE_INFO", 897 "metadata": { 898 "name": "datashare_metadata", 899 "resource": "$profile:datashare" 900 } 901 } 902 ] 903 } 904} 905``` 906 907## routerMap标签 908 909此标签标识模块配置的路由表的路径。 910 911routerMap配置文件描述模块的路由表信息，routerMap标签值为数组类型。 912 913**表22** routerMap标签说明 914 915| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 916| -------- | -------- | -------- | -------- | 917| name | 标识跳转页面的名称。取值为长度不超过1023字节的字符串。 | 字符串 | 该标签不可缺省。 | 918| pageSourceFile| 标识页面在模块内的路径。取值为长度不超过255字节的字符串。 | 字符串 | 该标签不可缺省。 | 919| buildFunction | 标识被@Builder修饰的函数，该函数描述页面的UI。取值为长度不超过1023字节的字符串。 | 字符串 | 该标签不可缺省。 | 920| [data](#data标签) | 标识字符串类型的自定义数据。 每个自定义数据字符串取值不超过128字节。 | 对象 | 该标签可缺省，缺省值为空。 | 921| [customData](#customdata标签) | 标识任意类型的自定义数据，总长度不超过4096字节。 | 对象 | 该标签可缺省，缺省值为空。 | 922 923示例如下： 924 9251. 在开发视图的resources/base/profile下面定义配置文件，文件名可以自定义，例如：router_map.json。 926 927 ```json 928 { 929 "routerMap": [ 930 { 931 "name": "DynamicPage1", 932 "pageSourceFile": "src/main/ets/pages/pageOne.ets", 933 "buildFunction": "myFunction", 934 "customData": { 935 "stringKey": "data1", 936 "numberKey": 123, 937 "booleanKey": true, 938 "objectKey": { 939 "name": "test" 940 }, 941 "arrayKey": [ 942 { 943 "id": 123 944 } 945 ] 946 } 947 }, 948 { 949 "name": "DynamicPage2", 950 "pageSourceFile": "src/main/ets/pages/pageTwo.ets", 951 "buildFunction": "myBuilder", 952 "data": { 953 "key1": "data1", 954 "key2": "data2" 955 } 956 } 957 ] 958 } 959 ``` 960 9612. 在module.json5配置文件的module标签中定义`routerMap`字段，指向定义的路由表配置文件，例如：`"routerMap": "$profile:router_map"`。 962 963### data标签 964 965此标签用于支持在路由表中配置自定义的字符串数据。 966 967data标签示例： 968 969```json 970{ 971 "routerMap": [ 972 { 973 "name": "DynamicPage", 974 "pageSourceFile": "src/main/ets/pages/pageOne.ets", 975 "buildFunction": "myBuilder", 976 "data": { 977 "key1": "data1", 978 "key2": "data2" 979 } 980 } 981 ] 982} 983``` 984 985### customData标签 986 987此标签用于支持在路由表中配置自定义数据。 988customData对象内部，可以填入任意类型的自定义数据。 989 990customData标签示例： 991 992```json 993{ 994 "routerMap": [ 995 { 996 "name": "DynamicPage", 997 "pageSourceFile": "src/main/ets/pages/pageOne.ets", 998 "buildFunction": "myBuilder", 999 "customData": { 1000 "stringKey": "data1", 1001 "numberKey": 123, 1002 "booleanKey": true, 1003 "objectKey": { 1004 "name": "test" 1005 }, 1006 "arrayKey": [ 1007 { 1008 "id": 123 1009 } 1010 ] 1011 } 1012 } 1013 ] 1014} 1015``` 1016 1017## appEnvironments标签 1018 1019此标签标识模块配置的应用环境变量。 1020 1021**表23** appEnvironments标签说明 1022 1023| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 1024| -------- | -------- | -------- | -------- | 1025| name | 标识环境变量的变量名称。取值为长度不超过4096字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 1026| value | 标识环境变量的值。取值为长度不超过4096字节的字符串。 | 字符串 | 该标签可缺省，缺省值为空。 | 1027 1028appEnvironments标签示例： 1029 1030```json 1031{ 1032 "module": { 1033 "appEnvironments": [ 1034 { 1035 "name":"name1", 1036 "value": "value1" 1037 } 1038 ] 1039 } 1040} 1041``` 1042 1043## definePermissions标签 1044 1045该标签仅支持系统资源hap定义权限，不支持应用自定义权限。权限定义方式参见[系统资源权限定义](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)。 1046 1047**表24** definePermissions标签说明 1048 1049| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 1050| -------- | -------- | -------- | -------- | 1051| name | 标识权限的名称，该标签最大长度为255字节。 | 字符串 | 不可缺省。 | 1052| grantMode | 标识权限的授予方式，支持如下两种授予模式如下：<br/>- system_grant：安装后系统自动授予该权限。<br/>- user_grant：使用时动态申请，用户授权后才可使用。 | 字符串 | 可缺省，缺省值为system_grant。 | 1053| availableLevel | 标识权限限制类别，可选值如下：<br/>- system_core：系统核心权限。<br/>- system_basic：系统基础权限。<br/>- normal：普通权限。所有应用允许申请的权限。 | 字符串 | 可缺省，缺省值为normal。 | 1054| provisionEnable | 标识权限是否支持证书方式申请权限，包括高级别的权限。配置为true标识开发者可以通过provision方式申请权限。 | 布尔值 | 可缺省，缺省值为true。 | 1055| distributedSceneEnabled | 标识权限是否支持分布式场景下使用该权限。 | 布尔值 | 可缺省，缺省值为false。 | 1056| label | 标识权限的简短描述，配置为对描述内容的资源索引。 | 字符串 | 可缺省，缺省值为空。 | 1057| description | 标识权限的详细描述，可以是字符串，或者是对描述内容的资源索引。 | 字符串 | 可缺省，缺省值为空。 | 1058 1059definePermissions标签示例： 1060 1061```json 1062{ 1063 "module" : { 1064 "definePermissions": [ 1065 { 1066 "name": "ohos.abilitydemo.permission.PROVIDER", 1067 "grantMode": "system_grant", 1068 "availableLevel": "system_core", 1069 "provisionEnable": true, 1070 "distributedSceneEnable": false, 1071 "label": "$string:EntryAbility_label" 1072 } 1073 ] 1074 } 1075} 1076``` 1077 1078## hnpPackages标签 1079 1080该标签标识应用包含的Native软件包信息。 1081 1082**表25** hnpPackages标签说明 1083 1084| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 1085| -------- | -------- | -------- | -------- | 1086| package | 标识Native软件包名称。 | 字符串 | 该标签不可缺省。 | 1087| type | 标识Native软件包类型。支持的取值如下：<br/>- public：公有类型。<br/>- private：私有类型。 | 字符串 | 该标签不可缺省。 | 1088 1089hnpPackages示例： 1090 1091 1092```json 1093{ 1094 "module" : { 1095 "hnpPackages": [ 1096 { 1097 "package": "hnpsample.hnp", 1098 "type": "public" 1099 } 1100 ] 1101 } 1102} 1103``` 1104 1105## fileContextMenu标签 1106 1107该标签用来标识当前HAP的右键菜单配置项，是一个profile文件资源，用于指定描述应用注册右键菜单配置文件。 1108 1109fileContextMenu标签示例 1110 1111```json 1112{ 1113 "module": { 1114 // ... 1115 "fileContextMenu": "$profile:menu" // 通过profile下的资源文件配置 1116 } 1117} 1118``` 1119 1120在开发视图的resources/base/profile下面定义配置文件menu.json，其中文件名“menu.json”可自定义，需要和fileContextMenu标签指定的信息对应。配置文件中描述了当前应用注册的右键菜单的项目和响应行为。 1121配置文件根节点名称为fileContextMenu，为对象数组，标识当前module注册右键菜单的数量。（单模块和单应用注册数量不能超过5个，配置超过数量当前只解析随机5个） 1122 1123**表26** fileContextMenu标签配置说明 1124 1125| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 1126| -------- | -------- | -------- | -------- | 1127| abilityName | 表示当前右键菜单对应的需要拉起的ability名称。 | 字符串 | 不可缺省 | 1128| menuItem | 右键菜单显示的信息。 | 资源id | 不可缺省 | 1129| menuHandler | 一个ability可以创建多个右键菜单， 用该字段来区分用户拉起的不同右键菜单项。该字段在用户点击右键菜单执行时，会作为参数传递给右键菜单应用。 | 字符串 | 不可缺省 | 1130| menuContext | 定义展示该菜单项需要的上下文，可以支持多种情况，类型为数组。 | 对象数组 | 不可缺省 | 1131 1132**表27** menuContext标签配置说明 1133 1134| 属性名称 | 含义 | 数据类型 | 是否可缺省 | 1135| -------- | -------- | -------- | -------- | 1136| menuKind | 表示单击如下类型时会触发右键菜单。取值范围如下：<br/>- 0：空白处<br/>- 1：文件<br/>- 2：文件夹<br/>- 3：文件和文件夹 | 数值 | 不可缺省 | 1137| menuRule | 表示采用什么方式选择文件或文件夹时，会触发右键菜单。取值范围如下：<br/>- single：单选<br/>- multi：多选<br/>- both：单选或多选 | 字符串 | 仅当menuKind为1或2时，才会读取该字段，此时不可缺省。 | 1138| fileSupportType | 表示当选中的文件列表里包含指定的文件类型时，显示右键菜单。<br/>当该字段取值为["*"]时，将会读取fileNotSupportType字段。<br/>当该字段取值为[]时，将不做任何处理。 | 字符串数组 | 仅当menuKind为1时，才会读取该字段，此时不可缺省。 | 1139| fileNotSupportType | 表示当选中的文件列表里包含这些文件类型时，不显示该右键菜单。<br/>仅当menuKind为1、且fileSupportType为["*"]时，才会读取该字段。 | 字符串数组 | 可缺省，缺省值为空。 | 1140 1141resources/base/profile路径下的menu.json资源文件示例如下： 1142```json 1143{ 1144 "fileContextMenu": [ 1145 { 1146 "abilityName": "EntryAbility", 1147 "menuItem": "$string:module_desc", 1148 "menuHandler": "openCompress", 1149 "menuContext": [ 1150 { 1151 "menuKind": 0 1152 }, 1153 { 1154 "menuKind": 1, 1155 "menuRule": "both", 1156 "fileSupportType": [ 1157 ".rar", 1158 ".zip" 1159 ], 1160 "fileNotSupportType": [ 1161 "" 1162 ] 1163 }, 1164 { 1165 "menuKind": 2, 1166 "menuRule": "single" 1167 }, 1168 { 1169 "menuKind": 3 1170 } 1171 ] 1172 } 1173 ] 1174} 1175``` 1176 1177**响应行为** 1178 1179应用进行右键扩展菜单注册后，在文件管理器通过右键操作拉起菜单，该菜单中会有“更多”选项。点击“更多”选项后，会出现注册后的menuItem列表，点击任意一个选项后，文件管理器默认通过startAbility的方式拉起三方应用，除了指定三方应用的包名和ability名之外，want中的parameter中，也会传入如下字段： 1180 1181**表28** want中parameter字段说明 1182 1183| 参数名 | 值 | 类型 | 1184| -------- | -------- | -------- | 1185| menuHandler | 对应注册配置文件中menuHandler的值。 | 字符串 | 1186| uriList | 用户在具体文件上触发右键的uri值，如果空白处响应，此值为空，单个文件响应，数组长度1，多个文件响应则传入对应所有文件的uri值。 | 字符串数组 |