鸿蒙应用上架审核要求：图标的设置方法

⚙️ 一、图标资源准备要求

1. 前景图（Foreground）

   • 规格：1024×1024 px 的透明背景 PNG 文件，仅包含应用图标主体（如 Logo 图形），禁止自行添加圆角、内边距或阴影。
   • 存放路径：entry/src/main/resources/base/media/foreground.png 。

2. 背景图（Background）

   • 规格：1024×1024 px 的 PNG 文件，仅包含纯色或渐变背景层，不可包含图标主体元素（如文字、图形）。
   • 存放路径：entry/src/main/resources/base/media/background.png 。

💡 示例：前景图为透明底的“微信气泡”，背景图为纯绿色底图。两图叠加后由系统自动生成圆角效果。

---

🛠️ 二、使用 DevEco Studio 生成图标（强制要求）

1. 工具版本：必须升级到 HUAWEI DevEco Studio 5.0.5.315 或更高版本，低版本生成的图标将被拒绝。
2. 操作步骤：
   • 在工程中右键点击模块 → New > Image Asset
   • 在 Foreground Layer 标签页选择 Image 并导入 foreground.png
   • 在 Background Layer 标签页选择 Color（纯色）或 Image（导入 background.png）
   • 点击 Next 完成生成，工具会自动创建适配不同分辨率的图标资源。

---

📂 三、配置文件关键修改
在 entry/src/main/module.json5 中检查并修正以下字段：

json

 

{
  "icon": "$media:icon",                // 引用生成的图标
  "startWindowIcon": "$media:icon_startwindow"  // 启动图标（144×144 px）
}

注意事项：

• 删除旧版单图标配置（如旧版 icon.png），避免冲突；
• 确认 $media:icon_startwindow 路径存在（生成后位于 resources/phone-sdpi/media/）。

---

📱 四、应用市场提交附加要求
在 华为 AppGallery Connect (AGC) 上传应用时：

• 应用图标：需提供 216×216 px 的直角图标（非分层图），可通过以下任一方式获取：
  1. 使用 DevEco Studio 生成的 icon.png（位于 resources/base/media/）
  2. 由设计师合并前景与背景图输出直角版本。

---

❌ 常见审核失败原因

1. 尺寸不符：前景/背景图非 1024×1024 px 或非 PNG 格式；
2. 工具版本过低：未使用 DevEco Studio 5.0.5.315+ 生成图标；
3. 配置文件未更新：module.json5 仍指向旧图标或缺失 startWindowIcon 字段；
4. 自行添加圆角：在 PNG 中手动裁剪圆角（系统会自动处理）。

紧急处理：若审核提示“页面边距过大”（如左右边距 >500 px），需检查 UI 布局是否适配折叠屏展开状态。

---

📚 官方规范参考

• 鸿蒙应用 UX 设计规范
• 分层图标配置指南

按此流程操作可解决 90% 的图标审核问题。若仍失败，请检查 layered_image.json 文件是否自动生成（位于 media/ 目录），若无则需手动创建。