Installation

Für die Entwicklung nativer, plattformübergreifender .NET Multi-Platform App UI (.NET MAUI)-Apps ist Visual Studio 2022 17.12 oder höher oder der neueste Visual Studio Code mit der .NET MAUI-Erweiterung erforderlich.

Visual Studio

Um mit der Entwicklung nativer, plattformübergreifender .NET MAUI-Apps unter Windows zu beginnen, installieren Sie Visual Studio 2022 17.12 oder höher, indem Sie die Installationsschritte befolgen.

Voraussetzungen

• Visual Studio 2022 17.12 oder höher. Informationen über unterstützte Betriebssysteme, Hardware, unterstützte Sprachen und zusätzliche Anforderungen und Hinweise finden Sie unter Systemanforderungen für Visual Studio 2022.

Zum Erstellen, Signieren und Bereitstellen von .NET MAUI-Apps für iOS und Mac Catalyst benötigen Sie außerdem Folgendes:

• 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.

Alternativ können Sie auch Debug-Builds Ihrer App direkt von Windows auf Ihrem iOS-Gerät mit Hot Restart bereitstellen:

• Ein Apple-Entwicklerkonto und eine bezahlte Apple Developer Program Anmeldung.

Installation

1. Zum Erstellen von .NET MAUI-Apps müssen Sie die neueste Version von Visual Studio 2022 herunterladen:

   • Visual Studio Community 2022 herunterladen

   • Visual Studio Professional 2022 herunterladen

   • Visual Studio Enterprise 2022 herunterladen

2. Installieren Sie Visual Studio, oder ändern Sie Ihre vorhandene Installation über das Visual Studio-Installationsprogramm, und installieren Sie die Entwicklungsarbeitslast der .NET Multiplattform-App-Benutzeroberfläche mit den standardmäßigen optionalen Installationsoptionen:

   

Visual Studio Code

Um mit der Entwicklung nativer plattformübergreifender .NET MAUI-Apps unter Windows, macOS oder Linux zu beginnen, installieren Sie den neuesten Visual Studio Code, indem Sie die Installationsschritte ausführen.

Voraussetzungen

Zum Erstellen, Signieren und Bereitstellen von .NET MAUI-Apps für iOS und Mac Catalyst benötigen Sie Folgendes:

• 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.

Installieren von Visual Studio Code

1. Zum Erstellen von .NET MAUI-Apps müssen Sie die neueste Version von Visual Studio Code herunterladen:

   • Visual Studio Code herunterladen

2. Installieren Sie Visual Studio Code. Ausführliche Anweisungen zum Installieren von Visual Studio Code finden Sie unter Visual Studio Code unter Windows, Visual Studio Code unter macOSund Visual Studio Code unter Linux.

Installieren der .NET MAUI-Erweiterung

Bevor Sie .NET MAUI-Apps in Visual Studio Code erstellen können, müssen Sie die .NET MAUI-Erweiterung installieren:

1. Starten Sie Visual Studio Code.

2. Navigieren Sie in Visual Studio Code zur Registerkarte Erweiterungen und suchen Sie nach ".NET MAUI". Wählen Sie dann die .NET MAUI--Erweiterung aus, und installieren Sie sie, indem Sie die Schaltfläche Installieren drücken:

   

   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. Weitere Informationen zu C# Dev Kit finden Sie unter C#Dev Kit für Visual Studio Code.

Verbinden Ihres Kontos mit C# Dev Kit

Wenn Sie C# Dev Kit verwenden, müssen Sie sich mit einem Microsoft-Konto anmelden, das über ein aktives Visual Studio-Abonnement verfügt:

1. Drücken Sie auf der Registerkarte Willkommen für die ersten Schritte mit .NET MAUI auf die Schaltfläche Verbinden:

   

   Folgen Sie den Anweisungen, um sich bei Ihrem Microsoft-Konto anzumelden. Weitere Informationen finden Sie unter Anmelden beim C# Dev Kit.

