imported>TechCorner-Redaktion: Neufassung von "Xamarin: Einrichtung der Entwicklungsumgebung" für .NET MAUI 10 und Visual Studio 2026

2026-10-14T00:00:00Z

Neufassung von "Xamarin: Einrichtung der Entwicklungsumgebung" für .NET MAUI 10 und Visual Studio 2026

Neue Seite

{{Steckbrief
| gilt_fuer = .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.

[[Datei:NET-MAUI-Entwicklungsumgebung.png|thumb|center|750px|.NET-MAUI-Entwicklungsumgebung: Visual Studio 2026 auf dem Windows-PC, per Pair to Mac mit einem Mac mit Xcode gekoppelt.]]

== Was wird benötigt? ==
{| class="wikitable"
! 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 ==
# Visual-Studio-Installer herunterladen und starten (bestehende Installation: ''Ändern'').
# 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.
# Optional die Workload ''ASP.NET- und Webentwicklung'' für Backend-Services ergänzen.
# Installieren und Visual Studio neu starten.

Prüfen in der Kommandozeile:
<syntaxhighlight lang="powershell">
dotnet --list-sdks
dotnet workload list # maui, android, ios, maccatalyst sollten erscheinen
</syntaxhighlight>

== Schritt 2: Android-Emulator einrichten ==
# In Visual Studio ''Extras → Android → Android-Geräte-Manager'' öffnen.
# ''Neu'' → ein aktuelles Pixel-Gerät mit Google-Play-Image anlegen.
# 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 ==
# Auf dem Mac '''Xcode''' aus dem Mac App Store installieren, einmal starten und die Zusatzkomponenten installieren.
# 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]].
# ''Systemeinstellungen → Allgemein → Teilen → Entfernte Anmeldung'' aktivieren (SSH für Pair to Mac).
# Xcode-Befehlszeilentools prüfen:
<syntaxhighlight lang="bash">
xcode-select -p
xcodebuild -version
</syntaxhighlight>

== Schritt 4: Visual Studio mit dem Mac koppeln (Pair to Mac) ==
# Windows-PC und Mac im selben Netz.
# In Visual Studio ''Extras → iOS → Mit Mac koppeln'' öffnen.
# Den Mac auswählen und mit dem macOS-Benutzerkonto anmelden.
# 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.

{{Hinweis|Visual 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 <code>sudo dotnet workload install maui</code> installiert.}}

== Schritt 5: Erste App erstellen und starten ==
<syntaxhighlight lang="bash">
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
</syntaxhighlight>
In Visual Studio genügt es, das Zielframework/Gerät in der Symbolleiste zu wählen und <kbd>F5</kbd> zu drücken.

== Hinweise ==
* '''Versionen festschreiben:''' Teams und Build-Server sollten SDK und Workload per <code>global.json</code> 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 [https://www.max-it.de/development/individuelle-softwareentwicklung/ 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 ==
* [https://learn.microsoft.com/de-de/dotnet/maui/get-started/installation Microsoft Learn: .NET MAUI installieren]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

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

.NET MAUI: Entwicklungsumgebung einrichten - Versionsgeschichte

imported>TechCorner-Redaktion: Neufassung von "Xamarin: Einrichtung der Entwicklungsumgebung" für .NET MAUI 10 und Visual Studio 2026