license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

Splashscreen

Displays and hides the application's splash screen.

Methods

  • splashscreen.show
  • splashscreen.hide

Permissions

Android

app/res/xml/config.xml

<plugin name="SplashScreen" value="org.apache.cordova.SplashScreen"/>

iOS

config.xml

<plugin name="SplashScreen" value="CDVSplashScreen" />

Setup

Android

  1. Copy the splash screen image into the Android project's res/drawable directory. The size for each image should be:

    • xlarge (xhdpi): at least 960 × 720
    • large (hdpi): at least 640 × 480
    • medium (mdpi): at least 470 × 320
    • small (ldpi): at least 426 × 320

    You should use a 9-patch image for your splash screen.

  2. In the onCreate method of the class that extends DroidGap, add the following two lines:

     super.setIntegerProperty("splashscreen", R.drawable.splash);
     super.loadUrl(Config.getStartUrl(), 10000);
    

    The first line sets the image to display as the splashscreen. If you name your image anything other than splash.png, you need to modify this line. The second line is the normal super.loadUrl line, but it has a second parameter that specifies a timeout value for the splash screen. In this example the splash screen displays for 10 seconds. To dismiss the splash screen once the app receives the deviceready event, call the navigator.splashscreen.hide() method.

iOS

Copy your splash screen images into the iOS project's Resources/splash directory. Only add the images for the devices you want to support, such as iPad or iPhone. The size of each image should be:

  • Default-568h@2x~iphone.png (640x1136 pixels)
  • Default-Landscape@2x~ipad.png (2048x1496 pixels)
  • Default-Landscape~ipad.png (1024x748 pixels)
  • Default-Portrait@2x~ipad.png (1536x2008 pixels)
  • Default-Portrait~ipad.png (768x1004 pixels)
  • Default@2x~iphone.png (640x960 pixels)
  • Default~iphone.png (320x480 pixels)