首页 > 代码库 > [Phonegap+Sencha Touch] 移动开发36 Phonegap/Cordova项目的图标和启动画面(splashscreen)配置

[Phonegap+Sencha Touch] 移动开发36 Phonegap/Cordova项目的图标和启动画面(splashscreen)配置

Phonegap/Cordova项目中的config.xml文件,里面配置了下面的内容:

<icon gap:platform="android" gap:qualifier="ldpi" src=http://www.mamicode.com/"res/icon/android/icon-36-ldpi.png" />>

这个res/icon和res/screen目录是相对于phonegap项目目录的,也就是类似phonegap/res/icon/android/icon-36-ldpi.png,你的图标和启动画面必须在这两个目录下

phonegap3.5以前的config.xml中src=http://www.mamicode.com/"res/........",phonegap3.5开始变为了src="www/res/.......",而实际图标和启动画面文件都是存在于www/res下面的。因此phonegap3.4没应用上图标和启动画面是情有可原的(因为路径没指定对)。

不过尽管将src改为"www/res/.......",也将我们自己的图标和启动画面文件放在了phonegap/www/res/...下,

但是最后build之后的安卓项目和ios项目,图标和启动画面还是没有我们自己的。


后来看了Cordova文档,对config.xml做了一些修改,才配置成功。

1、去掉上面config.xml中的图标和启动画面配置,改为下面的

<platform name="android">
  <icon src=http://www.mamicode.com/"res/icon/android/icon-36-ldpi.png" density="ldpi" />>


2、你需要准备好你自己的app图标和启动画面png文件:

安卓图标具体规格如下(存放目录:phonegap/res/icon/android/)

icon-36-ldpi.png36×36
icon-48-mdpi.png48×48
icon-72-hdpi.png72×72
icon-96-xhdpi.png96×96

安卓启动画面具体规格如下(存放目录:phonegap/res/screen/android/)

splash-land-hdpi.png640×480
splash-land-ldpi.png426×320
splash-land-mdpi.png470×320
splash-land-xhdpi.png960×720
splash-port-hdpi.png480×640
splash-port-ldpi.png320×426
splash-port-mdpi.png320×470
splash-port-xhdpi.png720×960


iOS图标具体规格如下(存放目录:phonegap/res/icon/ios/)

icon-60@3x.png180×180
icon-60.png60×60
icon-60@2x.png120×120
icon-76.png76×76
icon-76@2x.png152×152
icon-40.png40×40
icon-40@2x.png80×80
icon.png57×57
icon@2x.png114×114
icon-72.png72×72
icon-72@2x.png144×144
icon-small.png29×29
icon-small@2x.png58×58
icon-50.png50×50
icon-50@2x.png100×100

iOS启动画面具体规格如下(存放目录:phonegap/res/screen/ios/)

Default~iphone.png320×480
Default@2x~iphone.png640×960
Default-Portrait~ipad.png768×1024
Default-Portrait@2x~ipad.png1536×2048
Default-Landscape~ipad.png1024×768
Default-Landscape@2x~ipad.png2048×1536
Default-568h@2x~iphone.png640×1136
Default-667h.png750×1334(好像cordova4.0才支持)
Default-736h.png?1242×2208 (好像cordova4.0才支持)
Default-Landscape-736h.png2208×1242 (好像cordova4.0才支持)

3、如何显示splashscreen启动画面?

iOS默认可以启用启动画面,安装到手机后运行就可以看到;

安卓的的话本来也是默认也有启动画面的,只不过因为配置有问题,没有显示出来,原因如下:

phonegap生成安卓项目的时候,会自动把phonegap/res/screen/android/下面的各个图片文件命名为screen.png,放到安卓项目的各个res/drawable*目录底下,而在CordovaLib\src\org\apache\cordova\Config.java中指定的文件名却是"splash.png"。app启动时找不到splash.png,所以就没显示。

因此,我们要在config.xml中添加下面两个preference配置,用"SplashScreen"指定文件名为screen.png:

<preference name="SplashScreen" value=http://www.mamicode.com/"screen" />>"SplashScreenDelay"指定启动画面多长时间后自动隐藏,这里配置了3000ms,也就是3秒钟。


