Share via

Splash screen hangs on iPhone iOS 26

Samuel Riesterer 5 Reputation points
2026-02-06T18:09:46.63+00:00

Is this a common issue for anyone?

I have a published app that has worked across many iPhones in testing. As of 2/4/26 for some reason, users have reported that the splash screen hangs and is not dismissed.

I have tested it on my simulators and confirmed it hangs on any iPhone running iOS >= 26. It is fine on iPhone running iOS 18. it also is fine on iPads running iOS 26 for some reason. I created a startup New Project and that works fine on iOS 26. But not my current project.

What is weird is that it used to work fine on my physical iPhone SE iOS 26.2 and I just uninstalled it and re-installed a fresh copy from the App Store and now it too hangs on the splash screen. I have been round and round with AI the whole day trying to find a solution and nothing is working.

dotnet 9.0.310

Xcode 26.0

VS Code 1.109.0

CommunityToolkit.Maui 9.1.0

Microsoft.Maui.Controls 9.0.10

Developer technologies | .NET | .NET MAUI
0 comments No comments
{count} votes

3 answers

Sort by: Most helpful
  1. Jack Dang (WICLOUD CORPORATION) 14,955 Reputation points Microsoft External Staff Moderator
    2026-02-09T03:20:18.28+00:00

    Hi @Samuel Riesterer ,

    Thanks for circling back and sharing what you found.

    What’s going on here is essentially a version alignment issue inside the MAUI stack.

    When you use:

    <PackageReference Include="Microsoft.Maui.Controls" Version="$(MauiVersion)" />
    

    you’re letting the .NET MAUI workload pick the exact version of Microsoft.Maui.Controls that matches your installed SDK. That means all the MAUI pieces are built and tested to work together for that specific .NET and iOS combination.

    On the other hand, when you pin it explicitly like this:

    <PackageReference Include="Microsoft.Maui.Controls" Version="9.0.10" />
    

    you’re overriding that coordination. That small mismatch is enough to cause problems during app startup. The app technically launches, but the MAUI initialization never fully finishes, so iOS keeps showing the splash screen and nothing else happens. No crash, just a silent hang.

    Hope this helps! If my explanation was helpful - kindly follow the instructions here so others with the same problem can benefit as well.

    2 people found this answer helpful.

  2. Samuel Riesterer 5 Reputation points
    2026-02-06T23:02:47.8733333+00:00

    Here was the reason for the splash screen hanging:

    this works:

    <PackageReference Include="Microsoft.Maui.Controls" Version="$(MauiVersion)" />

    This hangs on the splash screen:

    <PackageReference Include="Microsoft.Maui.Controls" Version="9.0.10" />

    1 person found this answer helpful.
    0 comments No comments

  3. Q&A Assist
    2026-02-06T18:09:58.57+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    It seems that you are experiencing a specific issue with the splash screen hanging on iPhones running iOS 26. While this issue is not explicitly documented in the provided context, there are a few troubleshooting steps you can consider based on common practices for .NET MAUI applications:

    1. Check for Updates: Ensure that all your dependencies, including .NET MAUI and any related libraries, are updated to the latest versions. Sometimes, issues are resolved in newer releases.
    2. Review Splash Screen Configuration: Make sure that your splash screen is configured correctly in your project. You can refer to the documentation on how to add and manage splash screens in .NET MAUI apps.
    3. Disable Splash Screen Processing: For troubleshooting purposes, you can try disabling splash screen resource generation by setting the $(EnableSplashScreenProcessing) property to false in your project file. This can help determine if the issue is related to the splash screen processing.
         <EnableSplashScreenProcessing>false</EnableSplashScreenProcessing>
      
    4. Test on Physical Devices: Since you mentioned that the issue occurs on physical devices, try testing on different models or configurations to see if the problem persists across all devices running iOS 26.
    5. Debugging: Use debugging tools to check for any exceptions or errors that may be occurring during the initialization process of your app. This can provide insights into what might be causing the splash screen to hang.

    If these steps do not resolve the issue, consider reaching out to the community or checking for any known issues related to iOS 26 and .NET MAUI applications.


    References:

    1 person found this answer helpful.
    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.