HarmonyOS鸿蒙Next中终端出现的图标为系统图标与我上传的图标不一致
HarmonyOS鸿蒙Next中终端出现的图标为系统图标与我上传的图标不一致 为什么我在鸿蒙开发的应用,在真机和仿真机调试时,真机和仿真器显示的图标与应用图标一致,但上传到上架前测试,终端出现的图标为系统图标与我上传的图标不一致?
看看官方回答:
更多关于HarmonyOS鸿蒙Next中终端出现的图标为系统图标与我上传的图标不一致的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
- HAP中包含UIAbility
- 入口UIAbility:skills标签中entities中包含"entity.system.home"、并且actions中包含"ohos.want.action.home"。
- 在module.json5配置了多个入口UIAbility:
- 如果module.json5中mainElement配置的为入口UIAbility,则返回mainElement对应的入口UIAbility配置的icon和label。
- 如果module.json5中mainElement未配置或者配置的不为入口UIAbility,则返回module.json5中配置的第一个入口UIAbility对应的icon和label。
- 在module.json5配置文件中,出现以下任一情况时,系统将返回app.json5中的icon或label:
- mainElement配置的为入口UIAbility,但是入口UIAbility未设置icon或label。
- mainElement未配置或者配置的不为入口UIAbility,且module.json5配置文件中第一个入口UIAbility未设置icon或label。
- 多HAP包的工程中,如果entry类型存在,以entry类型的HAP中module.json5配置文件为准。如果没有entry类型,此时用所有hap的moduleName以ASCII字典序排序,最终以排序为最后一个的feature包的module.json5配置文件为准。
- HAP中不包含UIAbility,系统将返回app.json5中的icon和label。
参考地址 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/layered-image
我这边建议把“本地调试图标”和“上架前测试终端图标”分开排查:真机/模拟器直接安装时主要看包内配置;上架前测试链路还会受应用素材、分层图标和旧版本缓存影响,所以两边不一致是可能出现的。
先看工程内配置,确认不是只改了启动页图标:
// entry/src/main/module.json5
{
"module": {
"abilities": [{
"name": "EntryAbility",
"icon": "$media:app_icon",
"label": "$string:app_name",
"startWindowIcon": "$media:startIcon"
}]
}
}
icon 决定桌面/任务入口图标,startWindowIcon 只是启动窗口图标,两者不要混用。然后检查 resources/base/media 及深浅色、分辨率资源是否随本次包一起打入。
如果面向 HarmonyOS 5/6,继续检查分层图标:前景层建议透明底、只放主体;背景层不要透明,并按官方分层图标规范导出。再到 AGC/应用素材里确认普通图标和分层图标都已更新,重新提交新版本包;测试机上建议卸载旧包或提升 versionCode 后再测,避免显示旧缓存。
参考:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ui-design-layered-process
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file
是否在AppGallery Concert上传应用图标,
可能需要在AppGallery Concert-应用与元服务-素材管理-应用图标进行上传,
现在配置图标都是前后两层的了:

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ui-design-layered-process
你对照一下看看吧
这是鸿蒙Next的系统图标缓存机制所致。应用上传的自定义图标在安装后未触发刷新,终端仍显示默认系统图标。需检查图标资源命名、尺寸是否符合标准,并确认打包时图标文件已正确包含。
应用图标在真机/模拟器调试时正确,但上架前测试显示系统图标,通常是因为上架包中图标资源未正确打包。常见原因:
- 上传的图标文件路径或格式不符合上架要求(如尺寸、透明度、png/jpg规范),系统校验失败后自动回退为默认图标。
- 打包时未将图标资源纳入正式包,或使用了调试期特有的资源覆盖逻辑。
- 上架配置中的“应用图标”与工程内实际引用的资源不一致,复审包拉取的是商店配置而非工程资源。
请检查上架包内的图标文件是否存在于对应资源目录,并确认其尺寸、格式与鸿蒙应用市场要求完全一致。若配置无误,可尝试重新构建正式包并上传。
