eapp
Version:
118 lines (105 loc) • 6.54 kB
Markdown
#cordova-icon-splash
Automatically generate icons and splash screens from source images to create each size needed for each platform.
Since each platform has different image requirements, it’s best to make a source image for the **largest size needed**, and let the cordova-icon-splash do all the resizing, cropping and copying for you.
本工具没有实现将icon和splash放到对应平台的资源目录下或者添加配置到cordova项目的config.xml，因为我们还需要此工具为原生项目开发服务。
对于Cordova项目可自行配置<pltforms>中有关icon和splash的配置。During the build process, Cordova (v3.6 or later) will look through the project’s config.xml file and copy the newly created resource images to the platform’s specific resource folder.
##Usage
1、新建文件夹，如icon-splash，用于存放配置文件、原始图片资源和生成的图片资源。
2、新建配置文件，cordova-icon-splash默认配置文件为**icon-splash-config.json**。配置生成如下平台的资源：
```JSON
{
"platforms": [
"android",
"ios"
]
}
```
*PS*: 生成Icon和Splash还有其它的配置项，默认内置在cordova-icon-splash，可通过icon-splash-config.json修改这些配置。
3、在在icon-splash中添加原始的icon.png和splash.png。建议大小为：
- icon: 1024 x 1024 (or even 2048 x 2048)
- splash: 2208x2208 with main content in center 1200x1200
4、安装cordova-icon-splash：
事先需要安装[ImageMagick](http://www.imagemagick.org),本工具使用其处理图片。
如果你使用OS X：
```
brew install imagemagick
```
安装完成之后，全局安装cordova-icon-splash
```
npm install cordova-icon-splash -g
```
生成：
```
cd icon-splash
cordova-icon-splash
```
## Config Icon and Splash For Cordova
在Cordova项目的config.xml中添加如下配置：
```XML
<platform name="android">
...
<!-- Config Android Icon -->
<icon src="icon-splash/android/icons/icon-ldpi.png" density="ldpi"/>
<icon src="icon-splash/android/icons/icon-mdpi.png" density="mdpi"/>
<icon src="icon-splash/android/icons/icon-hdpi.png" density="hdpi"/>
<icon src="icon-splash/android/icons/icon-xhdpi.png" density="xhdpi"/>
<!-- Config Android Splash -->
<splash src="icon-splash/android/splashes/splash-land-hdpi.png" density="land-hdpi"/>
<splash src="icon-splash/android/splashes/splash-land-ldpi.png" density="land-ldpi"/>
<splash src="icon-splash/android/splashes/splash-land-mdpi.png" density="land-mdpi"/>
<splash src="icon-splash/android/splashes/splash-land-xhdpi.png" density="land-xhdpi"/>
<splash src="icon-splash/android/splashes/splash-port-hdpi.png" density="port-hdpi"/>
<splash src="icon-splash/android/splashes/splash-port-ldpi.png" density="port-ldpi"/>
<splash src="icon-splash/android/splashes/splash-port-mdpi.png" density="port-mdpi"/>
<splash src="icon-splash/android/splashes/splash-port-xhdpi.png" density="port-xhdpi"/>
</platform>
<platform name="ios">
...
<!-- Config iOS Icon -->
<!-- iOS 8.0+ -->
<!-- iPhone 6 Plus -->
<icon src="icon-splash/ios/icons/icon-60@3x.png" width="180" height="180"/>
<!-- iOS 7.0+ -->
<!-- iPhone / iPod Touch -->
<icon src="icon-splash/ios/icons/icon-60.png" width="60" height="60"/>
<icon src="icon-splash/ios/icons/icon-60@2x.png" width="120" height="120"/>
<!-- iPad -->
<icon src="icon-splash/ios/icons/icon-76.png" width="76" height="76"/>
<icon src="icon-splash/ios/icons/icon-76@2x.png" width="152" height="152"/>
<!-- iOS 6.1 -->
<!-- Spotlight Icon -->
<icon src="icon-splash/ios/icons/icon-40.png" width="40" height="40"/>
<icon src="icon-splash/ios/icons/icon-40@2x.png" width="80" height="80"/>
<!-- iPhone / iPod Touch -->
<icon src="icon-splash/ios/icons/icon.png" width="57" height="57"/>
<icon src="icon-splash/ios/icons/icon@2x.png" width="114" height="114"/>
<!-- iPad -->
<icon src="icon-splash/ios/icons/icon-72.png" width="72" height="72"/>
<icon src="icon-splash/ios/icons/icon-72@2x.png" width="144" height="144"/>
<!-- iPhone Spotlight and Settings Icon -->
<icon src="icon-splash/ios/icons/icon-small.png" width="29" height="29"/>
<icon src="icon-splash/ios/icons/icon-small@2x.png" width="58" height="58"/>
<!-- iPad Spotlight and Settings Icon -->
<icon src="icon-splash/ios/icons/icon-50.png" width="50" height="50"/>
<icon src="icon-splash/ios/icons/icon-50@2x.png" width="100" height="100"/>
<!-- Config iOS Splash -->
<splash src="icon-splash/ios/splashes/Default~iphone.png" width="320" height="480"/>
<splash src="icon-splash/ios/splashes/Default@2x~iphone.png" width="640" height="960"/>
<splash src="icon-splash/ios/splashes/Default-Portrait~ipad.png" width="768" height="1024"/>
<splash src="icon-splash/ios/splashes/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
<splash src="icon-splash/ios/splashes/Default-Landscape~ipad.png" width="1024" height="768"/>
<splash src="icon-splash/ios/splashes/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
<splash src="icon-splash/ios/splashes/Default-568h@2x~iphone.png" width="640" height="1136"/>
<splash src="icon-splash/ios/splashes/Default-667h.png" width="750" height="1334"/>
<splash src="icon-splash/ios/splashes/Default-736h.png" width="1242" height="2208"/>
<splash src="icon-splash/ios/splashes/Default-Landscape-736h.png" width="2208" height="1242"/>
</platform>
```
Cordova在添加平台或者构建的时候会根据此配置，将icon和splash复制到相应的平台中，见下图：
 
**PS**:对于Android平台有时会出现无法显示splash的情况，我们可以通过**cordova-plugin-splashscreen**插件解决。
安装完cordova-plugin-splashscreen后，在config.xml中配置splash的显示。
```XML
<preference name="SplashScreen" value="screen"/>
<preference name="SplashScreenDelay" value="5000"/>
```