Weitere Informationen zur C#Dev Kit-Lizenzierung finden Sie unter C# Dev Kit – häufig gestellte Fragen.

Einrichten Ihrer .NET-Umgebung

Sie benötigen das .NET SDK, das auf Ihrem Computer installiert ist, um .NET MAUI-Apps zu entwickeln. Wenn das .NET SDK nicht auf Ihrem Computer installiert ist, besteht der bevorzugte Ansatz für die Installation unter Windows im Visual Studio Installer. Weitere Informationen finden Sie unter Installation.

Alternativ können Sie das .NET SDK manuell installieren:

1. Laden Sie das .NET-Installationsprogramm herunter.

2. Installieren Sie das .NET SDK, indem Sie das .NET-Installationsprogramm ausführen. Weitere Informationen finden Sie unter Installieren von .NET unter Windows, Linux und macOS.

   Tipp

   Unter Linux können Sie das .NET SDK mithilfe der Skriptinstallationsanweisungeninstallieren.

So überprüfen Sie, ob das .NET SDK installiert ist:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal den folgenden Befehl aus:

   dotnet --version
   

   Sie sollten die Version des .NET SDK sehen, das Sie installiert haben.

   Hinweis

   Möglicherweise müssen Sie Den Computer neu starten, bevor Sie überprüfen, ob das .NET SDK installiert ist.

Richten Sie Ihre .NET MAUI-Umgebung ein

Sie benötigen das .NET MAUI SDK, das auf Ihrem Computer installiert ist, um .NET MAUI-Apps zu entwickeln. Wenn das .NET MAUI SDK nicht auf Ihrem Computer installiert ist, besteht der bevorzugte Ansatz für die Installation unter Windows im Visual Studio Installer. Weitere Informationen finden Sie unter Installation.

Alternativ können Sie das .NET MAUI SDK manuell installieren:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal unter Windows den folgenden Befehl aus:

   dotnet workload install maui
   

   Führen Sie im Terminal unter macOS den folgenden Befehl aus:

   sudo dotnet workload install maui
   

   Führen Sie im Terminal unter Linux den folgenden Befehl aus:

   dotnet workload install maui-android
   

So überprüfen Sie, ob das .NET MAUI SDK installiert ist:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal den folgenden Befehl aus:

   dotnet workload list
   

   Unter Windows und macOS sollte neben der installierten Version die maui Workload ID angezeigt werden. Wenn Sie es jedoch über den Visual Studio Installer unter Windows installiert haben, werden die folgenden Workload-IDs aufgeführt:

   android
   maui-windows
   maccatalyst
   ios
   

   Unter Linux sollte die Workload-ID maui-android zusammen mit der installierten Version aufgeführt sein.

Einrichten von Zielplattformen

Zum Erstellen und Debuggen einer .NET MAUI-App benötigen Sie eine gültige Zielplattform im Verhältnis zum Betriebssystem Ihres Entwicklungscomputers. In der folgenden Tabelle sind die unterstützten Zielplattformen auf den einzelnen Betriebssystemen aufgeführt:

Ihr Betriebssystem	Unterstützte Zielplattformen
Fenster	Windows, Android
macOS	Android, iOS, macOS
Linux	Android

Zum Erstellen einer .NET MAUI-App für Android und für Apple-Plattformen müssen Sie zusätzliche Einrichtung und Konfiguration durchführen.

Android

So richten Sie Ihren Computer für die .NET MAUI-Entwicklung unter Android mit Visual Studio Code ein:

• Laden Sie das Java SDK herunter, und installieren Sie es. Weitere Informationen finden Sie unter Herunterladen und Installieren des Java JDK-.
• Laden Sie das Android SDK herunter, und installieren Sie es. Weitere Informationen finden Sie unter Herunterladen und Installieren des Android SDK.
• Laden Sie einen Android-Emulator herunter, und installieren Sie diesen. Weitere Informationen finden Sie unter Herunterladen und Installieren eines Android-Emulators.

Herunterladen und Installieren des Java SDK

