HBuilderX中打开项目的manifest.json文件,在“App图标配置”中可以设置App的桌面图标,推荐使用“自动生成图标”功能:

如果不使用自动生成图标方式,可按下面文档分别配置Android和iOS平台的图标。

# Android平台

注意事项

  • 必须使用png格式,其它格式需要使用图片工具转换,注意不要直接将jpg等其它格式图片直接改名为png
  • 系统没有对图标分辨率进行限制,按照建议的分辨率配置即可
  • 图片支持透明区域,建议使用圆角图标

提示:可能有些特殊手机ROM对图标有所要求,提交相应应用市场时注意看是否有要求

# 云端打包

可视化界面配置 推荐在可视化界面操作配置,在“Android图标配置”下根据分辨率选择对应的图标:

源码视图配置 切换到源码视图界面,在 "app-plus"->"distribute"->"icons"->"android" 节点根据以下属性配置对应分辨率图标路径:

属性名称 类型 说明
xxxhdpi String 2K屏设备程序图标,分辨率要求192x192
xxhdpi String 1080P高分屏设备程序图标,分辨率要求144x144
xhdpi String 720P高分屏设备程序图标,分辨率要求96x96
hdpi String 高分屏设备程序图标,分辨率要求72x72
mdpi String 普通屏设备程序图标,分辨率要求48x48,这类设备很少见,可以不配置
ldpi String 大屏设备程序图标,分辨率要求48x48,这类设备很少见,可以不配置

提示:5+ App项目源码视图节点为app->distribute->icons->android

默认图标 云端打包没有配置图标时将使用以下默认图标:

# 离线打包

离线打包需在原生工程中配置应用图标,参考Android原生工程配置

# iOS平台

注意事项

  • 必须使用png格式,其它格式需要使用图片工具转换,注意不要直接将jpg等其它格式图片直接改名为png
  • 图标必须是直角,不要使用圆角图标,使用圆角AppStore审核不会通过
  • 打包提交appstore时,必须配置1024*1024分辨率的AppStore图标,云端打包机默认使用纯白色图标
  • 所有图标不要包含透明信息(alpha通道),否则提交AppStore会报以下错误ITMS-90717错误

更多应用图标相关信息,参考苹果官方说明:https://developer.apple.com/design/human-interface-guidelines/ios/icons-and-images/app-icon/

# 云端打包

可视化界面配置 推荐在可视化界面操作配置,分别在“app store”、“iPhone图标配置”、“iPad图标配置”下根据分辨率选择对应的图标:

  • app store 应用需要提交到AppStore上架审核是必须配置
  • iPhone图标配置 打包时勾选“支持iPhone”时必须配置
  • iPad图标配置 打包时勾选“支持iPad”是必须配置

源码视图配置 切换到源码视图界面,在 "app-plus"->"distribute"->"icons"->"ios" 节点根据以下属性配置对应分辨率图标路径:

属性名称 类型 说明
iphone 对象,参考iPhone图标源码参数 iPhone设备程序图标
ipad 对象,参考iPad图标源码参数 iPad设备程序图标
appstore String App Store图标路径,分辨率要求1024x1024
# iPhone图标源码参数
属性名称 类型 说明
app@2x String iOS7+设备程序主图标,分辨率要求120x120
app@3x String iOS7+设备程序主图标,分辨率要求180x180
spotlight@2x String iOS7+设备Spotlight搜索图标,分辨率要求80x80
spotlight@3x String iOS7+设备Spotlight搜索图标,分辨率要求120x120
settings@2x String iOS7+设备Settings设置图标,分辨率要求58x58
settings@3x String iOS7+设备Settings设置图标,分辨率要求87x87
notification@2x String iOS7+设备通知栏图标,分辨率要求40x40
notification@3x String iOS7+设备通知栏图标,分辨率要求60x60
# iPad图标源码参数
属性名称 类型 说明
app String iOS7+设备程序主图标,分辨率要求76x76
app@2x String iOS7+高分屏设备程序主图标,分辨率要求152x152
proapp@2x String iOS9+ iPad Pro(12.9英寸)设备程序主图标,分辨率要求167x167
spotlight String iOS7+设备Spotlight搜索图标,分辨率要求40x40
spotlight@2x String iOS7+高分屏设备Spotlight搜索图标,分辨率要求80x80
settings String iOS5+设备Settings设置图标,分辨率要求29x29
settings@2x String iOS5+高分屏设备Settings设置图标,分辨率要求58x58
notification String iOS7+设备通知栏图标,分辨率要求20x20
notification@2x String iOS7+高分屏设备通知栏图标,分辨率要求40x40

# 离线打包

离线打包需在原生工程中配置应用图标,参考iOS原生工程配置

# 常见问题

# iOS平台配置/更新图标后打包安装,图标显示不正确

解决方案 iOS系统会缓存应用图标,需要重启手机新图标才能生效

# 提交AppStore审核是报ITMS-90717错误

这是因为图片中包含透明信息,即alpha通道,完整错误提示如下:

ERROR ITMS-90717: "Invalid App Store Icon. The App Store Icon in the asset catalog in 'HBuilder.app' can't be transparent nor contain an alpha channel."

解决方案 生成png图标文件时去掉alpha通道,重新提交云端打包