4、好了,到这就配置完毕了,重新build你的phonegap项目吧,你的安卓和ios都能显示你自己的图标和启动画面了。

ps:我推荐是每次buildphonegap项目的时候都将以下目录和文件删除后再build:

对于安卓,删除phonegap/plugins/android.json文件和phonegap/platforms/android文件夹

对于ios,删除phonegap/plugins/ios.json文件和phonegap/platforms/ios文件夹




但是有的手机速度慢,或者js和css文件大,上面设置的3秒钟根本不足够js和css加载完,这时就会出现启动画面隐藏了,然后黑屏或者白屏几秒种,然后才出现web界面。这怎么办?

cordova有一个插件,叫org.apache.cordova.splashscreen,地址在这里

这个插件的作用就是让你自己控制启动画面的显示与隐藏

我们可以将"SplashScreenDelay"设置的大一点,比如10000ms,即10秒钟。等到我们的web界面出来以后,我们手动再把启动画面隐藏。你需要做以下工作:

1、在config.xml中修改"SplashScreenDelay"配置,改为10000

<preference name="SplashScreenDelay" value=http://www.mamicode.com/"10000" />

2、在config.xml中修改"auto-hide-splash-screen"配置,改为false(也就是不自动隐藏

<preference name="auto-hide-splash-screen" value=http://www.mamicode.com/"false" />

3、在你的app逻辑代码中,自己手动调用下面的代码隐藏启动画面

navigator.splashscreen.hide();
这句代码必须在deviceready事件中调用(如果是sencha touch,只要在app.js的launch方法中调用就行了)





对于安卓,还有个问题,安卓手机太多参差不齐,分辨率也五花八门,上面配置的4中(横竖屏共8个)分辨率的启动画面,在有的手机上会出现拉伸变形的情况。

介绍一种图片格式——9-patch图片(.9.png后缀)。与传统的png 格式图片相比, 9.png 格式图片在图片四周有一圈一个像素点组成的边沿,该边沿用于对图片的可扩展区和内容显示区进行定义。 这种格式的图片在android 环境下具有自适应调节大小的能力。

具体介绍和制作方法,可以看这篇博文


好了,9-patch格式的启动画面我们也准备好了,怎么用到我们的phonegap(安卓)项目中呢?

phonegap(安卓)项目默认根据config.xml中指定的"SplashScreen"这个配置,也就是上面我们配置的"screen"作为启动画面文件名(没有找到这个配置的话就用"splash")。

9-patch文件名必须以".9.png"结尾,也就是我们的启动画面文件名必须是"screen.9.png"。上面说了phonegap在build的时候生成的安卓项目启动画面文件名是"screen.png"。要想让它变成"screen.9.png",我们需要去改phonegap/Cordova的nodejs代码。

1、config.xml中配置安卓启动画面的部分要改改了:

<platform name="android">
  <icon src=http://www.mamicode.com/"res/icon/android/icon-36-ldpi.png" density="ldpi" />>也就是把文件改成9-patch图片,文件后缀改为.9.png

2、打开文件C:\Users\xxxxx\AppData\Roaming\npm\node_modules\phonegap\node_modules\cordova-lib\src\cordova\metadata\android_parser.js

作如下修改:



3、重新build你的phonegap项目,此时生成的安卓项目中各个res/drawable*文件夹中就都有screen.9.png文件了。



参考文档:

1、Cordova官方文档《Icons and Splash Screens》

2、Phonegap官方文档《Icons and Splash Screens》


---------------------------------------------------------------------------------------------------------------------------------------------------------

欢迎加入Sencha Touch + Phonegap 群:194182999

共同学习交流(博主QQ:479858761)


求赞助:

1、百度情感转账,只要支付1分钱,你得10元,我得5元

2、百度透明小金库,支付我1分钱,就可以赞助我

3、百度钱包支付1分钱,获得体彩顶呱刮兑换码。把兑换码发给我可以赞助我


[Phonegap+Sencha Touch] 移动开发36 Phonegap/Cordova项目的图标和启动画面(splashscreen)配置