Um das Java SDK herunterzuladen und zu installieren sowie Visual Studio Code für dessen Verwendung zu konfigurieren:

1. Laden Sie Microsoft OpenJDK 17herunter, und installieren Sie sie. Informationen zur Installation von OpenJDK finden Sie unter Installieren Sie den Microsoft Build von OpenJDK.

   Alternativ dazu können Sie, anstatt das Java SDK manuell herunterzuladen und zu installieren, das Build-Target InstallAndroidDependencies verwenden, um das Java SDK (und das Android SDK) zu installieren. Weitere Informationen finden Sie unter Verwenden des InstallAndroidDependencies-Ziels.

   Wichtig

   Stellen Sie sicher, dass Sie den Speicherort beachten, an dem OpenJDK installiert wurde, da dies im nächsten Schritt erforderlich ist.

2. Stellen Sie sicher, dass Sie den Pfad zu OpenJDK über einen der folgenden Ansätze konfiguriert haben:

   1. Legen Sie die umgebungsvariable JAVA_HOME fest, um den Java SDK-Pfad für Ihren Computer zu definieren. Dies ist der empfohlene Ansatz, der den Java SDK-Pfad auf Computerebene definiert.

      Hinweis

      Wenn Sie das OpenJDK unter Windows über MSI installieren, können Sie die Option wählen, dass der Installer die JAVA_HOME-Umgebungsvariable setzt.

   2. Drücken Sie in Visual Studio Code STRG+UMSCHALT+P unter Windows oder Cmd+UMSCHALT+P unter macOS und wählen Sie dann .NET MAUI: Android konfigurieren, danach Java SDK-Speicherort, um den Java SDK-Pfad auf Benutzer-/Arbeitsbereichebene festzulegen.

   3. Konfigurieren Sie den Java SDK-Pfad in Ihrer .csproj-Datei, indem Sie die $(JavaSdkDirectory) MSBuild-Eigenschaft auf den OpenJDK-Pfad festlegen. Dadurch wird der Java SDK-Pfad auf Projektebene definiert.

Herunterladen und Installieren des Android SDK

Laden Sie das Android SDK herunter, installieren Sie es und konfigurieren Sie Visual Studio Code für die Nutzung:

1. Laden Sie das Android SDK über eine der folgenden Ansätze herunter, und installieren Sie es:

   1. Laden Sie das Android SDK herunter und installieren Sie es, indem Sie ein neues .NET MAUI-Projekt erstellen und dann das Build-Target InstallAndroidDependencies verwenden, um Ihre Android-Umgebung einzurichten. Dies ist der empfohlene Ansatz. Weitere Informationen finden Sie unter Verwenden des InstallAndroidDependencies-Ziels.
   2. Laden Sie das Android SDK unter Windows herunter und installieren Sie es, indem Sie den Workload für die .NET MAUI-Entwicklung in Visual Studio installieren und dann eine .NET MAUI App auf Android erstellen und ausführen. Dieser Vorgang stellt sicher, dass das Android SDK und ein Android-Emulator installiert sind.
   3. Laden Sie das Android SDK über Android Studio herunter, und installieren Sie es. Weitere Informationen finden Sie unter Android Studio installieren auf developer.android.com.
   4. Laden Sie das Android SDK über Ihren bevorzugten Paket-Manager unter Linux herunter, und installieren Sie es.

2. Stellen Sie sicher, dass Sie den Pfad zum Android SDK über eine der folgenden Ansätze konfiguriert haben:

   1. Legen Sie die ANDROID_HOME Umgebungsvariable fest, um den Android SDK-Pfad für Ihren Computer zu definieren. Dies ist der empfohlene Ansatz, der den Android SDK-Pfad auf Computerebene definiert.
   2. Drücken Sie in Visual Studio Code STRG+UMSCHALT+P unter Windows oder CMD+UMSCHALT+P unter macOS, und wählen Sie dann .NET MAUI: Android konfigurieren, gefolgt von Android SDK-Speicherort , um den Android SDK-Pfad auf Benutzer-/Arbeitsbereichsebene festzulegen.
   3. Konfigurieren Sie den Android SDK-Pfad in Ihrer .csproj-Datei, indem Sie die $(AndroidSdkDirectory) MSBuild-Eigenschaft auf den Android SDK-Pfad festlegen. Dadurch wird der Android SDK-Pfad auf Projektebene definiert.

