HarmonyOS应用开发指南：组件级配置规范

在开发应用时，需要配置应用的一些标签，例如应用的包名、图标等标识特征的属性。本文描述了在开发应用需要配置的一些关键标签。

应用包名配置

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

图标和标签配置

图标和标签通常一起配置，可以分为应用图标、应用标签和入口图标、入口标签，分别对应app.json5配置文件和module.json5配置文件中的icon和label标签。

应用图标和标签通常用于标识整个应用，可以在标识应用的界面使用该类型图标和标签。比如：

• 设置应用中，需要展示应用列表时
• 在隐私管理中，需要展示应用申请的权限时
• 在状态栏显示通知消息时

入口图标和标签是应用安装完成后可以在设备桌面上显示出来的，如下图所示。入口图标是以UIAbility为粒度，支持同一个应用存在多个入口图标和入口标签，点击后进入对应的UIAbility界面。比如：

• 桌面上需要显示图标时
• 最近任务列表中显示时

图1 图标和标签

应用图标和标签配置

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

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

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

入口图标和标签配置

入口图标和标签配置方式

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

<