Automatically generates native code for adding splash screens in Android and iOS. Customize with specific platform, background color and splash image.

This package is heavily inspired by flutter_launcher_icons created by Mark O'Sullivan and Franz Silva.

First, add flutter_native_splash as a dev dependency in your pubspec.yaml file. You should add the package to dev_dependencies because you don't need this plugin in your APK.

dev_dependencies: flutter_native_splash: ^0.1.9

Don't forget to flutter pub get .

1. Setting the splash screen #

Add your settings to your project's pubspec.yaml file or create a file in your root project folder named flutter_native_splash.yaml with your settings.

flutter_native_splash: image: assets/images/splash.png color: "42a5f5"

image must be a png file.

must be a file. You can use # in color as well. color: "#42a5f5"

You can omit image parameter if you just want a colored splash screen:

flutter_native_splash: color: "42a5f5"

You can also set android or ios to false if you don't want to create a splash screen for a specific platform.

flutter_native_splash: image: assets/images/splash.png color: "42a5f5" android: false

In case your image should use all available screen (width and height) you can use fill property.

flutter_native_splash: image: assets/images/splash.png color: "42a5f5" fill: true

Note: fill property is not yet implemented for iOS splash screens.

If you want to disable full screen splash screen on Android you can use android_disable_fullscreen property.

flutter_native_splash: image: assets/images/splash.png color: "42a5f5" android_disable_fullscreen: true

2. Run the package #

After adding your settings, run the package with

flutter pub pub run flutter_native_splash:create

When the package finishes running your splash screen is ready.

If splash screen was not updated properly on iOS or if you experience a white screen before splash screen, run flutter clean and recompile your app. (issue #9)

and recompile your app. (issue #9) This package modifies launch_background.xml , styles.xml and MainActivity files on Android and LaunchScreen.storyboard , Info.plist and AppDelegate on iOS. If you modified this files manually this plugin may not work properly, please open a issue if you find any bugs.

If you want to use a Material Icon as your splash image, download an icon in (material.io/resources/icons) as PNG for Android . I recommend using the biggest icon in drawable-xxxhdpi folder which was just downloaded for better results.

for . I recommend using the biggest icon in folder which was just downloaded for better results. Material Colors are available in material.io/resources/color

How it works #

Your splash image will be resized to mdpi , hdpi , xhdpi , xxhdpi and xxxhdpi drawables.

, , , and drawables. An <item> tag containing a <bitmap> for your splash image drawable will be added in launch_background.xml

tag containing a for your splash image drawable will be added in Background color will be added in colors.xml and referenced in launch_background.xml .

and referenced in . Code for full screen mode toggle will be added in styles.xml and MainActivity .