imported>TechCorner-Redaktion: Neufassung von "Xamarin: Kein Internet auf Android-Emulator": 10.0.2.2, Cleartext, Proxy

2026-10-14T00:00:00Z

Neufassung von "Xamarin: Kein Internet auf Android-Emulator": 10.0.2.2, Cleartext, Proxy

Neue Seite

{{Steckbrief
| gilt_fuer = .NET MAUI 10 bzw. .NET for Android; Android-Emulator (Android 9 bis 16)
| bereich = Softwareentwicklung
| dauer = 5–15 Minuten
| rechte = Entwicklungsumgebung
| stand = Oktober 2026
}}
'''Kein Internet im Android-Emulator''' hat bei .NET-MAUI-Apps meist eine von vier Ursachen: Die App ruft eine unverschlüsselte <code>http://</code>-Adresse auf, verwendet <code>localhost</code> 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.

[[Datei:NET-MAUI-Android-Emulator-Internet.png|thumb|center|750px|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 ==
* <code>HttpClient</code>-Aufrufe enden mit <code>HttpRequestException</code>, „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 <code>localhost</code> auf den Emulator selbst. Der Entwicklungsrechner ist unter '''<code>10.0.2.2</code>''' erreichbar:
<syntaxhighlight lang="csharp">
string baseUrl = DeviceInfo.Platform == DevicePlatform.Android
? "https://10.0.2.2:7001"
: "https://localhost:7001";
</syntaxhighlight>
Der Webservice muss dafür auf allen Adressen lauschen (z. B. <code>https://0.0.0.0:7001</code> bzw. <code>*:7001</code>), nicht nur auf <code>localhost</code>.

=== 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 <code>Platforms/Android/Resources/xml/network_security_config.xml</code>:
<syntaxhighlight lang="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>
</syntaxhighlight>
und dem Verweis im <code>application</code>-Element der <code>Platforms/Android/AndroidManifest.xml</code>:
<syntaxhighlight lang="xml">
<application android:networkSecurityConfig="@xml/network_security_config" ... />
</syntaxhighlight>
Beim selbstsignierten ASP.NET-Core-Entwicklungszertifikat lehnt Android die Verbindung trotzdem ab. Für Tests entweder HTTP mit obiger Ausnahme nutzen oder einen <code>HttpClientHandler</code> 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 <code>AndroidManifest.xml</code> angepasst, prüfen, ob diese Zeilen noch vorhanden sind:
<syntaxhighlight lang="xml">
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
</syntaxhighlight>

== Hinweise ==
* '''Echtes Gerät:''' Ein per USB verbundenes Smartphone erreicht den PC nicht über <code>10.0.2.2</code>, sondern über dessen LAN-IP-Adresse – oder per <code>adb reverse tcp:7001 tcp:7001</code> unter <code>localhost</code>.
* '''Release-Builds:''' Cleartext-Ausnahmen und Zertifikats-Workarounds dürfen nicht in die veröffentlichte App gelangen.
* '''Netzwerkstatus in der App:''' Mit <code>Connectivity.Current.NetworkAccess</code> 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 [https://www.max-it.de/development/individuelle-softwareentwicklung/ individuelle Softwareentwicklung von m.a.x. it].

== Siehe auch ==
* [[.NET MAUI: Kein Internet im iOS-Simulator]]
* [[.NET MAUI: Entwicklungsumgebung einrichten]]
* [[Proxy]]

== Links und Quellen ==
* [https://learn.microsoft.com/de-de/dotnet/maui/data-cloud/local-web-services Microsoft Learn: Verbindung mit lokalen Webdiensten aus Android-Emulatoren und iOS-Simulatoren]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

{{Uebermax}}
[[Kategorie:Softwareentwicklung]]

.NET MAUI: Kein Internet im Android-Emulator - Versionsgeschichte

imported>TechCorner-Redaktion: Neufassung von "Xamarin: Kein Internet auf Android-Emulator": 10.0.2.2, Cleartext, Proxy