HarmonyOS 鸿蒙Next中如何搞分层图标

你截图里要求的“分层图标”，指的是 HarmonyOS 应用图标不是一张 png，而是 前景图（foreground）+ 背景图（background） 两层组合的图标资源（并且审核要求你提供 1024×1024 的高分辨率源图）。

下面给你一套“从素材准备 → DevEco 生成 → 工程配置 → 常见踩坑”的完整流程（按这个做基本一次过）。

一、先准备两张 1024×1024 的素材（这是关键）

1）前景图 foreground（必须带透明通道）

• PNG，1024×1024
• 只放 Logo/主体图形，背景透明
• 不要把整张画布留很多透明边（审核经常要求“不要人为留白/不要加间距”）

2）背景图 background（建议纯色或不透明背景）

• PNG，1024×1024
• 建议用纯色或纹理底图（一般不需要透明）

你截图里强调的点：1024×1024、不要在资源内加间距、不要自己裁切搞出不规则留白——这通常是为了后续系统在不同形状/圆角/动效里做统一处理。

二、用 DevEco Studio 直接生成分层图标（推荐，最省事）

DevEco 有一个 “Image Asset” 向导可以把你的 1024 源图生成到资源目录，并自动帮你组织多密度产物。

操作路径（大致一致）：

1. 在工程中右键：
   • 如果你要给 模块（entry） 配 icon：在 entry 目录右键
   • 如果你要给 AppScope（应用级） 配 icon：在 AppScope 目录右键
2. 选择：New > Image Asset
3. 在向导里填写：
   • Name：例如 layered_image（不要中文）
   • Foreground Layer：选择你的前景 1024 PNG（可调整 Trim/Resize）
   • Background Layer：选择背景（Color 或 Image）
4. Next → Finish

DevEco 会把资源生成到 resources/.../media 下，并给你生成对应的图标资源文件与多密度图。

这个向导的说明里也写了前景/背景层、推荐 1024×1024 等配置项。
Sources: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-apply-generated-icon-V14

三、手动配置分层图标（你想完全可控时用）

如果你不想用向导，也可以手工按官方格式做。

方式 A：在 AppScope 配（应用级图标）

1. 放文件到：
   • AppScope/resources/base/media/foreground.png
   • AppScope/resources/base/media/background.png
2. 新建分层图标描述文件，例如：
   • AppScope/resources/base/media/layered_image.json

内容如下（重点是 layered-image 结构）：

{
  "layered-image": {
    "background": "$media:background",
    "foreground": "$media:foreground"
  }
}

1. 在 AppScope/app.json5 引用它：

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

方式 B：在 entry 模块配（UIAbility 图标）

同理，把 foreground.png/background.png/layered_image.json 放到：

• entry/src/main/resources/base/media/

然后在 entry/src/main/module.json5 里对入口 UIAbility 配：

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

官方对“如何配置分层图标（app.json5/module.json5）+ layered_image.json 格式”有完整说明。
Sources: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/layered-image

四、为什么你“改了 app.json5 还是不生效”？（配置优先级坑）

很多人踩坑在这里：入口 UIAbility 的 icon/label 优先级通常高于 app.json5。
也就是说：

• 你如果在 module.json5 的入口 UIAbility 里写了 icon，系统可能就用 UIAbility 的；
• 只有当 UIAbility 没配（或入口判断不成立）时，才回落用 app.json5。

五、审核/上架常见失败点（按你的截图要求特别提醒）

• 源图必须 1024×1024（前景/背景都建议是）
• 不要人为加留白：主体过小、四周透明边太大容易被判“不符合规范”
• 前景必须透明 PNG（否则分层没意义）
• 文件名遵守资源命名规范（字母/数字/下划线/点，不要中文/空格）

这个优先级在官方文档里也有说明（多 HAP、多入口时的取值规则）。
Sources: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/layered-image