[CB-5908] Splashscreen docs are conflicting

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 3.3.0
• Fix Version/s: 3.5.0
• Assignee: Marcel Kinard
• Reporter: John M. Wargo
• Created: 27/Jan/14 22:42
• Updated: 23/Aug/18 06:51
• Resolved: 10/Feb/14 22:54

Description

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

• relates to: CB-5145 Why are non-android resources included in platforms/android assets folder?