3. Stellen Sie in Visual Studio Code sicher, dass Ihre Android-Umgebung ordnungsgemäß konfiguriert ist, indem Sie STRG+UMSCHALT+P unter Windows oder CMD+UMSCHALT+P unter macOS drücken und dann .NET MAUI auswählen: Android konfigurieren, gefolgt von "Android aktualisieren". Alle erkannten Fehler müssen behoben werden:

   • Wählen Sie in der Befehlspalette .NET MAUI: Android konfigurieren, gefolgt von Android SDK-Speicherort auswählen und Android SDK-Speicherort auswählen und überprüfen Sie, ob diese korrekt auf die jeweiligen Installationen verweisen. Wenn Sie die SDKs über Visual Studio installieren, befindet sich OpenJDK unter C:\Program Files\Microsoft und das Android SDK befindet sich unter C:\Program Files (x86)\Android\android-sdk.
   • Stellen Sie sicher, dass Ihr Android SDK-Ordner Unterordner wie Buildtools, cmdline-Toolsund Plattformtoolsenthält.
   • Stellen Sie sicher, dass Ihr OpenJDK-Ordner Unterordner wie bin, libusw. enthält.
   • Stellen Sie sicher, dass die ANDROID_HOME-Umgebungsvariable auf Ihren Android SDK-Pfad festgelegt ist.
   • Stellen Sie sicher, dass die JAVA_HOME-Umgebungsvariable auf den Pfad Ihres Java SDK festgelegt ist.
   • Wenn die Android-Lizenzen nicht akzeptiert wurden, navigieren Sie in einem erhöhten Terminal zum Ordner cmdline-tools/{version}/bin Ihres Android SDK und führen Sie sdkmanager --licenses aus und folgen Sie dann den CLI-Prompts.

Verwenden des InstallAndroidDependencies-Ziels

Der empfohlene Ansatz zum Installieren der erforderlichen Abhängigkeiten für Ihr .NET MAUI-Projekt unter Android ist es, das InstallAndroidDependencies MSBuild-Target auszuführen. Dieses Ziel installiert das Android SDK für Sie, wenn es noch nicht installiert ist.

Erstellen Sie in einem Terminal ein neues .NET MAUI-Projekt:

dotnet new maui -n "MyMauiApp"

Wechseln Sie in einem Terminal in das Verzeichnis MyMauiApp und bauen Sie die App unter Angabe des InstallAndroidDependencies Build-Ziels:

cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True

Hinweis

Das InstallAndroidDependencies MSBuild-Ziel kann auch das Java SDK installieren, wenn die JavaSdkDirectory MSBuild-Eigenschaft angegeben ist.

Im obigen Befehl:

• -p:AndroidSdkDirectory="/path/to/sdk": Installiert oder aktualisiert Android-Abhängigkeiten auf den angegebenen absoluten Pfad. Vorgeschlagene Pfade sind %LOCALAPPDATA%/Android/Sdk unter Windows und $HOME/Library/Android/sdk unter macOS.
• -p:AcceptAndroidSDKLicenses=True akzeptiert die erforderlichen Android-Lizenzen für die Entwicklung.
• (optional) -p:JavaSdkDirectory="/path/to/sdk" installiert das Java SDK an dem angegebenen absoluten Pfad.

Vermeiden Sie die Verwendung von Pfaden, die Leerzeichen oder Nicht-ASCII-Zeichen enthalten.

Herunterladen und Installieren eines Android-Emulators

So laden und installieren Sie einen Android-Emulator herunter, auf dem Sie Ihre Apps ausführen können:

