config.xml配置
在cordova5.0版本以后,需要安裝
cordova-plugin-splashscreen
插件以后才能修改和設(shè)置App的啟動(dòng)頁面。
安裝splashscreen插件:
cordova plugin add cordova-plugin-splashscreen
或
cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
基本配置
然后在你的config.xml文件中,添加以下代碼
<platform name="android">
<icon density="ldpi" src="res/icon/android/icon-36-ldpi.png" />
<icon density="mdpi" src="res/icon/android/icon-48-mdpi.png" />
<icon density="hdpi" src="res/icon/android/icon-72-hdpi.png" />
<icon density="xhdpi" src="res/icon/android/icon-96-xhdpi.png" />
<icon density="xxhdpi" src="res/icon/android/icon-144-xxhdpi.png" />
<icon density="xxxhdpi" src="res/icon/android/icon-192-xxxhdpi.png" />
<splash density="land-hdpi" src="res/screen/android/splash-land-hdpi.png" />
<splash density="land-ldpi" src="res/screen/android/splash-land-ldpi.png" />
<splash density="land-mdpi" src="res/screen/android/splash-land-mdpi.png" />
<splash density="land-xhdpi" src="res/screen/android/splash-land-xhdpi.png" />
<splash density="port-hdpi" src="res/screen/android/splash-port-hdpi.png" />
<splash density="port-ldpi" src="res/screen/android/splash-port-ldpi.png" />
<splash density="port-mdpi" src="res/screen/android/splash-port-mdpi.png" />
<splash density="port-xhdpi" src="res/screen/android/splash-port-xhdpi.png" />
</platform>
<platform name="ios">
<!-- iOS 8.0+ -->
<!-- iPhone 6 Plus -->
<icon src="res/icon/ios/icon-60@3x.png" width="180" height="180" />
<!-- iOS 7.0+ -->
<!-- iPhone / iPod Touch -->
<icon src="res/icon/ios/icon-60.png" width="60" height="60" />
<icon src="res/icon/ios/icon-60@2x.png" width="120" height="120" />
<!-- iPad -->
<icon src="res/icon/ios/icon-76.png" width="76" height="76" />
<icon src="res/icon/ios/icon-76@2x.png" width="152" height="152" />
<!-- iOS 6.1 -->
<!-- Spotlight Icon -->
<icon src="res/icon/ios/icon-40.png" width="40" height="40" />
<icon src="res/icon/ios/icon-40@2x.png" width="80" height="80" />
<!-- iPhone / iPod Touch -->
<icon src="res/icon/ios/icon.png" width="57" height="57" />
<icon src="res/icon/ios/icon@2x.png" width="114" height="114" />
<!-- iPad -->
<icon src="res/icon/ios/icon-72.png" width="72" height="72" />
<icon src="res/icon/ios/icon-72@2x.png" width="144" height="144" />
<!-- iPhone Spotlight and Settings Icon -->
<icon src="res/icon/ios/icon-small.png" width="29" height="29" />
<icon src="res/icon/ios/icon-small@2x.png" width="58" height="58" />
<icon src="res/icon/ios/icon-small@3x.png" width="87" height="87" />
<!-- iPad Spotlight and Settings Icon -->
<icon src="res/icon/ios/icon-50.png" width="50" height="50" />
<icon src="res/icon/ios/icon-50@2x.png" 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>
其他配置
-
自動(dòng)隱藏啟動(dòng)頁面
AutoHideSplashScreen
(默認(rèn)為:true)<preference name="AutoHideSplashScreen" value="true" />
-
顯示啟動(dòng)頁面的時(shí)間長度
SplashScreenDelay
(默認(rèn)為:3000)<preference name="SplashScreenDelay" value="3000" />
若想禁用啟動(dòng)頁面,可設(shè)置為:
<preference name="SplashScreenDelay" value="0"/>
如果是iOS平臺(tái)上想禁止啟動(dòng)頁面,還需要添加
<preference name="FadeSplashScreenDuration" value="0"/>
-
啟動(dòng)頁面淡入淡出的效果
是否顯示淡入淡出效果
FadeSplashScreen
(默認(rèn)為:true)<preference name="FadeSplashScreen" value="false"/>
淡入淡出效果的執(zhí)行時(shí)間長度
FadeSplashScreenDuration
(默認(rèn)為:500)<preference name="FadeSplashScreenDuration" value="750"/>
注意:
FadeSplashScreenDuration
時(shí)間是包含在SplashScreenDelay
的時(shí)間里的。 -
啟動(dòng)頁面是否允許旋轉(zhuǎn)(默認(rèn)為:true)
<preference name="ShowSplashScreenSpinner" value="false"/>
-
插件還可以通過js代碼調(diào)用,提供有以下兩個(gè)方法:
navigator.splashscreen.hide();//隱藏啟動(dòng)頁面 navigator.splashscreen.show();//顯示啟動(dòng)頁面
-
在Android平臺(tái)下的特殊設(shè)置
<preference name="SplashMaintainAspectRatio" value="true|false" /> <preference name="SplashShowOnlyFirstTime" value="true|false" />
SplashMaintainAspectRatio
:選填項(xiàng),默認(rèn)為false。當(dāng)設(shè)置為true時(shí),則不會(huì)拉伸圖片來填充屏幕,會(huì)以圖片原始比例顯示圖片。SplashShowOnlyFirstTime
:選填項(xiàng),默認(rèn)為true。當(dāng)設(shè)置為false時(shí),APP通過navigator.app.exitApp()
代碼退出app后,在下次打開APP時(shí),還會(huì)顯示啟動(dòng)頁面。若為true時(shí),就不會(huì)出現(xiàn)。
圖標(biāo)文件夾內(nèi)容
根據(jù)上面的配置信息,你需要準(zhǔn)備好你自己的app圖標(biāo)和啟動(dòng)畫面png文件:
存放路徑不是以
www文件夾
為依據(jù),而是以當(dāng)前項(xiàng)目文件夾
為依據(jù)
projectRoot
hooks
platforms
plugins
www
css
img
js
res
screen
android
ios
icon
android
ios
應(yīng)用程序圖標(biāo)
-
安卓圖標(biāo)具體規(guī)格如下(存放目錄:res/icon/android/)
36*36 icon-36-ldpi.png 48*48 icon-48-ldpi.png 72*72 icon-72-ldpi.png 96*96 icon-96-ldpi.png 144*144 icon-144-ldpi.png 192*192 icon-192-ldpi.png
-
iOS圖標(biāo)具體規(guī)格如下(存放目錄:res/icon/ios/)
29*29 icon-small.png 58*58 icon-small@2x.png 87*87 icon-small@3x.png 40*40 icon-40.png 80*80 icon-40@2x.png 50*50 icon-50.png 100*100 icon-50@2x.png 60*60 icon-60.png 120*120 icon-60@2x.png 180*180 icon-60@3x.png 72*72 icon-72.png 144*144 icon-72@2x.png 76*76 icon-76.png 152*152 icon-76@2x.png
應(yīng)用程序啟動(dòng)頁面
-
安卓啟動(dòng)畫面具體規(guī)格如下(存放目錄:res/screen/android/)
960*720 splash-land-xhdpi.png 640*480 splash-land-hdpi.png 470*320 splash-land-mdpi.png 426*320 splash-land-ldpi.png 720*960 splash-port-xhdpi.png 480*640 splash-port-hdpi.png 320*470 splash-port-mdpi.png 320*426 splash-port-ldpi.png
-
iOS啟動(dòng)畫面具體規(guī)格如下(存放目錄:res/screen/ios/)
320*480 Default~iphone.png 640*960 Default@2x~iphone.png 768*1024 Default-Portrait~ipad.png 1536*2048 Default-Portrait@2x~ipad.png 1024*768 Default-Landscape~ipad.png 2048*1536 Default-Landscape@2x~ipad.png 640*1136 Default-568h@2x~iphone.png 750*1334 Default-667h.png 1242*2208 Default-736h.png 2208*1242 Default-Landscape-736h.png