Uploaded image for project: 'Apache Cordova'
  1. Apache Cordova
  2. CB-5908

Splashscreen docs are conflicting



    • Bug
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • 3.3.0
    • 3.5.0
    • None
    • None


      the documentation her: http://cordova.apache.org/docs/en/3.3.0/config_ref_images.md.html#Icons%20and%20Splash%20Screens is inaccurate.

      The res folder was dropped in a previous version of the CLI, but the instructions still say to copy the files from the res folder.

      the instructions also say that you want to copy the files to screen.png, but what follows those instructions says you want to set the files to splash. The two are in conflict. Later it mentions to change it to screen, but why tell me screen then splash then tell me to change splash to screen?

      Lastly, it tells me I need to add some settings to the config.xml, but which of the three config.xml files? It says the project's www folder, and I'm assuming that's the high level www folder, but these are Android-specific settings, so what happens with them on other platforms? this is all really unclear.

      Here's the sections from the docs:

      If you want to use the default splash screen images provided in Cordova, you'll need to copy the png files from platforms/android/www/res/screen/android to platforms/android/res/drawable*/:

      cd platforms/android/res
      mkdir drawable-port-ldpi
      cp -p ../assets/www/res/screen/android/screen-ldpi-portrait.png drawable-port-ldpi/screen.png
      mkdir drawable-land-ldpi
      cp -p ../assets/www/res/screen/android/screen-ldpi-landscape.png drawable-land-ldpi/screen.png
      mkdir drawable-port-mdpi
      cp -p ../assets/www/res/screen/android/screen-mdpi-portrait.png drawable-port-mdpi/screen.png
      mkdir drawable-land-mdpi
      cp -p ../assets/www/res/screen/android/screen-mdpi-landscape.png drawable-land-mdpi/screen.png
      mkdir drawable-port-hdpi
      cp -p ../assets/www/res/screen/android/screen-hdpi-portrait.png drawable-port-hdpi/screen.png
      mkdir drawable-land-hdpi
      cp -p ../assets/www/res/screen/android/screen-hdpi-landscape.png drawable-land-hdpi/screen.png
      mkdir drawable-port-xhdpi
      cp -p ../assets/www/res/screen/android/screen-xhdpi-portrait.png drawable-port-xhdpi/screen.png
      mkdir drawable-land-xhdpi
      cp -p ../assets/www/res/screen/android/screen-xhdpi-landscape.png drawable-land-xhdpi/screen.png

      The drawable directory names must follow the Android conventions for supporting screen sizes and alternate resources.

      In config.xml in the project's www directory, add the following preferences:

      <preference name="SplashScreen" value="splash" />
      <preference name="SplashScreenDelay" value="10000" />


        Issue Links



              cmarcelk Marcel Kinard
              jwargo John M. Wargo
              0 Vote for this issue
              3 Start watching this issue