1. Navigieren Sie in einem Terminal zu {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. Verwenden Sie in einem Terminal den Befehl sdkmanager, um einen Android-Emulator herunterzuladen und zu installieren:

   Führen Sie unter Windows die folgenden Befehle aus:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-35;google_apis;x86_64"
   

   Führen Sie unter macOS die folgenden Befehle aus:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
   

   Hinweis

   Der obige Befehl geht von einem Apple Silicon Mac aus. Ersetzen Sie für einen Intel Mac arm64-v8a durch x86_64.

   Weitere Informationen zum sdkmanager-Befehl finden Sie unter sdkmanager auf developer.android.com.

3. Verwenden Sie in einem Terminal den Befehl avdmanager, um einen neuen Android-Emulator zu erstellen:

   Führen Sie unter Windows die folgenden Befehle aus:

   avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
   

   Führen Sie unter macOS die folgenden Befehle aus:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
   

   Hinweis

   Der obige Befehl geht von einem Apple Silicon Mac aus. Ersetzen Sie für einen Intel Mac arm64-v8a durch x86_64.

   Weitere Informationen zum Befehl avdmanager finden Sie unter avdmanager auf developer.android.com.

iOS und macOS

So richten Sie Ihren Mac für .NET MAUI-Entwicklung unter iOS und Mac Catalyst mit Visual Studio Code ein:

1. 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 Apple App Store heruntergeladen werden.

2. Führen Sie in einem Terminal den folgenden Befehl aus, um die Xcode-Befehlszeilentools zu erhalten:

   xcode-select --install
   

3. Starten Sie Xcode, und akzeptieren Sie alle Lizenzverträge. Wenn sich die Simulatoren nicht installieren lassen, navigieren Sie zu Xcode > Einstellungen > Komponenten und legen Sie die Laufzeiten für den gewählten Simulator fest.

4. Stellen Sie in Visual Studio Code sicher, dass Ihre Apple-Umgebung ordnungsgemäß konfiguriert ist, indem Sie Cmd+Shift+P drücken und dann .NET MAUI: Apple konfigurieren auswählen, gefolgt von Apple-Umgebung aktualisieren. Alle erkannten Fehler müssen behoben werden:

   • Stellen Sie sicher, dass Sie xcode-select --install in einem Terminal ausgeführt haben.
   • Wenn Sie einen Fehler erhalten, dass Xcode nicht gefunden wurde, führen Sie xcode-select -p in einem Terminal aus, und überprüfen Sie, ob sie einen Pfad zu Ihrer Xcode-Installation zurückgibt.
   • Öffnen Sie Xcode, um sicherzustellen, dass es ordnungsgemäß geladen wird, und navigieren Sie dann zu Xcode-> Einstellungen > Speicherort. Überprüfen Sie, ob das Feld Befehlszeilentools auf die richtige Xcode-Installation verweist.

Problembehandlung

Wenn beim Installieren der .NET MAUI-Erweiterung in Visual Studio Code Probleme auftreten, finden Sie weitere Informationen zu den Problemen, indem Sie zum Ausgabefenster navigieren (STRG+UMSCHALT+U unter Windows oder Cmd+UMSCHALT+U unter macOS) und .NET MAUI in der Dropdownliste auswählen.

Feedback geben

Um von Visual Studio Code aus Feedback zur .NET MAUI Erweiterung zu liefern, navigieren Sie zum Dialog Hilfe > Problem melden. Stellen Sie dann sicher, dass Sie "Fehlerbericht" als Wert des Dropdown-Menüs Dies ist ein, "Eine VS Code Erweiterung" als Wert des Dropdown-Menüs Für und ".NET MAUI" als Wert des Dropdown-Menüs Erweiterung auswählen:

Visual Studio Code (Experimental)

Voraussetzungen

Zum Erstellen, Signieren und Bereitstellen von .NET MAUI-Apps für iOS und Mac Catalyst benötigen Sie Folgendes:

• 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.

Um mit der Entwicklung nativer plattformübergreifender .NET MAUI-Apps unter Windows, macOS oder Linux zu beginnen, installieren Sie den neuesten Visual Studio Code, indem Sie die Installationsschritte ausführen.

Zum Erstellen und Debuggen einer .NET MAUI-App benötigen Sie eine gültige Zielplattform im Verhältnis zum Betriebssystem Ihres Entwicklungscomputers. In der folgenden Tabelle sind die unterstützten Zielplattformen auf den einzelnen Betriebssystemen aufgeführt:

Ihr Betriebssystem	Unterstützte Zielplattformen
Fenster	Windows, Android
macOS	Android, iOS, macOS
Linux	Android

Installieren von Visual Studio Code

1. Zum Erstellen von .NET MAUI-Apps müssen Sie die neueste Version von Visual Studio Code herunterladen:

   • Visual Studio Code herunterladen

2. Installieren Sie Visual Studio Code. Ausführliche Anweisungen zum Installieren von Visual Studio Code finden Sie unter Visual Studio Code unter Windows, Visual Studio Code unter macOSund Visual Studio Code unter Linux.

Installieren der .NET MAUI-Erweiterung

Bevor Sie .NET MAUI-Apps in Visual Studio Code erstellen können, müssen Sie die .NET MAUI-Erweiterung installieren:

1. Starten Sie Visual Studio Code.

2. Navigieren Sie in Visual Studio Code zur Registerkarte Erweiterungen und suchen Sie nach ".NET MAUI". Wählen Sie dann die .NET MAUI--Erweiterung aus, und installieren Sie sie, indem Sie die Schaltfläche Installieren drücken:

   

   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. Weitere Informationen zu C# Dev Kit finden Sie unter C#Dev Kit für Visual Studio Code.

Folgen Sie den Anweisungen der exemplarischen Vorgehensweise.

Nachdem Sie die .NET MAUI-Erweiterung installiert haben, werden Sie von der .NET MAUI Einführung "Erste Schritte mit .NET MAUI" begrüßt.

Wichtig

Um auf die verbesserte Einrichtungsumgebung zuzugreifen, muss die Maui-Konfiguration > : Verbesserte Setup-Einstellungaktiviert sein.

Klicken Sie durch, und folgen Sie den Anweisungen in jedem Schritt, um Ihre .NET MAUI-Umgebung und Zielplattformen vollständig zu konfigurieren:

1. Verbinden Ihres Kontos mit der C#Dev Kit-Erweiterung
2. Einrichten Ihrer .NET-Umgebung
3. Einrichten Ihrer .NET MAUI-Umgebung
4. Einrichten Ihrer iOS- und macOS-Umgebung
5. Einrichten Ihrer Android-Umgebung

Hinweis

Sie müssen auf einem Mac arbeiten, um den Schritt Einrichten Ihrer iOS- und macOS-Umgebung sehen und befolgen zu können.

Der Schritt "Einrichten Ihrer Android-Umgebung " richtet alles ein, was Sie benötigen, um mit Android als Zielplattform erfolgreich zu sein, und der Schritt "Einrichten Ihrer iOS- und macOS-Umgebung " richtet alles ein, was Sie benötigen, um mit iOS und Mac als Zielplattformen erfolgreich zu sein.

Auf diese Anleitung kann auch über die Befehlsleiste zugegriffen werden. Wählen Sie Willkommen: Walkthrough öffnen... und danach Erste Schritte mit .NET MAUI aus.

Zugriff auf das verbesserte Einrichtungserlebnis

1. Drücken Sie in Visual Studio Code STRG+UMSCHALT+P unter Windows oder CMD+UMSCHALT+P unter macOS, und wählen Sie Preferences: Einstellungen öffnen (UI) aus.

   

2. Navigieren Sie zu Erweiterungen > .NET MAUI und aktivieren Sie die Einstellung Maui-Konfiguration >: Optimierte Einrichtungserfahrung.

   

3. Kehren Sie zur exemplarischen Vorgehensweise " Erste Schritte mit .NET MAUI " zurück. Vergewissern Sie sich, dass Sie Ihre Android-Umgebung einrichten neben anderen Schritten in der exemplarischen Vorgehensweise sehen können.

   

Verbinden Ihres Kontos mit C# Dev Kit

Wenn Sie C# Dev Kit verwenden, müssen Sie sich mit einem Microsoft-Konto anmelden, das über ein aktives Visual Studio-Abonnement verfügt:

1. Drücken Sie auf der Registerkarte Willkommen für die ersten Schritte mit .NET MAUI auf die Schaltfläche Verbinden:

   

   Folgen Sie den Anweisungen, um sich bei Ihrem Microsoft-Konto anzumelden. Weitere Informationen finden Sie unter Anmelden beim C# Dev Kit.

Weitere Informationen zur C#Dev Kit-Lizenzierung finden Sie unter C# Dev Kit – häufig gestellte Fragen.

Einrichten Ihrer .NET-Umgebung

Sie benötigen das .NET SDK, das auf Ihrem Computer installiert ist, um .NET MAUI-Apps zu entwickeln. Wenn das .NET SDK nicht auf Ihrem Computer installiert ist, besteht der bevorzugte Ansatz für die Installation unter Windows im Visual Studio Installer. Weitere Informationen finden Sie unter Installation.

Alternativ können Sie das .NET SDK manuell installieren:

1. Laden Sie das .NET-Installationsprogramm herunter.

2. Installieren Sie das .NET SDK, indem Sie das .NET-Installationsprogramm ausführen. Weitere Informationen finden Sie unter Installieren von .NET unter Windows, Linux und macOS.

   Tipp

   Unter Linux können Sie das .NET SDK mithilfe der Skriptinstallationsanweisungeninstallieren.

So überprüfen Sie, ob das .NET SDK installiert ist:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal den folgenden Befehl aus:

   dotnet --version
   

   Sie sollten die Version des .NET SDK sehen, das Sie installiert haben.

   Hinweis

   Möglicherweise müssen Sie Den Computer neu starten, bevor Sie überprüfen, ob das .NET SDK installiert ist.

Richten Sie Ihre .NET MAUI-Umgebung ein

Sie benötigen das .NET MAUI SDK, das auf Ihrem Computer installiert ist, um .NET MAUI-Apps zu entwickeln. Wenn das .NET MAUI SDK nicht auf Ihrem Computer installiert ist, besteht der bevorzugte Ansatz für die Installation unter Windows im Visual Studio Installer. Weitere Informationen finden Sie unter Installation.

Alternativ können Sie das .NET MAUI SDK manuell installieren:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal unter Windows den folgenden Befehl aus:

   dotnet workload install maui
   

   Führen Sie im Terminal unter macOS den folgenden Befehl aus:

   sudo dotnet workload install maui
   

   Führen Sie im Terminal unter Linux den folgenden Befehl aus:

   dotnet workload install maui-android
   

So überprüfen Sie, ob das .NET MAUI SDK installiert ist:

1. Öffnen Sie ein Terminal.

2. Führen Sie im Terminal den folgenden Befehl aus:

   dotnet workload list
   

   Unter Windows und macOS sollte neben der installierten Version die maui Workload ID angezeigt werden. Wenn Sie es jedoch über den Visual Studio Installer unter Windows installiert haben, werden die folgenden Workload-IDs aufgeführt:

   android
   maui-windows
   maccatalyst
   ios
   

   Unter Linux sollte die Workload-ID maui-android zusammen mit der installierten Version aufgeführt sein.

Einrichten Ihrer Android-Umgebung

Um Ihre Android-Entwicklungsumgebung einzurichten, klicken Sie einfach im Schritt "Android-Umgebung einrichten" auf die Schaltfläche "Android-Umgebung konfigurieren", um den vollständigen Android-Kaufablauf einzugeben.

Der Android-Installationsprozess analysiert Ihre Android-Umgebung und bietet an, alle fehlenden Komponenten zu installieren.

• Android SDK und Java SDK: Android SDK- und Java SDK-Komponenten sind erforderlich.

  • Der Android-Kaufablauf fordert Sie auf, diese Komponenten direkt zu installieren oder eine bereits vorhandene Installation auszuwählen.

    

  • Informationen zum manuellen Installieren und Konfigurieren von Android finden Sie in den Anweisungen zum manuellen Installieren und Konfigurieren ihrer SDK- und JDK-Installationen.

• Android-Emulator: Das Installieren eines Android-Emulators wird empfohlen und ist erforderlich, wenn kein physisches Gerät vorhanden ist.

  • Der Android-Akquisitionsablauf fordert Sie auf, einen Standardemulator direkt zu installieren.

    

  • Um Emulatoren weiter zu konfigurieren, befolgen Sie die Anweisungen zum manuellen Installieren eines Android-Emulators.

Wichtig

Android-Lizenzen müssen manuell überprüft und im Terminal akzeptiert werden. Wenn Sie dazu aufgefordert werden, überprüfen Sie jede Lizenz. Geben Sie 'y' ein, und drücken Sie die EINGABETASTE, um dies zu akzeptieren.

Wenn Ihre Android-Umgebung ordnungsgemäß konfiguriert wurde, werden Sie benachrichtigt: „Ihre Android-Umgebung für .NET MAUI ist bereit!“

Zeigen Sie den Ausgabebereich an, um weitere Details zum Android-Umgebungsstatus anzuzeigen.

Einrichten Ihrer iOS- und macOS-Umgebung

So richten Sie Ihren Mac für .NET MAUI-Entwicklung unter iOS und Mac Catalyst mit Visual Studio Code ein:

1. 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 Apple App Store heruntergeladen werden.

2. Führen Sie in einem Terminal den folgenden Befehl aus, um die Xcode-Befehlszeilentools zu erhalten:

   xcode-select --install
   

3. Starten Sie Xcode, und akzeptieren Sie alle Lizenzverträge. Wenn sich die Simulatoren nicht installieren lassen, navigieren Sie zu Xcode > Einstellungen > Komponenten und legen Sie die Laufzeiten für den gewählten Simulator fest.

4. Vergewissern Sie sich in Visual Studio Code, dass Ihre Xcode-Umgebung einfach konfiguriert ist, indem Sie im Schritt "Einrichten Ihrer iOS- und macOS-Umgebung" auf "iOS- und macOS-Umgebung konfigurieren" klicken.

Alle erkannten Fehler müssen behoben werden:

• Stellen Sie sicher, dass Sie xcode-select --install in einem Terminal ausgeführt haben.
• Wenn Sie einen Fehler erhalten, dass Xcode nicht gefunden wurde, führen Sie xcode-select -p in einem Terminal aus, und überprüfen Sie, ob sie einen Pfad zu Ihrer Xcode-Installation zurückgibt.
• Öffnen Sie Xcode, um sicherzustellen, dass es ordnungsgemäß geladen wird, und navigieren Sie dann zu Xcode-> Einstellungen > Speicherort. Überprüfen Sie, ob das Feld Befehlszeilentools auf die richtige Xcode-Installation verweist.

Wenn Ihre Xcode-Umgebung ordnungsgemäß konfiguriert wurde, werden Sie benachrichtigt: "Ihre iOS- und macOS-Umgebung für .NET MAUI ist alle eingerichtet!"

Feedback geben

Um von Visual Studio Code aus Feedback zur .NET MAUI Erweiterung zu liefern, navigieren Sie zum Dialog Hilfe > Problem melden. Stellen Sie dann sicher, dass Sie "Fehlerbericht" als Wert des Dropdown-Menüs Dies ist ein, "Eine VS Code Erweiterung" als Wert des Dropdown-Menüs Für und ".NET MAUI" als Wert des Dropdown-Menüs Erweiterung auswählen:

Nächste Schritte

Wenn Sie erfahren möchten, wie Sie Ihre erste .NET MAUI-App in Visual Studio 2022 unter Windows oder Visual Studio Code erstellen und ausführen, klicken Sie unten auf die Schaltfläche.

Erstellen Ihrer ersten App