简体中文
简体中文
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通道，重新提交云端打包
