CoronaSplashControl.*

Type (special)
Revision Current Public Release (2017.3068)
Keywords Corona Splash Control, splash screen
Platforms Android, iOS

Overview

This special plugin, if purchased/activated, enables control of the default Corona-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.

Notes
  • It is not necessary to add this plugin to the plugins table of build.settings. The significant factor is whether the plugin is activated for the user account performing a build.

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

  • Corona Native customers do not need to purchase the splash control plugin (it is pre-enabled for your account). For other details related to using this plugin in Corona Native builds, please see the Corona Native section below.

Integration

Splash Screen Removal

For the simplest case of removing the Corona splash screen, all you need to do is activate the plugin and 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 Corona Native, special handling is required to customize the splash screen in these instances. Please see the Corona Native section below for details.

Corona Native

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

Support