Launch Images

Astro supports apps displaying a custom launch image. This image will be displayed until app.js calls Application.dismissLaunchImage(). The setup for each launch image is platform specific and must be done in the native projects.

Setup Launch Image in iOS

Configure a launch screen in Xcode by creating a Storyboard or a nib file (.xib) and designating it as the "Launch Screen File". You can design the screen using any of the concepts availabe in Interface Builder with the exception that launch screens cannot have any dynamic parts (no animations or responding to user input, etc). You can read about how to set up a launch screen in this blog post.

You can read about Apple's recommendations for designing effective launch screens in Apple's Human Interface Guidelines for iOS.

Note: Astro does not currently support extending the launch screen if it is defined using the older style launch screen images in an asset catalog. We recommend using a launch screen nib or storyboard.

Setup Launch Image in Android

Define a custom theme in the app's styles.xml file. This theme can include a drawable resource and some additional styling. Ensure the theme's parent is Theme.AppCompat.Light.NoActionBar.

// styles.xml
    <style name="LaunchTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:windowBackground">@drawable/launch_screen</item>

Apply the custom theme to the MainActivity of the android app in AndroidManifest.xml.

// AndroidManifest.xml