配置文件,包括应用级配置信息和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组件的元信息。

  • ......

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