.NET MAUI: Kein Internet im Android-Emulator

Aus maxTechCorner

Auf einen Blick

Gilt für.NET MAUI 10 bzw. .NET for Android; Android-Emulator (Android 9 bis 16)
BereichSoftwareentwicklung
Dauer5–15 Minuten
RechteEntwicklungsumgebung
StandOktober 2026

Kein Internet im Android-Emulator hat bei .NET-MAUI-Apps meist eine von vier Ursachen: Die App ruft eine unverschlüsselte http://-Adresse auf, verwendet localhost statt der Emulator-Adresse des Entwicklungsrechners, ein Firmen-Proxy fehlt im Emulator, oder der Emulator hat selbst keine Netzwerkverbindung. Diese Anleitung prüft alle vier der Reihe nach.

Kein Internet im Android-Emulator: Der Entwicklungs-PC ist unter 10.0.2.2 erreichbar, nicht unter localhost; dazu HTTPS bzw. Cleartext-Ausnahme und Internet-Berechtigung prüfen.

Problem

  • HttpClient-Aufrufe enden mit HttpRequestException, „Connection refused“, „Cleartext HTTP traffic … not permitted“ oder einer Zeitüberschreitung.
  • Der lokale Entwicklungs-Webservice ist im Browser des PCs erreichbar, aus der App im Emulator aber nicht.

Lösung

Schritt 1: Hat der Emulator überhaupt Internet?

Im Emulator den Chrome-Browser öffnen und eine Website aufrufen. Klappt das nicht:

  • Emulator mit Cold Boot neu starten (Android-Geräte-Manager → Kaltstart).
  • VPN-Clients und Endpoint-Firewalls auf dem PC testweise deaktivieren – sie blockieren häufig den virtuellen Netzwerkadapter.
  • Bei Firmen-Proxy: Im Emulator über die drei Punkte (…) → Settings → Proxy den Proxy eintragen (Manual proxy configuration mit Host und Port).

Schritt 2: localhost durch 10.0.2.2 ersetzen

Im Emulator zeigt localhost auf den Emulator selbst. Der Entwicklungsrechner ist unter 10.0.2.2 erreichbar: 

string baseUrl = DeviceInfo.Platform == DevicePlatform.Android
    ? "https://10.0.2.2:7001"
    : "https://localhost:7001";

Der Webservice muss dafür auf allen Adressen lauschen (z. B. https://0.0.0.0:7001 bzw. *:7001), nicht nur auf localhost.

Schritt 3: HTTPS verwenden oder HTTP gezielt erlauben

Seit Android 9 blockiert Android unverschlüsselten HTTP-Verkehr. Richtig ist HTTPS. Nur für die lokale Entwicklung kann HTTP zu bestimmten Adressen erlaubt werden – mit einer Netzwerk-Sicherheitskonfiguration in Platforms/Android/Resources/xml/network_security_config.xml: 

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <domain-config cleartextTrafficPermitted="true">
    <domain includeSubdomains="true">10.0.2.2</domain>
  </domain-config>
</network-security-config>

und dem Verweis im application-Element der Platforms/Android/AndroidManifest.xml: 

<application android:networkSecurityConfig="@xml/network_security_config" ... />

Beim selbstsignierten ASP.NET-Core-Entwicklungszertifikat lehnt Android die Verbindung trotzdem ab. Für Tests entweder HTTP mit obiger Ausnahme nutzen oder einen HttpClientHandler verwenden, der das Zertifikat nur im Debug-Build akzeptiert.

Schritt 4: Internet-Berechtigung prüfen

Die .NET-MAUI-Vorlage trägt die Berechtigungen bereits ein. Wurde die AndroidManifest.xml angepasst, prüfen, ob diese Zeilen noch vorhanden sind: 

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Hinweise

  • Echtes Gerät: Ein per USB verbundenes Smartphone erreicht den PC nicht über 10.0.2.2, sondern über dessen LAN-IP-Adresse – oder per adb reverse tcp:7001 tcp:7001 unter localhost.
  • Release-Builds: Cleartext-Ausnahmen und Zertifikats-Workarounds dürfen nicht in die veröffentlichte App gelangen.
  • Netzwerkstatus in der App: Mit Connectivity.Current.NetworkAccess prüfen, ob eine Verbindung besteht, und dem Benutzer eine verständliche Meldung anzeigen.
  • Bei App-Entwicklung und der Anbindung an Ihre Backend-Systeme unterstützt Sie die individuelle Softwareentwicklung von m.a.x. it.

Siehe auch

Links und Quellen


Über m.a.x. it Die m.a.x. Informationstechnologie AG ist seit über 30 Jahren IT-Partner mittelständischer und großer Unternehmen in München und bietet maßgeschneiderte Lösungen und Services in den Bereichen Cloud, Cybersecurity, Netzwerk, Windows, Linux und Softwareentwicklung. Sie haben eine Frage zu diesem Artikel oder brauchen Unterstützung? Kontakt aufnehmen

Abgerufen von „http://techcorner.max-it.de/index.php?title=.NET_MAUI:_Kein_Internet_im_Android-Emulator&oldid=4297“