diff --git a/docs/app-icons.md b/docs/app-icons.md
new file mode 100644
index 0000000000000000000000000000000000000000..73c0ff9de2796b6c33f02988db4de992435e6a56
--- /dev/null
+++ b/docs/app-icons.md
@@ -0,0 +1,122 @@
+打开项目的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|
+
+
+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|
+
+
+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系统会缓存应用图标，需要重启手机新图标才能生效
+
+
+
+#### 提交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通道，重新提价云端打包
+