鸿蒙应用开发实战（二）：配置文件

配置文件包括应用级配置信息和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建议配置为truefalse:只能由同应用或者具有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组件的元信息。......