HarmonyOS鸿蒙Next中用uniapp写的项目，图标是在hbuilder里设置的，尺寸和前景图要求也都符合，但是还是提示应用末配置图标的前景图和后景图

HarmonyOS鸿蒙Next中用uniapp写的项目，图标是在hbuilder里设置的，尺寸和前景图要求也都符合，但是还是提示应用末配置图标的前景图和后景图 用uniapp写的鸿蒙项目，图标是在hbuilder里设置的，尺寸和前景图要求也都符合，但是还是提示应用末配置图标的前景图和后景图

5 回复

开发者您好，请检查在uniapp内配置的图标路径是否为相对路径。

相对路径图片配置：https://uniapp.dcloud.net.cn/collocation/manifest.html#app-harmony-icons

并且再次检查前景图需为透明的PNG格式，后景图为纯色，尺寸是否符合1024x1024，且不得进行裁剪。

背景要求：https://developer.huawei.com/consumer/cn/doc/architecture-guides/insurance-v1_2-ts_33-0000002312518974#section11578112125113

更多关于HarmonyOS鸿蒙Next中用uniapp写的项目，图标是在hbuilder里设置的，尺寸和前景图要求也都符合，但是还是提示应用末配置图标的前景图和后景图的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


学习了

这个提示通常要看“最终生成的 HarmonyOS 工程/HAP 配置”，不要只看 HBuilder 界面里是否填了图标。

HarmonyOS 应用图标检查更关注分层图标资源，建议按下面几项排查：

  1. 打开 uniapp 生成后的 ohos/HarmonyOS 原生工程，确认 AppScope/resources/base/media 或对应资源目录里确实生成了前景图、背景图，而不是只有一张普通 icon 图。

  2. 检查 app.json5/module.json5 中 icon 相关配置引用的资源名，是否和实际 media 资源一致；大小写、文件名、资源名不一致也会导致打包后识别不到。

  3. 如果 HBuilder 修改后仍提示旧配置，先清理生成目录/构建缓存，再重新生成 HarmonyOS 工程并打包，避免还在提交旧 HAP。

  4. 最后用 DevEco Studio 打开生成后的原生工程看资源预览和打包产物，确认 HAP 里包含前景/背景资源。

也就是说，重点不是“尺寸是否符合”，而是 HBuilder 最终有没有把前景图、背景图写进 HarmonyOS 原生工程配置里。

HarmonyOS Next要求图标采用自适应图标格式，需在配置文件（如module.json5）中显式声明adaptive-icon节点的foregroundImage和backgroundImage。uniapp的HBuilder配置仅对应普通图标，未自动生成鸿蒙专用配置项。请检查项目中的module.json5或app.json5，确保包含完整adaptive-icon定义，且文件路径、格式（PNG）均正确。

在 HBuilder 中设置的图标仅生成常规应用图标，但鸿蒙 Next 要求使用分层图标（Foreground + Background），并在 AppScope/app.json5 中以对象形式配置。直接打包会导致配置检查报错。

解决：找到 uniapp 编译后的鸿蒙原生工程（一般在 unpackage/harmonyos 目录），在 AppScope/resources/base/media 下放入前景图 foreground.png 和背景图 background.png（尺寸通常 216×216，注意切图安全区），然后编辑 AppScope/app.json5，将 icon 字段改为对象：

"icon": {
  "foreground": "$media:foreground",
  "background": "$media:background"
}

重新打包即可通过校验。

回到顶部