HarmonyOS-鸿蒙app开发 —HarmonyOS 3.1_Stage模型应用组件_应用/组件级配置

HarmonyOS-鸿蒙app开发 —HarmonyOS 3.1_Stage模型应用组件_应用/组件级配置

开发者在开发应用时,需要配置应用的一些标签,例如应用的包名、图标等标识特征的属性。这一章节描述了开发者在开发应用需要配置的一些关键标签。图标和标签通常一起配置,可以分为应用图标、应用标签和入口图标、入口标签,分别对应app.json5module.json5文件中的icon和label标签。应用图标和标签是在设置应用中使用,例如设置应用中的应用列表。入口图标是应用安装完成后在设备桌面上显示出来的,如下图所示。入口图标是以Ability为粒度,支持同一个应用存在多个入口图标和标签,点击后进入对应的Ability界面。

图1 应用图标和标签

应用包名配置

应用需要在工程的AppScope目录下的app.json5中配置bundleName标签,该标签用于标识应用的唯一性。推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。具体配置规则可以参考app.json5文件配置标签说明

应用图标和标签配置

应用图标需要在工程的AppScope目录下的app.json5中配置icon标签。应用图标需配置为图片的资源索引,配置完成后,该图片即为应用的图标。应用图标通常用于显示在应用列表中,例如设置中的应用列表。具体配置及说明可以参考app.json5文件配置标签说明

应用标签需要在工程的AppScope模块下的app.json5中配置label标签。标识Ability对用户显示的名称,需要配置为字符串资源的索引,具体配置规则可以参考app.json5文件配置标签说明

Stage模型的应用支持单独配置应用图标和标签,在app.json5中配置。应用图标和标签是在设置应用中使用,例如设置应用中的应用列表,会显示出对应的图标和标签。在app字段下面分别有icon和label字段,根据对应的规则进行配置。

{

“app”: {

“icon”: “$media:app_icon”,

“label”: “$string:app_name”

// …

}

}

入口图标和标签配置

应用需要在工程的AppScope目录下的app.json5中配置label标签。标识Ability对用户显示的名称,需要配置为字符串资源的索引,具体配置规则可以参考app.json5文件配置标签说明

入口图标和标签需要在module.json5中配置,在abilities字段下面分别有icon和label字段,根据对应的规则进行配置。如果希望在桌面上显示该Ability的图标和标签,则需要在skills字段下面的entities中添加”entity.system.home”、actions中添加”action.system.home”。同一个应用有多个Ability配置上述字段时,桌面上会显示出多个图标和标签,分别对应各自的Ability。

{

“module”: {

// …

“abilities”: [

{

// …

“icon”: “$media:icon”,

“label”: “$string:EntryAbility_label”,

“skills”: [

{

“entities”: [

“entity.system.home”

],

“actions”: [

“action.system.home”

]

}

],

}

]

}

}

应用版本声明配置

应用版本声明需要在工程的AppScope目录下的app.json5中配置versionCode标签和versionName标签。versionCode用于标识应用的版本号,该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。versionName标签标识版本号的文字描述。具体配置规则可以参考app.json5文件配置标签说明

Module支持的设备类型配置

Module支持的设备类型需要在module.json5配置文件中配置deviceTypes标签,如果deviceTypes标签中添加了某种设备,则表明当前的Module支持在该设备上运行。具体的deviceTypes配置规则可以参考deviceTypes标签

Module权限配置

Module访问系统或其他应用受保护部分所需的权限信息需要在module.json5文件中配置requestPermissions标签。该标签用于声明需要申请权限的名称、申请权限的原因以及权限使用的场景。具体的配置规则可以参考requestPermissions标签说明

0 0 投票数
文章评分
订阅评论
提醒
0 评论
内联反馈
查看所有评论
0
希望看到您的想法,请您发表评论x