Cordova官方插件 -- Icon + SplashScreen

Cordova快速添加Icon图标和Splash闪屏页

​​官方Configuring Icons in the CLI文档​​

  图标的配置仅需在项目的config.xml文件中添加文件路径即可.

​​官方cordova-plugin-splashscreen文档​​

1. 安装插件(命令行的两种方式)

• cordova plugin add cordova-plugin-splashscreen
• cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git

2. 在项目第一级目录(与platform同级)的config.xml中做如下配置

• A_添加各平台闪屏页文件的相对路径.

<platform name="android">
    <!-- 图标 -->
    <icon src="res/screen/android/ic_launcher.png" density="ldpi" />
    <icon src="res/screen/android/ic_launcher.png" density="mdpi" />
    <icon src="res/screen/android/ic_launcher.png" density="hdpi" />
    <icon src="res/screen/android/ic_launcher.png" density="xhdpi" />
    
    <!-- 闪屏页 -->
    <splash src="res/screen/android/launch.png" density="land-hdpi"/>
    <splash src="res/screen/android/launch.png" density="land-ldpi"/>
    <splash src="res/screen/android/launch.png" density="land-mdpi"/>
    <splash src="res/screen/android/launch.png" density="land-xhdpi"/>

    <splash src="res/screen/android/launch.png" density="port-hdpi"/>
    <splash src="res/screen/android/launch.png" density="port-ldpi"/>
    <splash src="res/screen/android/launch.png" density="port-mdpi"/>
    <splash src="res/screen/android/launch.png" density="port-xhdpi"/>
</platform>

<platform name="ios">
    <!-- 图标 -->
    <!-- iOS 8.0+ -->
    <!-- iPhone 6 Plus  -->
    <icon src="res/ios/[email protected]" width="180" height="180" />
    <!-- iOS 7.0+ -->
    <!-- iPhone / iPod Touch  -->
    <icon src="res/ios/icon-60.png" width="60" height="60" />
    <icon src="res/ios/[email protected]" width="120" height="120" />
    <!-- iPad -->
    <icon src="res/ios/icon-76.png" width="76" height="76" />
    <icon src="res/ios/[email protected]" width="152" height="152" />
    <!-- iOS 6.1 -->
    <!-- Spotlight Icon -->
    <icon src="res/ios/icon-40.png" width="40" height="40" />
    <icon src="res/ios/[email protected]" width="80" height="80" />
    <!-- iPhone / iPod Touch -->
    <icon src="res/ios/icon.png" width="57" height="57" />
    <icon src="res/ios/[email protected]" width="114" height="114" />
    <!-- iPad -->
    <icon src="res/ios/icon-72.png" width="72" height="72" />
    <icon src="res/ios/[email protected]" width="144" height="144" />
    <!-- iPhone Spotlight and Settings Icon -->
    <icon src="res/ios/icon-small.png" width="29" height="29" />
    <icon src="res/ios/[email protected]" width="58" height="58" />
    <!-- iPad Spotlight and Settings Icon -->
    <icon src="res/ios/icon-50.png" width="50" height="50" />
    <icon src="res/ios/[email protected]" width="100" height="100" />
    
    <!-- 闪屏页 -->
    <splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
    <splash src="res/screen/ios/Default@2x~iphone.png" width="640" height="960"/>
    <splash src="res/screen/ios/Default-Portrait~ipad.png" width="768" height="1024"/>
    <splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
    <splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024" height="768"/>
    <splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
    <splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640" height="1136"/>
    <splash src="res/screen/ios/Default-667h.png" width="750" height="1334"/>
    <splash src="res/screen/ios/Default-736h.png" width="1242" height="2208"/>
    <splash src="res/screen/ios/Default-Landscape-736h.png" width="2208" height="1242"/>
</platform>

<platform name="windows">
    <splash src="res/screen/windows/splashscreen.png" width="620" height="300"/>
    <splash src="res/screen/windows/splashscreenphone.png" width="1152" height="1920"/>
</platform>

<platform name="blackberry10">
    <rim:splash src="res/screen/blackberry/splashscreen.png"/>
</platform>

• B_闪屏页显示配置

1. AutoHideSplashScreen(default-true)：true为闪屏页显示结束时，自动隐藏.
   ​​​<preference name="AutoHideSplashScreen" value="true|false" />​​
2. SplashScreenDelay(default-3000)：控制闪屏页的显示时长.
   ​​​<preference name="SplashScreenDelay" value="3000" />​​
3. SplashMaintainAspectRatio：false为拉伸闪屏页以适应屏幕宽高.
   ​​​<preference name="SplashMaintainAspectRatio" value="true|false" />​​
4. SplashShowOnlyFirstTime(default-true)：true为仅第一次进入APP才显示闪屏页.
   ​​​<preference name="SplashShowOnlyFirstTime" value="true|false" />​​
5. FadeSplashScreen(default-true)：true为允许使用渐变动画来隐藏闪屏页.
   ​​​<preference name="FadeSplashScreen" value="true|false"/>​​
6. FadeSplashScreenDuration(default-3000)：闪屏页结束前value时间内开始渐变动画.
   ​​​<preference name="FadeSplashScreenDuration" value="3000"/>​​
7. ShowSplashScreenSpinner (default-true)：true为闪屏页显示的时候，同时也会显示进度条Bar.
   ​​​<preference name="ShowSplashScreenSpinner" value="true|false"/>​​

3. 在JS中可做如下配置

• 显示闪屏页

navigator.splashscreen.show();

• 隐藏闪屏页

• A-渐变隐藏

window.setTimeout(function () {
    navigator.splashscreen.hide();
}, splashDuration - fadeDuration);
// 闪屏页显示时长 - 渐变时长 = 闪屏开始渐变隐藏的时刻

• B-直接隐藏

navigator.splashscreen.hide();