harmony 鸿蒙应用/组件级配置

2022-12-13
浏览 (1097)

应用/组件级配置

开发者在开发应用时，需要配置应用的一些标签，例如应用的Bundle名称、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。

应用包名配置

应用包名需在config.json文件中app标签下配置bundleName字段，该字段用于指定应用的包名，需保证唯一性。包名是由字母、数字、下划线（_）和点号（.）组成的字符串，必须以字母开头。支持的字符串长度为7~127字节。包名通常采用反向域名形式表示（例如，”com.example.myapplication”）。建议第一级为域名后缀”com”，第二级为厂商/个人名，也可以采用多级。应用名称配置可以参考app标签说明。

图标和标签配置

图标和标签通常一起配置，可以分为应用图标、应用标签和入口图标、入口标签。

应用图标和标签通常用于标识整个应用，可以在标识应用的界面使用该类型图标和标签。比如： * 设置应用中，需要展示应用列表时 * 在隐私管理中，需要展示应用申请的权限时 * 在状态栏显示通知消息时

入口图标和标签是应用安装完成后可以在设备桌面上显示出来的。入口图标是以Page类型的Ability为粒度，支持同一个应用存在多个入口图标和入口标签，点击后进入对应的Ability界面。比如： * 桌面上需要显示图标时 * 最近任务列表中显示时

应用图标和标签配置

FA模型不支持直接配置应用图标和标签，会以符合规则的PageAbility的图标和标签作为应用图标和标签。存在多个时，则取位置靠前的Ability的icon和label作为应用的icon和label。

入口图标和标签配置

入口图标和标签配置方法

FA模型的入口图标和标签是Page类型的Ability配置的icon和label。

PageAbility的图标和标签配置请参见PageAbility组件配置。需在config.json文件的abilities标签下做如下配置： * 配置icon字段，标签值为资源文件的索引。图标需要在配置IDE的资源文件中，路径为/resource/base/media。取值示例：$media:ability_icon。 * 配置label字段，标签值为资源文件的索引，标识Ability对用户显示的名称。取值可以是Ability名称，也可以是对该名称的资源索引，以支持多语言。

如果在该PageAbility的skills属性中，actions的取值包含 “action.system.home”，entities取值中包含”entity.system.home”，则该Ability的icon和label将同时作为应用的icon和label。如果存在多个符合条件的Ability，则取位置靠前的Ability的icon和label作为应用的icon和label。图标和标签配置可以参考abilities标签说明。

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

入口图标和标签管控规则

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

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

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