CoronaSplashControl.*

Type (special)
Revision Release 2024.3703
Keywords Splash Screen Control, splash screen
Platforms Android, iOS

Overview

This special plugin, enables control of the default Solar2D branded splash screen that is displayed when apps start up on a device. Rather than adding capabilities to Lua code, this plugin enables the ability to control the splash screen from within build.settings.

Note
  • On iOS, the iOS launch screen will appear before the splash screen, assuming the splash screen is not disabled. If the splash screen is disabled, the launch screen will appear until the app is fully loaded, then your first screen/scene will appear.

Integration

Splash Screen Removal

To remove splash screen, add the splashScreen table to the project’s build.settings with the enable key set to false:

settings =
{
    splashScreen = 
    {
        enable = false
    },
}

Alternatively, you can remove the splash screen on a per-platform basis as follows:

settings =
{
    splashScreen =
    {
        ios = {
            enable = false
        },
        android = {
            enable = true
        }
    },
}

Custom Splash Screen

If you’d like to display your own custom splash screen, include the splashScreen table within build.settings as above, but set the enable key to true and add an image key defining the image name. For instance:

settings =
{
    splashScreen = 
    {
        enable = true,
        image = "mySplashScreen.png"
    },
}

Alternatively, you can customize the splash screen on a per-platform basis as follows:

settings =
{
    splashScreen =
    {
        ios = {
            enable = true,
            image = "mySplashScreen_iOS.png"
        },
        android = {
            enable = true,
            image = "mySplashScreen_Android.png"
        }
    },
}

For customized implementation, image indicates the path to any image file in the project. The image will be displayed on a black background and it will match the default orientation of the app, scaled to fit the screen of the current device. You may need to experiment to arrive at the ideal image for your splash screen, but if it’s large enough for the largest device your app is intended to run on, you only need one image.

Note

Because build.settings does not apply to app builds performed via Solar2D Native, special handling is required to customize the splash screen in these instances. Please see the Solar2D Native section below for details.

Solar2D Native

Because build.settings does not apply to app builds performed via Solar2D Native, special handling is required to customize the splash screen in these instances: