Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
aa5ea0d1
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3598
Star
108
Fork
921
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
120
列表
看板
标记
里程碑
合并请求
109
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
120
Issue
120
列表
看板
标记
里程碑
合并请求
109
合并请求
109
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
未验证
提交
aa5ea0d1
编写于
1月 11, 2022
作者:
DCloud-yyl
提交者:
Gitee
1月 11, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add docs/app-icons.md.
上级
ee5591fe
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
122 addition
and
0 deletion
+122
-0
docs/app-icons.md
docs/app-icons.md
+122
-0
未找到文件。
docs/app-icons.md
0 → 100644
浏览文件 @
aa5ea0d1
打开项目的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原生工程配置
](
https://nativesupport.dcloud.net.cn/AppDocs/usesdk/android?id=icons
)
### iOS平台
**注意事项**
-
必须使用png格式,其它格式需要使用图片工具转换,注意不要直接将jpg等其它格式图片直接改名为png
-
图标必须是直角,不要使用圆角图标,使用圆角AppStore审核不会通过
-
打包提交appstore时,必须配置1024
*
1024分辨率的AppStore图标,云端打包机默认使用纯白色图标
-
所有图标不要包含透明信息(alpha通道),否则提交AppStore会报以下错误
[
ITMS-90717
](
#itms90717
)
错误
更多应用图标相关信息,参考苹果官方说明:
[
https://developer.apple.com/design/human-interface-guidelines/ios/icons-and-images/app-icon/
](
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
)
|iPhone设备程序图标
|ipad|对象,参考
[
iPad图标源码参数
](
#ipad
)
|iPad设备程序图标|
|appstore|String|720P高分屏设备程序图标路径,分辨率要求1024x1024|
<a
id=
"iphone"
/>
iPhone图标源码参数
|属性名称|类型|说明|
|:-|:-|:-|
|app@2x|String|iPhone4S/5/6/7/8设备程序主图标,分辨率要求120x120|
|app@3x|String|iPhone6plus/7plus/8plus/X设备程序主图标,分辨率要求180x180|
|spotlight@2x|String|iPhone5/6/7/8设备Spotlight搜索图标,分辨率要求80x80|
|spotlight@3x|String|iPhone6plus/7plus/8plus/X设备Spotlight搜索图标,分辨率要求120x120|
|settings@2x|String|iPhone5/6/7/8设备Settings设置图标,分辨率要求58x58|
|settings@3x|String|iPhone6plus/7plus/8plus/X设备Settings设置图标,分辨率要求87x87|
|notification@2x|String|iPhone5/6/7/8设备通知栏图标,分辨率要求40x40|
|notification@3x|String|iPhone6plus/7plus/8plus/X设备通知栏图标,分辨率要求60x60|
<a
id=
"ipad"
/>
iPad图标源码参数
|属性名称|类型|说明|
|:-|:-|:-|
|app|String|iOS7+设备程序主图标,分辨率要求76x76|
|app@2x|String|iOS7+高分屏设备程序主图标,分辨率要求152x152|
|proapp@2x|String|iPad Pro设备程序主图标,分辨率要求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原生工程配置
](
https://nativesupport.dcloud.net.cn/AppDocs/usesdk/ios?id=%e9%85%8d%e7%bd%ae%e5%ba%94%e7%94%a8%e7%9a%84%e5%9b%be%e6%a0%87
)
### 常见问题
#### iOS平台配置/更新图标后打包安装,图标显示不正确
**解决方案**
iOS系统会缓存应用图标,需要重启手机新图标才能生效
<a
id=
"itms90717"
/>
#### 提交AppStore审核是报ITMS-90717错误
这是因为图片中包含透明信息,即alpha通道,完整错误提示如下:
```
javascript
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通道,重新提价云端打包
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录