.NET MAUI: Entwicklungsumgebung einrichten

Auf einen Blick

Gilt für	.NET MAUI 10 (.NET 10 LTS); Visual Studio 2026 (Windows), VS Code mit .NET-MAUI-Erweiterung (macOS/Windows/Linux); Xcode passend zur Workload
Bereich	Softwareentwicklung
Dauer	ca. 1–2 Stunden (inkl. Downloads)
Rechte	Administrator auf Windows-PC und Mac, Apple-ID / Apple-Developer-Konto für Geräte und Store
Stand	Oktober 2026

Die .NET-MAUI-Entwicklungsumgebung einrichten bedeutet: Visual Studio 2026 mit der Workload für .NET MAUI auf einem Windows-PC installieren und – für iOS-Apps – einen Mac mit passender Xcode-Version koppeln. Alternativ entwickeln Sie direkt auf dem Mac mit Visual Studio Code. Diese Anleitung ersetzt die frühere Einrichtung für Xamarin.

.NET-MAUI-Entwicklungsumgebung: Visual Studio 2026 auf dem Windows-PC, per Pair to Mac mit einem Mac mit Xcode gekoppelt.

Was wird benötigt?

Komponente	Zweck	Hinweis
Windows 11 (oder Windows 10 22H2)	Entwicklung für Android und Windows	16 GB RAM empfohlen, Hardware-Virtualisierung für den Android-Emulator
Visual Studio 2026 (Community, Professional oder Enterprise)	IDE inkl. .NET-10-SDK, Android-SDK und Emulator	Community nur für kleine Teams/Open Source kostenlos
Mac mit aktuellem macOS und Xcode	Bauen und Signieren für iOS und macOS	ohne Mac keine iOS-Builds; alternativ Cloud-Mac oder CI
Apple-Developer-Konto	Test auf Geräten mit Verteilung, App Store	99 USD pro Jahr
Google-Play-Developer-Konto	Veröffentlichung im Play Store	einmalig 25 USD

Schritt 1: Visual Studio 2026 installieren

1. Visual-Studio-Installer herunterladen und starten (bestehende Installation: Ändern).
2. Die Workload .NET Multi-Platform App UI-Entwicklung auswählen. Sie enthält das .NET-10-SDK, die MAUI-Workloads, das Android-SDK und einen Android-Emulator.
3. Optional die Workload ASP.NET- und Webentwicklung für Backend-Services ergänzen.
4. Installieren und Visual Studio neu starten.

Prüfen in der Kommandozeile:

dotnet --list-sdks
dotnet workload list            # maui, android, ios, maccatalyst sollten erscheinen

Schritt 2: Android-Emulator einrichten

1. In Visual Studio Extras → Android → Android-Geräte-Manager öffnen.
2. Neu → ein aktuelles Pixel-Gerät mit Google-Play-Image anlegen.
3. In Windows die Hyper-V-basierte Beschleunigung aktivieren (Windows-Features → Windows-Hypervisorplattform), falls Visual Studio danach fragt.

Alternativ ein echtes Android-Gerät per USB mit aktiviertem USB-Debugging verwenden.

Schritt 3: Mac für iOS vorbereiten

1. Auf dem Mac Xcode aus dem Mac App Store installieren, einmal starten und die Zusatzkomponenten installieren.
2. Die Xcode-Version muss zur installierten .NET-for-iOS-Workload passen – sonst bricht der Build mit „This version of .NET for iOS requires Xcode …“ ab. Details: .NET MAUI: Workload-Version und Xcode festlegen.
3. Systemeinstellungen → Allgemein → Teilen → Entfernte Anmeldung aktivieren (SSH für Pair to Mac).
4. Xcode-Befehlszeilentools prüfen:

xcode-select -p
xcodebuild -version

Schritt 4: Visual Studio mit dem Mac koppeln (Pair to Mac)

1. Windows-PC und Mac im selben Netz.
2. In Visual Studio Extras → iOS → Mit Mac koppeln öffnen.
3. Den Mac auswählen und mit dem macOS-Benutzerkonto anmelden.
4. Visual Studio installiert die passenden .NET-Komponenten automatisch auf dem Mac.

Danach stehen iOS-Simulatoren und per USB am Mac angeschlossene iPhones als Debug-Ziele zur Verfügung.

HinweisVisual Studio für Mac wurde am 31. August 2024 eingestellt. Wer direkt auf dem Mac entwickeln möchte, nutzt Visual Studio Code mit den Erweiterungen C# Dev Kit und .NET MAUI. Die Workloads werden dort per sudo dotnet workload install maui installiert.

Schritt 5: Erste App erstellen und starten

dotnet new maui -n MeineApp
cd MeineApp
dotnet build -t:Run -f net10.0-android       # Android-Emulator bzw. Gerät
dotnet build -t:Run -f net10.0-ios            # nur auf dem Mac

In Visual Studio genügt es, das Zielframework/Gerät in der Symbolleiste zu wählen und F5 zu drücken.

Hinweise

• Versionen festschreiben: Teams und Build-Server sollten SDK und Workload per global.json fixieren, damit alle mit derselben Version arbeiten.
• Updates: Visual-Studio-Updates bringen oft neue MAUI-Workloads mit, die eine neuere Xcode-Version voraussetzen. Xcode und Visual Studio daher gemeinsam aktualisieren.
• CI/CD: Für automatisierte Builds eignen sich GitHub Actions oder Azure DevOps mit macOS-Agents.
• Bei Aufbau von Entwicklungsumgebungen und plattformübergreifender App-Entwicklung unterstützt Sie die individuelle Softwareentwicklung von m.a.x. it.

Siehe auch

• Von Xamarin zu .NET MAUI migrieren
• .NET MAUI: Workload-Version und Xcode festlegen
• .NET MAUI: Kein Internet im Android-Emulator
• .NET MAUI: Kein Internet im iOS-Simulator

Links und Quellen

• Microsoft Learn: .NET MAUI installieren
• Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it

Ü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