gulp-mobile-splashscreens
v1.2.1
Published
Gulp plugin that creates PNG splashscreens for iOS based on a SVG image
Downloads
17
Readme
gulp-mobile-splashscreens
Gulp plugin that creates PNG splashscreens for iOS and Android based on a SVG image
Please read this blog post for a detailed explanation of the problem that the plugin solves.
Usage
To use the the plugin in your gulp process:
const gulp = require('gulp');
const mobileSplashscreens = require('gulp-mobile-splashscreens');
gulp.task('default', [], function() {
gulp.src('splashscreen.svg')
.pipe(mobileSplashscreens())
.pipe(gulp.dest('images'));
});
This will create all splashscreens in the folder images/
.
Cordova / PhoneGap
Add the following to your config.xml
to use the icons in a Cordova/PhoneGap application:
<platform name="ios">
<!-- Splashscreens -->
<splash src="images/ios-1080-portrait.png" width="1080" height="1920"/>
<splash src="images/ios-1080-landscape.png" width="1920" height="1080"/>
<splash src="images/ios-750-portrait.png" width="750" height="1334"/>
<splash src="images/ios-750-landscape.png" width="1334" height="750"/>
<splash src="images/ios-1242-portrait.png" width="1242" height="2208"/>
<splash src="images/ios-1242-landscape.png" width="2208" height="1242"/>
<splash src="images/ios-640-portrait.png" width="640" height="1136"/>
<splash src="images/ios-640-landscape.png" width="1136" height="640"/>
<splash src="images/ios-640-short-portrait.png" width="640" height="960"/>
<splash src="images/ios-640-short-landscape.png" width="960" height="640"/>
<splash src="images/ios-320-portrait.png" width="320" height="480"/>
<splash src="images/ios-320-landscape.png" width="480" height="320"/>
<splash src="images/ios-2048-portrait.png" width="2048" height="2732"/>
<splash src="images/ios-2048-landscape.png" width="2732" height="2048"/>
<splash src="images/ios-1536-portrait.png" width="1536" height="2048"/>
<splash src="images/ios-1536-landscape.png" width="2048" height="1536"/>
<splash src="images/ios-768-portrait.png" width="768" height="1024"/>
<splash src="images/ios-768-landscape.png" width="1024" height="768"/>
</platform>
<platform name="android">
<splash src="images/android-ldpi-portrait.png" density="port-ldpi"/>
<splash src="images/android-ldpi-landscape.png" density="land-ldpi"/>
<splash src="images/android-mdpi-portrait.png" density="port-mdpi"/>
<splash src="images/android-mdpi-landscape.png" density="land-mdpi"/>
<splash src="images/android-hdpi-portrait.png" density="port-hdpi"/>
<splash src="images/android-hdpi-landscape.png" density="land-hdpi"/>
<splash src="images/android-xhdpi-portrait.png" density="port-xhdpi"/>
<splash src="images/android-xhdpi-landscape.png" density="land-xhdpi"/>
<splash src="images/android-xxhdpi-portrait.png" density="port-xxhdpi"/>
<splash src="images/android-xxhdpi-landscape.png" density="land-xxhdpi"/>
<splash src="images/android-xxxhdpi-portrait.png" density="port-xxxhdpi"/>
<splash src="images/android-xxxhdpi-landscape.png" density="land-xxxhdpi"/>
</platform>
FAQ
Q: Why does iOS add a black background behind my splashscreen?
If you use a SVG with a transparent background, the gulp-mobile-splashscreens
will create splashscreens with transparent background. iOS always adds a black
background to those transparent splashscreens.
You need to add to your SVG a background if you want to have another color. It's important that the background area stretches beyond the image itself because gulp-mobile-splashscreens
will otherwise add transparent areas around
the image to fill the target size of each splashscreen.
For example, this adds a red background to your splashscreens:
<?xml version="1.0" encoding="UTF-8"?>
<svg width="375px" height="667px" viewBox="0 0 375 667" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<rect fill="red" width="10000" height="10000" transform="translate(-5000, -5000)"/>
<!-- Your image -->
</svg>
Credits
Sample icon made by Freepik from www.flaticon.com is licensed by Creative Commons BY 3.0