鸿蒙HarmonyOS应用开发——组件级配置

2401_84164527

已于 2024-04-12 19:09:34 修改

阅读量421

点赞数 5

分类专栏： 2024年程序员学习文章标签： harmonyos 华为

于 2024-04-12 19:09:32 首次发布

本文链接：https://blog.csdn.net/2401_84164527/article/details/137691737

版权

2024年程序员学习专栏收录该内容

114 篇文章 1 订阅

订阅专栏

应用图标和标签配置

应用图标需要在工程的AppScope目录下的 app.json5配置文件中配置icon标签。应用图标需配置为图片的资源索引，配置完成后，该图片即为应用的图标。

应用标签需要在工程的AppScope模块下的 app.json5配置文件中配置label标签。标识应用对用户显示的名称，需要配置为字符串资源的索引。

{
  "app": {
    "icon": "$media:app_icon",
    "label": "$string:app_name"
    ...
  }
}

入口图标和标签配置

入口图标和标签配置方式

Stage模型支持对组件配置入口图标和入口标签。入口图标和入口标签会显示在桌面上。

入口图标需要在 module.json5配置文件中配置，在abilities标签下面有icon标签。例如希望在桌面上显示该UIAbility的图标，则需要在skills标签下面的entities中添加”entity.system.home”、actions中添加”ohos.want.action.home”。同一个应用有多个UIAbility配置上述字段时，桌面上会显示出多个图标，分别对应各自的UIAbility。

{
  "module": {
    ...
    "abilities": [
      {
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home"
            ]
          }
        ],
      }
    ]
  }
}

入口图标和标签管控规则

OpenHarmony系统对无图标应用严格管控，防止一些恶意应用故意配置无入口图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户终端设备的安全。

如果应用确需隐藏入口图标，需要配置AllowAppDesktopIconHide应用特权，具体配置方式参考应用特权配置指南。详细的入口图标及入口标签的显示规则如下。

HAP中包含UIAbility
- 在module.json5配置文件的abilities标签中设置了入口图标
- 该应用没有隐藏图标的特权
  - 系统将使用该UIAbility配置的icon作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到该UIAbility首页。
  - 系统将使用该UIAbility配置的label作为入口标签，并显示在桌面上，如果没有配置label，系统将使用app.json5中的label作为入口标签，并显示在桌面上。
- 该应用具有隐藏图标的特权
  - 桌面应用查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。
- 在module.json5配置文件的abilities标签中未设置入口图标
- 该应用没有隐藏图标的特权
  - 系统将使用app.json5中的icon作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到应用管理中对应的应用详情页面，如下图所示。
  - 系统将使用app.json5中的label作为入口标签，并显示在桌面上。
- 该应用具有隐藏图标的特权
  - 桌面应用查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。
HAP中不包含UIAbility
- 该应用没有隐藏图标的特权
- 系统将使用app.json5中的icon作为入口图标，并显示在桌面上。用户点击该图标，页面跳转到应用管理中对应的应用详情页面，如下图所示。
- 系统将使用app.json5中的label作为入口标签，并显示在桌面上。
- 该应用具有隐藏图标的特权
- 桌面应用查询时不返回应用信息，不会在桌面上显示对应的入口图标和标签。

图2 应用的详情页示意图

应用版本声明配置

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