鸿蒙应用开发实战(二):配置文件
配置文件,包括应用级配置信息和Module级配置信息。
应用级配置信息:
- AppScope > app.json5,用于声明应用的全局配置信息,比如应用Bundle名称、应用名称、应用图标、应用版本号等。
- bundleName:标识应用的Bundle名称,用于标识应用的唯一性。
- vendor:标识对应用开发厂商的描述,取值为长度不超过255字节的字符串。该标签可用于展示开发厂商信息,如在应用的关于页面,取该标签展示开发厂商信息。
- versionCode:标识应用的版本号,取值范围为0~2147483647。此数字仅用于确定某个版本是否比另一个版本新,数值越大表示版本越新。
- versionName:标识向用户展示的应用版本号。
- buildVersion:标识应用的构建版本号。
- icon:标识应用的图标,取值为图标资源文件的索引。
- label:标识应用的名称,取值为字符串资源的索引。
- ......
Module级配置信息:
- name:标识当前Module的名称,确保该名称在整个应用中唯一。
- type:标识当前Module的类型。支持的取值如下:- entry: 应用的主模块;- feature: 应用的动态特性模块;- har: 静态共享包模块;- shared: 动态共享包模块;- skill: 技能包模块,用于定义AI代理的技能能力。该类型模块必须配置skillProfiles标签。仅当应用的bundleType配置为skill,即app.json5配置文件中的bundleType为skill时,才允许将Module的type配置为skill,且此时应用只能包含1个Module。从API版本26.0.0开始,支持该标签。该标签仅对预置应用生效。
- description:标识当前Module的描述信息,可以采用字符串资源索引格式。
- mainElement:标识当前Module的入口UIAbility名称
- deviceTypes:标识当前Module可以运行在哪类设备上。
- deliveryWithInstall:标识当前Module是否在用户主动安装的时候安装,即该Module对应的HAP/HSP是否跟随应用一起安装。
- installationFree:标识当前Module是否支持免安装特性。
- pages:标识当前Module的profile资源,用于列举每个页面信息,取值为长度不超过255字节的字符串。
- abilities:标识当前Module中UIAbility的配置信息,只对当前UIAbility生效。
- ---name:标识当前UIAbility组件的名称,确保该名称在整个应用中唯一。
- ---srcEntry:标识当前UIAbility的代码路径。
- ---description:标识当前UIAbility组件的描述信息,开发者可以通过该标签描述当前组件的功能与作用
- ---icon:标识当前UIAbility组件的图标,取值为图标资源文件的索引。
- ---label:标识当前UIAbility组件的对用户显示的名称,取值为字符串资源的索引,以支持多语言,长度不超过255字节的字符串。
- ---startWindowIcon:标识当前UIAbility组件启动页面图标资源文件的索引。
- ---startWindowBackground:标识当前UIAbility组件启动页面背景颜色资源文件的索引。
- ---exported:标识当前UIAbility组件是否可以被其他应用拉起。true:表示可以被其他应用拉起(入口UIAbility建议配置为true);false:
只能由同应用或者具有ohos.permission.START_INVISIBLE_ABILITY权限(该权限仅系统应用支持申请)的应用拉起。例如,配置为false时,桌面具备该权限,桌面图标、快捷方式或push通知消息可以拉起当前UIAbility组件,但aa命令行工具没有权限无法拉起。
-
---skills:标识当前UIAbility组件能够接收的Want特征集,为数组格式。配置规则:- 对于Entry类型的HAP,应用可以配置多个具有入口能力的skills标签(即配置了ohos.want.action.home和entity.system.home)。- 对于Feature类型的HAP,只有应用可以配置具有入口能力的skills标签,服务不允许配置。
-
extensionAbilities:标识当前Module中ExtensionAbility的配置信息,只对当前ExtensionAbility生效。
-
---name:标识当前ExtensionAbility组件的名称,确保该名称在整个应用中唯一。
-
---srcEntry:标识当前ExtensionAbility组件所对应的代码路径。
-
---type:标识当前ExtensionAbility组件的类型。
-
---exported:标识当前ExtensionAbility组件是否可以被其他应用调用。
-
---metadata:标识当前ExtensionAbility组件的元信息。
-
......
更多推荐


所有评论(0)