Hinweis
Visual Studio für Mac wird gemäß Microsoft's Modern Lifecycle Policy bis zum 31. August 2024 eingestellt. Visual Studio für Mac 17.6 wird bis zum 31. August 2024 weiterhin unterstützt. Dies schließt Wartungsupdates für Sicherheitsprobleme und aktualisierte Plattformen von Apple ein. Weitere Informationen, einschließlich alternativer Optionen für die Entwicklung auf einem Mac, finden Sie unter Was passiert mit Visual Studio für Mac?.
Um mit der Entwicklung nativer, plattformübergreifender .NET MAUI-Apps auf macOS zu beginnen, installieren Sie Visual Studio 2022 für Mac 17.6, indem Sie die Installationsschritte befolgen.
Voraussetzungen
Um .NET MAUI-Apps für iOS oder macOS zu erstellen, zu signieren und bereitzustellen, benötigen Sie außerdem:
- Ein Mac, der mit Xcode kompatibel ist. Weitere Informationen finden Sie in der Dokumentation zu Mindestanforderungen von Apple.
- Eine bestimmte Version von Xcode, die von der Version von .NET MAUI abhängt, die Sie verwenden. Weitere Informationen finden Sie unter Releaseversionen.
- Eine Apple ID und eine bezahlte Apple Developer Program Anmeldung. Eine Apple ID ist erforderlich, um Apps auf Geräten bereitzustellen und um Apps im Apple Store einzureichen.
Installation
Um .NET MAUI-Apps zu erstellen, benötigen Sie das neueste Visual Studio für Mac:
Installieren Sie entweder Visual Studio 2022 für Mac, oder ändern Sie Ihre vorhandene Installation und stellen Sie sicher, dass die folgenden Workloads installiert sind:
- .NET
- .NET MAUI
- Android
- iOS
Wichtig
Bei neuen Installationen von Visual Studio 2022 für Mac werden durch die Auswahl des .NET MAUI-Workloads automatisch die Android- und iOS-Workloads ausgewählt, die derzeit für die .NET MAUI-Entwicklung erforderlich sind.
Installieren Sie .NET 8 über das Standalone-Installationsprogramm.
Nachdem die Installation von .NET 8 abgeschlossen ist, führen Sie dotnet workload install maui
in einem Terminal aus.
Wichtig
Um Visual Studio für Mac mit .NET 8 zu verwenden, aktivieren Sie das Kontrollkästchen Visual Studio > Voreinstellungen > Andere > Vorschaufunktionen > .NET 8 SDK verwenden, falls installiert (Neustart erforderlich).
Wenn während der Installation in einer Unternehmensumgebung Netzwerkprobleme auftreten, lesen Sie die Anweisungen unter Installation hinter einer Firewall oder einem Proxy.
Installation hinter einer Firewall oder einem Proxy-Server
Um Visual Studio 2022 für Mac hinter einer Firewall zu installieren, müssen bestimmte Endpunkte zugänglich gemacht werden, um das Herunterladen der erforderlichen Tools und Updates für Ihre Software zu ermöglichen. Weitere Informationen zum Konfigurieren Ihres Netzwerks, um den Zugriff auf die erforderlichen Endpunkte zu ermöglichen, finden Sie unter Installieren und Verwenden von Visual Studio für Mac hinter einer Firewall oder einem Proxy-Server.
Hinweis
Die Unterstützung von .NET MAUI in Visual Studio Code befindet sich noch in der Vorschau. Probieren Sie es aus und teilen Sie uns Ihr Feedback mit!
Installieren Sie Visual Studio Code und die .NET MAUI-Erweiterung
Installieren Sie Visual Studio Code.
Suchen Sie auf der Registerkarte Erweiterungen nach „.NET MAUI“ und installieren Sie die .NET MAUI-Erweiterung. Die .NET MAUI-Erweiterung installiert automatisch das C# Dev Kit und die C# Erweiterungen, die für die Ausführung der .NET MAUI-Erweiterung erforderlich sind.
Hinweis
Die .NET MAUI-Erweiterung erfordert das C# Dev Kit und C#-Vorabversionen. Sie müssen sich bei C# Dev Kit anmelden, um die Funktionen der .NET MAUI-Erweiterung nutzen zu können. Weitere Informationen über das C# Dev Kit und seine Erweiterungen finden Sie in diesem Blogbeitrag.
Installieren von .NET- und .NET MAUI-Workloads
Installieren Sie .NET 8.
Unter Windows wird empfohlen, das Visual Studio-Installationsprogramm zum Verwalten von .NET- und .NET MAUI-Workloadinstallationen zu verwenden. Anweisungen zur Verwendung des Visual Studio-Installationsprogramms finden Sie hier.
Installieren der .NET MAUI-Workload.
Führen Sie unter Windows und macOS den folgenden Befehl in einem Terminal aus:
dotnet workload install maui
Führen Sie unter Linux den folgenden Befehl in einem Terminal aus:
dotnet workload install maui-android
Zum Debuggen einer .NET MAUI-App in Visual Studio Code müssen Sie über eine gültige Zielplattform für das Betriebssystem Ihres Entwicklungscomputers verfügen:
Ihr Betriebssystem |
Unterstützte Zielplattformen |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS und macOS
So debuggen Sie ein iOS- oder macOS-Ziel in Visual Studio Code:
- Installieren Sie die Xcode-Version, die von der verwendeten .NET MAUI-Version benötigt wird. Weitere Informationen finden Sie unter Releaseversionen. Das neueste stabile Xcode-Release kann aus dem Mac App Store heruntergeladen werden.
- Führen Sie
xcode-select --install
in einem Terminal aus, um die Xcode-Befehlszeilentools zu erhalten.
Android
So debuggen Sie ein Android-Ziel in Visual Studio Code:
- Installieren Sie Microsoft OpenJDK 17.
- Installieren Sie das Android SDK über einen der folgenden Ansätze:
- (Empfohlen) Erstellen Sie ein neues .NET MAUI-Projekt (
dotnet new maui
), und verwenden Sie das InstallAndroidDependencies-Ziel.
- Installation über Visual Studio (nur Windows).
- Installation über Android Studio.
- Installieren Sie über Ihren bevorzugten Paket-Manager unter Linux.
Problembehandlung
Beim Einrichten der .NET MAUI-Erweiterung für Visual Studio Code können Probleme auftreten. Wenn Sie nach den unten aufgeführten Schritten zur Fehlerbehebung immer noch Probleme haben, melden Sie ein Problem.
Projekterstellung
Wenn Sie versuchen, ein neues Projekt zu erstellen und der Datei-Explorer in einer Endlosschleife erscheint, wählen Sie möglicherweise keinen leeren Ordner aus. Vergewissern Sie sich, dass keine versteckten Dateien oder Ordner vorhanden sind, erstellen Sie einen neuen Ordner, oder erstellen Sie Ihre .NET MAUI-App über die Befehlszeile mit dotnet new maui
.
Verwenden des InstallAndroidDependencies-Ziels
.NET 8 verfügt über ein Build-Target, das Ihnen beim Einrichten Ihrer Android-Umgebung hilft. Führen Sie den folgenden Befehl in einem Terminal aus, um Ihren Computer zu konfigurieren und Ihre Android-Umgebung einzurichten:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Im obigen Befehl:
AndroidSdkDirectory="<AndroidSdkPath>"
: Installiert oder aktualisiert Android-Abhängigkeiten auf den angegebenen absoluten Pfad.
- Windows: Der vorgeschlagene AndroidSdkPath lautet
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: Der vorgeschlagene AndroidSdkPath lautet
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: installiert Java auf dem angegebenen absoluten Pfad.
AcceptAndroidSDKLicenses=True
: akzeptiert die erforderlichen Android-Lizenzen für die Entwicklung.
Es gibt eine Fehlermeldung, dass das Android SDK oder Java SDK nicht gefunden wurde.
- Öffnen Sie die Befehlspalette (Strg/Cmd + Umschalt + P) und suchen Sie den Befehl
.NET MAUI: Configure Android
. Wählen Sie sowohl „Android SDK-Pfad festlegen“ als auch „Android JDK-Pfad festlegen“ aus und überprüfen Sie, dass sie auf die jeweiligen Installationen verweisen.
- Der Ordner Android SDK sollte Unterordner wie
build-tools
, cmdline-tools
und platform-tools
haben.
- Der Java-OpenJDK-Ordner sollte Unterordner wie
bin
, lib
und andere haben.
- Unter Windows, wenn Sie über Visual Studio installieren, befindet sich das Java SDK in
C:\Program Files\Microsoft\
und das Android SDK in C:\Program Files (x86)\Android\android-sdk
.
- Setzen Sie die Umgebungsvariable
JAVA_HOME
auf einen gültigen Java OpenJDK-Pfad.
- Setzen Sie die Umgebungsvariable
ANDROID_HOME
auf Ihren Android-SDK-Pfad.
- Überprüfen Sie die Mindestversionen der installierten Android-Abhängigkeiten:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- platforms;android-34*
- .NET 7: platform-tools = 33.0.2
- .NET 8: platform-tools = 34.0.5
Es gibt eine Fehlermeldung, dass Android-Lizenzen nicht akzeptiert werden
Navigieren Sie in einer erhöhten Eingabeaufforderung oder einem Terminal zum Ordner cmdline-tools/latest/bin/
Ihres Android SDKs und führen Sie sdkmanager --licenses
aus, dann folgen Sie den CLI-Eingabeaufforderungen.
Meine Android-Abhängigkeiten werden im Projektmappen-Explorer nicht geladen, aber meine App lässt sich problemlos erstellen
Dies ist ein bekanntes Problem bei der Installation auf %APPDATA%
unter Windows und wird in einer zukünftigen Version behoben.
iOS/Xcode-Setup
- Wenn Sie die Fehlermeldung erhalten, dass Xcode nicht gefunden wird, führen Sie
xcode-select --install
in einem Terminal aus und überprüfen Sie dann, ob xcode-select -p
auf Ihre Xcode-Installation verweist.
- Wenn Sie weiterhin Probleme haben, öffnen Sie Xcode selbst, um sicherzustellen, dass es korrekt geladen wird. Sobald Xcode geöffnet ist, navigieren Sie zu Xcode > Einstellungen > Speicherorte und überprüfen Sie, ob das Feld Befehlszeilentools auf das richtige Xcode verweist.
- Es gibt ein bekanntes Problem, bei dem Sie Ihre iOS/MacOS-App manchmal zweimal erstellen müssen, damit sie bereitgestellt werden kann. Dies wird in einem bevorstehenden Release behoben.
Probleme beim Debuggen
- Der Start des Debugging kann aus verschiedenen Gründen fehlschlagen. Wenn im Ausgabefenster kein eindeutiger Fehler angezeigt wird, überprüfen Sie zunächst, ob Sie die „.NET MAUI“-Ausführungskonfiguration in Visual Studio Code verwenden.
- Sie können einen Befehlszeilen-Build vom Terminal aus versuchen, um zu sehen, ob der Fehler bei Ihrem Code oder der .NET MAUI-Erweiterung liegt. Sie können zum Beispiel
dotnet build -f:net8.0-android
ausführen, um zu sehen, ob Ihr Android-Build außerhalb von Visual Studio Code erfolgreich ist. Wenn dieser Build erfolgreich ist gehen Sie zu: Ein Problem melden
Bekannte Einschränkungen
Diese Erweiterung befindet sich noch in einer frühen Phase, sodass es eine Reihe von bekannten Einschränkungen gibt. Bitte geben Sie uns Ihr Feedback zu weiteren Funktionen, die Sie sich wünschen, während wir diese neue Erfahrung weiter ausbauen.
- Die XAML-Bearbeitungsfunktionen sind sehr einfach – Sie erhalten grundlegende Syntaxhervorhebung und automatische Vervollständigung. Wir untersuchen, wie wir die XAML-Erfahrung in einer zukünftigen Version verbessern können.
- Derzeit können Sie das Zielframework für IntelliSense nicht wechseln (es wird nur die Syntaxhervorhebung für das erste in Ihrer .csproj-Datei aufgeführte Zielframework angezeigt). Diese Fähigkeit ist in Arbeit.
- XAML und .NET Hot Reload werden derzeit nicht unterstützt.
- Diese Erweiterung wurde noch nicht vollständig mit den neuesten iOS und Xcode Betas getestet.
Bitte geben Sie uns Ihr Feedback zu weiteren Funktionen, die Sie gerne sehen würden, während wir diese neue Erfahrung weiter ausbauen!
Feedback abgeben
Bitte lesen Sie die C# Dev Kit FAQs und überprüfen Sie die bestehenden Bekannte Probleme, bevor Sie ein neues Problem oder einen Vorschlag einreichen. Sie können Vorschläge und Probleme innerhalb von Visual Studio Code über das Dialogfeld Hilfe > Problem melden einreichen. Stellen Sie sicher, dass Sie „Eine Erweiterung“ und dann die .NET MAUI-Erweiterung in der Dropdown-Liste aus