.NET MAUI App Not Opening on Android Emulator When Offline

Question

I am encountering an issue with my .NET MAUI application (https://learn.microsoft.com/en-us/dotnet/maui/tutorials/notes-app/?view=net-maui-9.0) where it fails to open in the Android emulator when the internet connection is turned off. The application works fine when the internet is available, but it refuses to launch when offline.

I have already checked for dependencies or services that may require an active internet connection, but I am unsure whether the issue lies with network requests, emulator settings, or permissions.

Steps Taken:

1. I have ensured there are no active network requests during the app's startup.
2. I verified that the Android emulator’s internet settings are correct, but the issue persists when the internet is off.
3. I confirmed that the necessary permissions (INTERNET and ACCESS_NETWORK_STATE) are included in the AndroidManifest.xml.
4. I attempted clearing the emulator’s cache and even created a new emulator instance, but the issue persists.

Request: Could you please assist in identifying why the .NET MAUI application does not open when offline in the Android emulator and provide suggestions on how to resolve it? Any guidance on proper network checks or configuration adjustments in the emulator would be appreciated.

Answer 1

Hello,

After testing, this problem can be reproduced on the Android emulator.

For this issue, it is recommended that you report it to the official Maui repository to make our development team aware of it.

If you need to test how the program runs when disconnected from the Internet, you can refer to the following two workarounds.

Workaround 1. Turn off the Android emulator's network after launching the app, this way breakpoints in the debugger can be triggered normally.

Workaround 2. If you need to check how the program runs when the network is disconnected, you can enable Release mode to deploy the application. This problem only occurs in Debug mode, and the program can run normally after Release.

Best Regards,

Alec Liu.

---

If the answer is the right solution, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.