HarmonyOS 鸿蒙Next标准前景图和后景图

这个报错通常不是单张图片“是不是标准图”的问题，而是分层图标 JSON 里引用的前景/背景资源没有被资源编译器找到。

可以按这个结构检查：

1. 如果应用图标配置引用的是 $media:layered_image，就放一个 layered_image.json。

2. layered_image.json 里引用两张 media 资源，例如：

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

1. 同一套 resources/base/media 里必须同时存在 background.png、foreground.png、layered_image.json，文件名大小写要完全一致，不要在 JSON 里写 png 后缀或相对路径。

2. AppScope 的应用图标资源和 entry 模块里的 Ability 图标资源不要混放：配置在哪个资源作用域引用，就把这三个文件放到对应作用域的 media 目录。改完后 Clean/Rebuild，再重新做上架检测。

前景图一般用透明 PNG，只放主体；背景图用不透明底图。你现在的 1024x1024 图片如果只是一张合成图，不能替代分层配置里的 foreground/background 两张资源。

配置分层图标和应用名称

方式一：配置app.json5

该配置仅当module.json5配置文件中无UIAbility、或者存在UIAbility但abilities标签中未设置icon和label（可手动删除icon和label配置）时生效。

1. 将前景资源和背景资源文件放在“AppScope\resources\base\media”文件夹下。

   本例中，前景资源文件名为“foreground.png”，背景资源文件名为“background.png”。

2. 在“AppScope\resources\base\media”文件夹下app_layered_image.json分层图标资源文件中，配置分层图标的前景资源与背景资源信息。

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

3. 在app.json5配置文件中引用分层图标资源文件。示例如下：

   {
     "app": {
       // ...
       "icon": "$media:layered_image",
       "label": "$string:app_name" // 需要在AppScope/resources/base/element/string.json配置name为app_name的资源，已存在可以忽略
     }
   }
   

方式二：配置module.json5

1. 将前景资源和背景资源文件放在“entry\src\main\resources\base\media”文件夹下。

   本例中采用的前景资源和背景资源的文件名分别为“foreground.png”和“background.png”。

2. 在“entry\src\main\resources\base\media”文件夹下layered_image.json分层图标资源文件中，配置分层图标的前景资源与背景资源信息。

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

3. 如果需要在桌面显示UIAbility图标，除了需要配置icon与label字段，还需要在skills标签下面的entities中添加"entity.system.home"、actions中添加"ohos.want.action.home"。

   {
     "module": {
       // ...
       "abilities": [
         {
           // ...
           // icon配置为分层图标资源文件的索引
           "icon": "$media:layered_image",
           // 需要在entry/src/main/resources/base/element/string.json配置name为EntryAbility_label的资源，已存在可以忽略
           "label": "$string:EntryAbility_label",
           "skills": [
             {
               "entities": [
                 "entity.system.home"
               ],
               "actions": [
                 "ohos.want.action.home"
               ]
             }
           ]
         }
       ],
       // ...
     }
   }
   

说明

DevEco Studio NEXT Beta1(5.0.3.814) 及之后的版本，创建应用时默认模板中包含分层图标的资源文件，不同版本生成的资源文件名称可能不同，文件名称支持手动修改。如果分层图标资源文件不存在则需要手动创建，文件名称需要符合资源命名规范，由数字、字母、点和下划线组成。