ios.netmaui

Black/Blank Splash Screen (Loading Screen) on Apple Device


I have a .NET 7 MAUI application that is being used solely for iOS/iPadOS. The splash screen is completely black with nothing visible. The SVG file is an image with no black - only blue and white. This happens in deployment to local devices and simulators, as well as when deploying a Release build IPA to the device.

I have:

<ItemGroup>
  <MauiSplashScreen Include="Resources\Splash\loading_screen.svg" />
</ItemGroup>
<key>UILaunchStoryboardName</key>
<string>MauiSplash</string>
<key>UILaunchImageFile</key>
<string>Resources\Splash\loading_screen.svg</string>

Solution

  • Firstly, on iOS, when changing the simulator to the version: iOS 16.0, the SplashScreen can be displayed normally.

    Also, when adding a new key/value-Pair: UILaunchImageFile in Info.plist, it only works with PNG format files like below:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
        ...
        <key>UILaunchImageFile</key>
        <string>Resources\Splash\your_splash.png</string>
    </dict>
    </plist>
    

    Last but not least, you can refer to the two threads listed below, they provide an excellent solutions for the customization of SplashScreen on both iOS and Android.

    Splashscreen icon not showing

    Changes in Info.plist not recognized anymore