Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
程序yang
unidocs-zh
提交
aa5ea0d1
U
unidocs-zh
项目概览
程序yang
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
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的桌面图标,推荐使用“自动生成图标”功能:
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/icons/auto.png
)
如果不使用自动生成图标方式,可按下面文档分别配置Android和iOS平台的图标。
### Android平台
**注意事项**
-
必须使用png格式,其它格式需要使用图片工具转换,注意不要直接将jpg等其它格式图片直接改名为png
-
系统没有对图标分辨率进行限制,按照建议的分辨率配置即可
-
图片支持透明区域,建议使用圆角图标
> 提示:可能有些特殊手机ROM对图标有所要求,提交相应应用市场时注意看是否有要求
#### 云端打包
**可视化界面配置**
推荐在可视化界面操作配置,在“Android图标配置”下根据分辨率选择对应的图标:
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/icons/android.png
)
**源码视图配置**
切换到源码视图界面,在 "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
**默认图标**
云端打包没有配置图标时将使用以下默认图标:
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/icons/def-android.png
)
#### 离线打包
离线打包需在原生工程中配置应用图标,参考
[
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图标配置”下根据分辨率选择对应的图标:
![](
https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/icons/ios.png
)
-
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录