This is a premium module, in order to use it you will need to upgrade your project.
launchimage: Launch images
forge.launchimage namespace allows you to customize the image to display while your app is loading.
By default, the launch image is hidden automatically when the window
initialize itself, set up native topbars and
tabbars for example. If you want full control over hiding the launch image yourself, set Hide Manually to
true in the config.
The majority of the configuration for the is paths to images at various resolutions. All launch images must be placed in your
src directory. Paths to your launchimages should be specified relative to your
Note: The old Launch Image schema and sizes are no longer supported by Apple.
Instead of requiring a separate bitmap matching the resolution of each available iOS device Apple have introduced the notion of "size classes" which reduces the total number of images required to four.
For more information on size classes, please read: A Size Class Reference Guide
"auto"will result in the image being displayed as centered while the first page is loading. As Android device sizes vary a pixel perfect loading image cannot be used. The image will be proportionally scaled down to fit the screen if necessary. A Background Size value of
"cover"will result in the image being uniformly scaled by maintaining the image's aspect ratio so that both dimensions (width and height) of the image will be equal to or larger than the screen. The image is then centered in the view. The solid color to use behind this launch image can be configured with the Background Color configuration option.
Note: All images must be defined for a given platform in order to build successfully.
truewill prevent the automatic hiding of the launch image done by default, the launchimage will be hidden when you call forge.launchimage.hide.
Note: Use PNG format for all launch images, as it is required on at least iOS and your app may not be submittable to the App Store otherwise.
If you want to manually hide the launch image yourself, use this API.
function(content)called after the launch image has been hidden
function(content)called when the user chooses not to share their location with your app