写点什么

应用如何配置图标的前景图和后景图?

  • 2026-02-09
    北京
  • 本文字数:881 字

    阅读完需:约 3 分钟

本问答帖原创发布在华为开发者联盟社区 ,欢迎开发者前往论坛提问交流。

 

“您的应用存在【应用未配置图标的前景图和后景图,标准要求尺寸 1024px*1024px 且需下载 HUAWEI DevEco Studio 5.0.5.315 或以上版本进行图标再处理】的问题,不符合鸿蒙应用 UX 设计规范。”

这个问题该怎解决?

 

解决方案:

1、审核出现问题中的提示是因为应用中配置的图标没有符合 UX 设计规范。应用图标资源需分层,尺寸需满足规范要求:应用图标资源必须分为前景图和背景图两层,尺寸要求必须为 1024px*1024px,资源不允许自行裁切圆角,不允许在资源内添加内间距。可参照通用应用UX 体验标准中‘2.1.4.3 图标’章节里的判定标准。

2、官方文档配置分层图标引导用户在 app.json5 配置文件中配置 icon 和 label,由于 module.json5 配置文件中配置的 icon 会覆盖 app.json5 配置文件中的 icon,需要检查是否在 module.json5 配置文件中也配置了 icon 和 label: 

 

如果 module.json5 配置文件中的 icon 和 label 非必需,可以直接删去,减少冗余配置和错误几率。在 DevEco Studio 5.0.3.800 版本及之后,module.json5 配置文件中的 icon 和 label 不再强制要求配置。

如果使用到的某些系统 API,对 module.json5 配置文件中的 icon 和 label 存在依赖(例如:showAssetsCreationDialog,如下图),则需要在 app.json5 和 module.json5 配置文件都配置正确的 icon 和 label。

 

3、下载使用 HUAWEI DevEco Studio 5.0.5.315 或以上版本进行再打包,发布应用。

 

4、在 DevEco Studio 中处理应用图标。

5、处理步骤可参考配置分层图标图标和标签配置

 

【常见 FAQ】

 

Q:按照配置分层图标配置图标后,上架审核时还是会出现应用未配置图标的前景图和后景图问题。

 

A:module.json5 中的图标和标签配置优先级高于 app.json5 中的图标和标签配置,需确认应用的图标和标签配置引用。

 

Q:应用配置图标不符合 UX 设计规范问题在本地解决后,如何确认已修复完成?

 

A:可以使用 AppGallery Connect 平台上的 UX 测试,UX 测试完成后,可从测试报告获知修复结果。

 

具体代码和其他解决方案与思路的讨论,请点击原帖查看:

应用未配置图标的前景图和后景图-华为开发者问答 | 华为开发者联盟 (huawei.com)