Installatie

Voor het ontwikkelen van systeemeigen, cross-platform .NET Multi-platform App UI (.NET MAUI) apps is Visual Studio 2022 17.12 of hoger vereist, of de nieuwste Visual Studio Code met de .NET MAUI-extensie.

Visual Studio

Om te beginnen met het ontwikkelen van systeemeigen, cross-platform .NET MAUI-apps op Windows, installeer Visual Studio 2022 17.12 of hoger door de installatie stappen te volgen.

Voorwaarden

• Visual Studio 2022 17.12 of hoger. Zie Visual Studio 2022 System Requirementsvoor informatie over ondersteunde besturingssystemen, hardware, ondersteunde talen en aanvullende vereisten en richtlijnen.

Als u .NET MAUI-apps voor iOS en Mac Catalyst wilt bouwen, ondertekenen en implementeren, hebt u ook het volgende nodig:

• Een Mac die compatibel is met Xcode. Voor meer informatie, zie de documentatie over minimale systeemvereisten van Apple .
• Een specifieke versie van Xcode, die afhankelijk is van de versie van .NET MAUI die u gebruikt. Zie releaseversiesvoor meer informatie.
• Een Apple ID en een betaald Apple Developer Program-abonnement. Een Apple ID is vereist voor het implementeren van apps op apparaten en voor het verzenden van apps naar de Apple Store.

Als u foutopsporingsversies van uw app rechtstreeks vanuit Windows naar uw iOS-apparaat wilt implementeren met hot restart, hebt u het volgende nodig:

• Een Apple Developer-account en een betaalde inschrijving voor het Apple Developer Program.

Installatie

1. Als u .NET MAUI-apps wilt maken, moet u de nieuwste versie van Visual Studio 2022 downloaden:

   • Visual Studio 2022 Community downloaden

   • Visual Studio 2022 Professional downloaden

   • Visual Studio 2022 Enterprise- downloaden

2. Installeer Visual Studio of pas uw bestaande installatie aan via het installatieprogramma van Visual Studio en installeer de workload voor het ontwikkelen van de gebruikersinterface voor .NET-apps met meerdere platforms met de standaard optionele installatieopties:

   

Visual Studio Code

Installeer de nieuwste Visual Studio Code door de installatie stappen te volgen om te beginnen met het ontwikkelen van systeemeigen, cross-platform .NET MAUI-apps op Windows, macOS of Linux.

Voorwaarden

Als u .NET MAUI-apps voor iOS en Mac Catalyst wilt bouwen, ondertekenen en implementeren, hebt u het volgende nodig:

• Een Mac die compatibel is met Xcode. Voor meer informatie, zie de documentatie over minimale systeemvereisten van Apple .
• Een specifieke versie van Xcode, die afhankelijk is van de versie van .NET MAUI die u gebruikt. Zie releaseversiesvoor meer informatie.
• Een Apple ID en een betaald Apple Developer Program-abonnement. Een Apple ID is vereist voor het implementeren van apps op apparaten en voor het verzenden van apps naar de Apple Store.

Visual Studio Code installeren

1. Als u .NET MAUI-apps wilt maken, moet u de nieuwste versie van Visual Studio Code downloaden:

   • Visual Studio Code downloaden

2. Installeer Visual Studio Code. Zie voor gedetailleerde instructies over het installeren van Visual Studio Code Visual Studio Code in Windows, Visual Studio Code op macOSen Visual Studio Code op Linux.

De .NET MAUI-extensie installeren

Voordat u .NET MAUI-apps kunt maken in Visual Studio Code, moet u de EXTENSIE .NET MAUI installeren:

1. Start Visual Studio Code.

2. Navigeer in Visual Studio Code naar het tabblad Extensions en zoek naar .NET MAUI. Selecteer vervolgens de extensie .NET MAUI en installeer deze door op de knop Installeren te drukken:

   

   Met de extensie .NET MAUI worden de C# Dev Kit en de C#-extensies automatisch geïnstalleerd, die vereist zijn om de .NET MAUI-extensie uit te voeren. Zie C# Dev Kit voor Visual Studio Codevoor meer informatie over C# Dev Kit.

Uw account verbinden met C# Dev Kit

Als u C# Dev Kit gebruikt, moet u zich aanmelden met een Microsoft-account met een actief Visual Studio-abonnement:

1. Navigeer naar het tabblad Welkom om aan de slag te gaan met .NET MAUI, en druk op de knop Connect.

   

   Volg de aanwijzingen om u aan te melden bij uw Microsoft-account. Zie Aanmelden bij C# Dev Kitvoor meer informatie.

Zie veelgestelde vragen over C# Dev Kitvoor meer informatie over C# Dev Kit-licenties.

Uw .NET-omgeving instellen

U moet de .NET SDK op uw computer hebben geïnstalleerd om .NET MAUI-apps te ontwikkelen. Als u de .NET SDK niet op uw computer hebt geïnstalleerd, is de voorkeursbenadering voor het installeren ervan in Windows via Visual Studio Installer. Zie Installationvoor meer informatie.

U kunt ook de .NET SDK handmatig installeren:

1. Download het .NET-installatieprogramma.

2. Installeer de .NET SDK door het .NET-installatieprogramma uit te voeren. Zie .NET installeren in Windows, Linux en macOSvoor meer informatie.

   Aanbeveling

   In Linux kunt u de .NET SDK installeren met behulp van de installatie-instructies.

Controleer of de .NET SDK is geïnstalleerd:

1. Open een terminal.

2. Voer in de terminal de volgende opdracht uit:

   dotnet --version
   

   U ziet nu de versie van de .NET SDK die u hebt geïnstalleerd.

   Notitie

   Het kan nodig zijn om uw computer opnieuw op te starten voordat u controleert of de .NET SDK is geïnstalleerd.

Uw .NET MAUI-omgeving instellen

U moet de .NET MAUI SDK op uw computer hebben geïnstalleerd om .NET MAUI-apps te ontwikkelen. Als u de .NET MAUI SDK niet op uw computer hebt geïnstalleerd, is de voorkeursmethode voor het installeren ervan in Windows via Visual Studio Installer. Zie Installationvoor meer informatie.

U kunt ook de .NET MAUI SDK handmatig installeren.

1. Open een terminal.

2. Voer in de terminal in Windows de volgende opdracht uit:

   dotnet workload install maui
   

   Voer in de terminal in macOS de volgende opdracht uit:

   sudo dotnet workload install maui
   

   Voer in de terminal in Linux de volgende opdracht uit:

   dotnet workload install maui-android
   

Ga als volgt te werk om te controleren of de .NET MAUI SDK is geïnstalleerd:

1. Open een terminal.

2. Voer in de terminal de volgende opdracht uit:

   dotnet workload list
   

   In Windows en macOS ziet u de maui workload-id vermeld naast de geïnstalleerde versie. Als u deze echter hebt geïnstalleerd via Visual Studio Installer in Windows, worden de volgende workload-id's vermeld:

   android
   maui-windows
   maccatalyst
   ios
   

   In Linux ziet u de maui-android workload-id vermeld naast de geïnstalleerde versie.

Doelplatforms instellen

Als u een .NET MAUI-app wilt bouwen en fouten wilt opsporen, moet u een geldig doelplatform hebben ten opzichte van het besturingssysteem van uw ontwikkelcomputer. De volgende tabel bevat de ondersteunde doelplatforms op elk besturingssysteem:

Uw besturingssysteem	Ondersteunde doelplatforms
Ramen	Windows, Android
macOS	Android, iOS, macOS
Linux	Android

Voor het bouwen van een .NET MAUI-app voor Android en voor Apple-platforms moet u extra instellingen en configuraties uitvoeren.

Android

Het proces om uw machine in te stellen voor .NET MAUI-ontwikkeling op Android met Visual Studio Code is:

• Download en installeer de Java SDK. Voor meer informatie, zie Download en installeer de Java JDK.
• Download en installeer Android SDK. Zie De Android SDK-downloaden en installeren voor meer informatie.
• Download en installeer een Android-emulator. Zie Een Android-emulator downloaden en installerenvoor meer informatie.

De Java SDK downloaden en installeren

Als u de Java SDK wilt downloaden en installeren en Visual Studio Code wilt configureren om deze te gebruiken:

1. Download en installeer Microsoft OpenJDK 17. Zie De Microsoft Build van OpenJDK installerenvoor meer informatie over het installeren van de OpenJDK.

   U kunt ook het InstallAndroidDependencies builddoel gebruiken om de Java SDK (en de Android SDK) te installeren in plaats van de Java SDK handmatig te downloaden en te installeren. Zie InstallAndroidDependencies-doel gebruikenvoor meer informatie.

   Belangrijk

   Zorg ervoor dat u de locatie noteert waarop de OpenJDK is geïnstalleerd, omdat dit vereist is in de volgende stap.

2. Zorg ervoor dat u het pad naar OpenJDK hebt geconfigureerd via een van de volgende methoden:

   1. Stel de omgevingsvariabele JAVA_HOME in om het Java SDK-pad voor uw computer te definiëren. Dit is de aanbevolen benadering, waarmee het Java SDK-pad op machineniveau wordt gedefinieerd.

      Notitie

      Als u de OpenJDK op Windows installeert via MSI, kunt u ervoor kiezen om de JAVA_HOME omgevingsvariabele in te stellen.

   2. Druk in Visual Studio Code op Ctrl+Shift+P in Windows of Cmd+Shift+P in macOS en selecteer vervolgens .NET MAUI: Android configureren, gevolgd door Java SDK-locatie selecteren om het Java SDK-pad in te stellen op gebruikers-/werkruimteniveau.

   3. Configureer het Java SDK-pad in uw .csproj-bestand door de eigenschap $(JavaSdkDirectory) MSBuild in te stellen op het OpenJDK-pad. Hiermee definieert u het Java SDK-pad op projectniveau.

De Android SDK downloaden en installeren

Als u de Android SDK wilt downloaden en installeren en Visual Studio Code wilt configureren om deze te gebruiken:

1. Download en installeer de Android SDK via een van de volgende methoden:

   1. Download en installeer de Android SDK door een nieuw .NET MAUI-project te maken en gebruik vervolgens het InstallAndroidDependencies builddoel, waarmee u uw Android-omgeving kunt instellen. Dit is de aanbevolen aanpak. Zie InstallAndroidDependencies-doel gebruikenvoor meer informatie.
   2. Download en installeer de Android SDK op Windows door de workload voor .NETLOAD-ontwikkeling in Visual Studiote installeren en vervolgens een .NETLOAD-app te maken en uit te voeren op Android. Dit proces zorgt ervoor dat de Android SDK en een Android-emulator zijn geïnstalleerd.
   3. Download en installeer de Android SDK met behulp van Android Studio. Zie Android Studio- installeren op developer.android.com voor meer informatie.
   4. Download en installeer de Android SDK via uw voorkeurspakketbeheer op Linux.

2. Zorg ervoor dat u het pad naar de Android SDK hebt geconfigureerd via een van de volgende methoden:

   1. Stel de omgevingsvariabele ANDROID_HOME in om het Android SDK-pad voor uw computer te definiëren. Dit is de aanbevolen aanpak, waarmee het Android SDK-pad op computerniveau wordt gedefinieerd.
   2. Druk in Visual Studio Code op Ctrl+Shift+P op Windows of Cmd+Shift+P op macOS en selecteer vervolgens .NET MAUI: Configureer Android, gevolgd door Selecteer Android SDK-locatie om het Android SDK-pad in te stellen op gebruikers-/werkruimteniveau.
   3. Configureer het Android SDK-pad in uw .csproj-bestand door de MSBuild-eigenschap $(AndroidSdkDirectory) in te stellen op het Android SDK-pad. Hiermee definieert u het Android SDK-pad op projectniveau.

3. Controleer in Visual Studio Code of uw Android-omgeving correct is geconfigureerd door op Ctrl+Shift+P in Windows of Cmd+Shift+P in macOS te drukken en vervolgens .NET MAUI te selecteren: Android configureren, gevolgd door Android-omgeving vernieuwen. Gedetecteerde fouten moeten worden opgelost:

   • Selecteer in het opdrachtenpalet .NET MAUI: Configureer Android- gevolgd door zowel Selecteer android SDK-locatie als Selecteer android SDK-locatie en controleer of ze correct verwijzen naar installaties van beide. Als u de SDK's installeert via Visual Studio, bevindt OpenJDK zich in C:\Program Files\Microsoft en bevindt de Android SDK zich op C:\Program Files (x86)\Android\android-sdk.
   • Zorg ervoor dat uw Android SDK-map submappen bevat, zoals build-tools, cmdline-toolsen platformhulpprogramma's.
   • Zorg ervoor dat uw OpenJDK-map submappen bevat, zoals bin-, lib-en meer.
   • Zorg ervoor dat de omgevingsvariabele ANDROID_HOME is ingesteld op uw Android SDK-pad.
   • Zorg ervoor dat de omgevingsvariabele JAVA_HOME is ingesteld op het Java SDK-pad.
   • Als Android-licenties niet zijn geaccepteerd, navigeert u in een terminal met verhoogde bevoegdheid naar de map cmdline-tools/{version}/bin en voert u sdkmanager --licenses uit en volgt u de CLI-prompts.

Het installAndroidDependencies-doel gebruiken

De aanbevolen methode voor het installeren van de vereiste afhankelijkheden voor uw .NET MAUI-project op Android is het uitvoeren van de InstallAndroidDependencies MSBuild-doel. Met dit doel wordt de Android SDK voor u geïnstalleerd als deze nog niet is geïnstalleerd.

Maak in een terminal een nieuw .NET MAUI-project:

dotnet new maui -n "MyMauiApp"

Navigeer in een terminal naar de map MyMauiAppen bouw de app terwijl u het InstallAndroidDependencies builddoel opgeeft:

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

Notitie

De InstallAndroidDependencies MSBuild-target kan ook de Java SDK installeren als de eigenschap JavaSdkDirectory MSBuild is opgegeven.

In de bovenstaande opdracht:

• -p:AndroidSdkDirectory="/path/to/sdk" installeert of werkt Android-afhankelijkheden bij naar het opgegeven absolute pad. Voorgestelde paden zijn %LOCALAPPDATA%/Android/Sdk op Windows en $HOME/Library/Android/sdk op macOS.
• -p:AcceptAndroidSDKLicenses=True accepteert de vereiste Android-licenties voor ontwikkeling.
• (optioneel) -p:JavaSdkDirectory="/path/to/sdk" installeert de Java SDK op het opgegeven absolute pad.

Vermijd het gebruik van paden die spaties of niet-ASCII-tekens bevatten.

Een Android-emulator downloaden en installeren

Als u een Android-emulator wilt downloaden en installeren waarop u uw apps wilt uitvoeren:

1. Navigeer in een terminal naar de {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. Gebruik in een terminal de opdracht sdkmanager om een Android-emulator te downloaden en te installeren:

   Voer in Windows de volgende opdrachten uit:

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

   Voer in macOS de volgende opdrachten uit:

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

   Notitie

   Bij de bovenstaande opdracht wordt ervan uitgegaan dat er een Apple Silicon Mac wordt gebruikt. Voor een Intel Mac vervangt u arm64-v8a door x86_64.

   Zie sdkmanager op developer.android.com voor meer informatie over de opdracht .

3. Gebruik in een terminal de opdracht avdmanager om een nieuwe Android-emulator te maken:

   Voer in Windows de volgende opdrachten uit:

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

   Voer in macOS de volgende opdrachten uit:

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

   Notitie

   Bij de bovenstaande opdracht wordt ervan uitgegaan dat er een Apple Silicon Mac wordt gebruikt. Voor een Intel Mac vervangt u arm64-v8a door x86_64.

   Zie avdmanager op developer.android.com voor meer informatie over de opdracht .

iOS en macOS

Uw Mac voor .NET MAUI-ontwikkeling instellen op iOS en Mac Catalyst met Visual Studio Code:

1. Installeer de versie van Xcode die is vereist voor de versie van .NET MAUI die u gebruikt. Zie releaseversiesvoor meer informatie. De nieuwste stabiele Xcode-release kan worden gedownload uit de Apple App Store-.

2. Voer in een terminal de volgende opdracht uit om de Xcode-opdrachtregelprogramma's te verkrijgen:

   xcode-select --install
   

3. Start Xcode en accepteer eventuele licentieovereenkomsten. Als simulators niet beginnen met installeren, gaat u naar Xcode > Settings > Components en installeert u de gekozen simulatorruntimes.

4. Controleer in Visual Studio Code of uw Apple-omgeving correct is geconfigureerd door op Cmd+Shift+P te drukken en vervolgens .NET MAUI te selecteren: Apple configureren, gevolgd door Apple-omgeving vernieuwen. Gedetecteerde fouten moeten worden opgelost:

   • Zorg ervoor dat u xcode-select --install in een terminal hebt uitgevoerd.
   • Als u een fout krijgt dat Xcode niet is gevonden, voert u xcode-select -p uit in een terminal en controleert u of er een pad naar de Xcode-installatie wordt geretourneerd.
   • Open Xcode om ervoor te zorgen dat deze correct wordt geladen en navigeer vervolgens naar Xcode > Settings > Location en controleer of het veld Opdrachtregelprogramma's verwijst naar de juiste Xcode-installatie.

Probleemoplossing

Als u problemen ondervindt bij het installeren van de .NETOW-extensie in Visual Studio Code, kunt u meer informatie over de problemen vinden door naar het uitvoervenster te navigeren (Ctrl+Shift+U in Windows of Cmd+Shift+U in macOS) en .NET MAUI te selecteren in de vervolgkeuzelijst.

Feedback geven

Als u feedback wilt geven over de .NET MAUI-extensie vanuit Visual Studio Code, gaat u naar het dialoogvenster Help > rapportprobleem. Zorg er vervolgens voor dat u 'Bug Report' selecteert als de waarde van de Dit is een vervolgkeuzelijst, 'A VS Code-extensie' als de waarde van de Voor vervolgkeuzelijst en '.NET MAUI' als de waarde van de vervolgkeuzelijst Extension:

Visual Studio Code (experimenteel)

Voorwaarden

Als u .NET MAUI-apps voor iOS en Mac Catalyst wilt bouwen, ondertekenen en implementeren, hebt u het volgende nodig:

• Een Mac die compatibel is met Xcode. Voor meer informatie, zie de documentatie over minimale systeemvereisten van Apple .
• Een specifieke versie van Xcode, die afhankelijk is van de versie van .NET MAUI die u gebruikt. Zie releaseversiesvoor meer informatie.
• Een Apple ID en een betaald Apple Developer Program-abonnement. Een Apple ID is vereist voor het implementeren van apps op apparaten en voor het verzenden van apps naar de Apple Store.

Installeer de nieuwste Visual Studio Code door de installatie stappen te volgen om te beginnen met het ontwikkelen van systeemeigen, cross-platform .NET MAUI-apps op Windows, macOS of Linux.

Als u een .NET MAUI-app wilt bouwen en fouten wilt opsporen, moet u een geldig doelplatform hebben ten opzichte van het besturingssysteem van uw ontwikkelcomputer. De volgende tabel bevat de ondersteunde doelplatforms op elk besturingssysteem:

Uw besturingssysteem	Ondersteunde doelplatforms
Ramen	Windows, Android
macOS	Android, iOS, macOS
Linux	Android

Visual Studio Code installeren

1. Als u .NET MAUI-apps wilt maken, moet u de nieuwste versie van Visual Studio Code downloaden:

   • Visual Studio Code downloaden

2. Installeer Visual Studio Code. Zie voor gedetailleerde instructies over het installeren van Visual Studio Code Visual Studio Code in Windows, Visual Studio Code op macOSen Visual Studio Code op Linux.

De .NET MAUI-extensie installeren

Voordat u .NET MAUI-apps kunt maken in Visual Studio Code, moet u de EXTENSIE .NET MAUI installeren:

1. Start Visual Studio Code.

2. Navigeer in Visual Studio Code naar het tabblad Extensions en zoek naar .NET MAUI. Selecteer vervolgens de extensie .NET MAUI en installeer deze door op de knop Installeren te drukken:

   

   Met de extensie .NET MAUI worden de C# Dev Kit en de C#-extensies automatisch geïnstalleerd, die vereist zijn om de .NET MAUI-extensie uit te voeren. Zie C# Dev Kit voor Visual Studio Codevoor meer informatie over C# Dev Kit.

Volg de stappen in de handleiding

Zodra u de .NET MAUI-extensie installeert, wordt u verwelkomd door de walkthrough van .NET MAUI, "Aan de slag met .NET MAUI".

Belangrijk

Als u toegang wilt krijgen tot de verbeterde installatie-ervaring, moet de >ingeschakeld zijn.

Klik door en volg de aanwijzingen bij elke stap om uw .NET MAUI-omgeving en doelplatforms volledig te configureren:

1. Uw account verbinden met de C# Dev Kit-extensie
2. Uw .NET-omgeving instellen
3. Uw .NET MAUI-omgeving instellen
4. Uw iOS- en macOS-omgeving instellen
5. Uw Android-omgeving instellen

Notitie

U moet op een Mac zijn om de stap uw iOS- en macOS-omgeving instellen te zien en te volgen.

Met de stap Uw Android-omgeving instellen wordt alles ingesteld wat u nodig hebt om android als doelplatform te gebruiken. Met de stap Uw iOS- en macOS-omgeving instellen , wordt alles ingesteld wat u nodig hebt om succesvol te zijn met iOS en Mac als doelplatforms.

Deze handleiding kan ook worden geopend vanuit het commando-palet. Selecteer Welkom: Open Walkthrough... gevolgd door Aan de slag met .NET MAUI.

Toegang tot de verbeterde installatie-ervaring

1. Druk in Visual Studio Code op Ctrl+Shift+P in Windows of Cmd+Shift+P in macOS en selecteer Voorkeuren: Instellingen openen (UI).

   

2. Navigeer naar Extensies > .NET MAUI en controleer de > instelling.

   

3. Ga terug naar de handleiding Aan de slag met .NET MAUI . Zorg ervoor dat u in staat bent om uw Android-omgeving in te stellen te zien, onder andere stappen in het doorloopproces.

   

Uw account verbinden met C# Dev Kit

Als u C# Dev Kit gebruikt, moet u zich aanmelden met een Microsoft-account met een actief Visual Studio-abonnement:

1. Navigeer naar het tabblad Welkom om aan de slag te gaan met .NET MAUI, en druk op de knop Connect.

   

   Volg de aanwijzingen om u aan te melden bij uw Microsoft-account. Zie Aanmelden bij C# Dev Kitvoor meer informatie.

Zie veelgestelde vragen over C# Dev Kitvoor meer informatie over C# Dev Kit-licenties.

Uw .NET-omgeving instellen

U moet de .NET SDK op uw computer hebben geïnstalleerd om .NET MAUI-apps te ontwikkelen. Als u de .NET SDK niet op uw computer hebt geïnstalleerd, is de voorkeursbenadering voor het installeren ervan in Windows via Visual Studio Installer. Zie Installationvoor meer informatie.

U kunt ook de .NET SDK handmatig installeren:

1. Download het .NET-installatieprogramma.

2. Installeer de .NET SDK door het .NET-installatieprogramma uit te voeren. Zie .NET installeren in Windows, Linux en macOSvoor meer informatie.

   Aanbeveling

   In Linux kunt u de .NET SDK installeren met behulp van de installatie-instructies.

Controleer of de .NET SDK is geïnstalleerd:

1. Open een terminal.

2. Voer in de terminal de volgende opdracht uit:

   dotnet --version
   

   U ziet nu de versie van de .NET SDK die u hebt geïnstalleerd.

   Notitie

   Het kan nodig zijn om uw computer opnieuw op te starten voordat u controleert of de .NET SDK is geïnstalleerd.

Uw .NET MAUI-omgeving instellen

U moet de .NET MAUI SDK op uw computer hebben geïnstalleerd om .NET MAUI-apps te ontwikkelen. Als u de .NET MAUI SDK niet op uw computer hebt geïnstalleerd, is de voorkeursmethode voor het installeren ervan in Windows via Visual Studio Installer. Zie Installationvoor meer informatie.

U kunt ook de .NET MAUI SDK handmatig installeren.

1. Open een terminal.

2. Voer in de terminal in Windows de volgende opdracht uit:

   dotnet workload install maui
   

   Voer in de terminal in macOS de volgende opdracht uit:

   sudo dotnet workload install maui
   

   Voer in de terminal in Linux de volgende opdracht uit:

   dotnet workload install maui-android
   

Ga als volgt te werk om te controleren of de .NET MAUI SDK is geïnstalleerd:

1. Open een terminal.

2. Voer in de terminal de volgende opdracht uit:

   dotnet workload list
   

   In Windows en macOS ziet u de maui workload-id vermeld naast de geïnstalleerde versie. Als u deze echter hebt geïnstalleerd via Visual Studio Installer in Windows, worden de volgende workload-id's vermeld:

   android
   maui-windows
   maccatalyst
   ios
   

   In Linux ziet u de maui-android workload-id vermeld naast de geïnstalleerde versie.

Uw Android-omgeving instellen

Als u uw Android-ontwikkelomgeving wilt instellen, klikt u op de knop Android-omgeving configureren in de stapsgewijze stap Uw Android-omgeving instellen om de volledige Android-overnamestroom in te voeren.

De Android-installatieproces analyseert uw Android-omgeving en stelt voor om alle ontbrekende onderdelen te installeren.

• Android SDK en Java SDK: Android SDK- en Java SDK-onderdelen zijn vereist.

  • Via de Android-overnamestroom wordt u gevraagd deze onderdelen rechtstreeks te installeren of om een bestaande installatie te selecteren die u mogelijk al hebt.

    

  • Als u uw SDK- en JDK-installaties verder wilt configureren, raadpleegt u instructies voor het handmatig installeren en configureren van Android.

• Android-emulator: het installeren van een Android-emulator wordt aanbevolen en is vereist als er geen fysiek apparaat is.

  • Het Android acquisitietraject vraagt u om een standaardemulator direct te installeren.

    

  • Als u emulators verder wilt configureren, volgt u de instructies voor het handmatig installeren van een Android-emulator.

Belangrijk

Android-licenties moeten handmatig worden gecontroleerd en geaccepteerd in Terminal. Controleer elke licentie wanneer u hierom wordt gevraagd. Als u wilt accepteren, typt u 'y' en drukt u op Enter.

Wanneer uw Android-omgeving correct is geconfigureerd, krijgt u een melding: 'Uw Android-omgeving voor .NET MAUI is allemaal ingesteld!'

Bekijk het deelvenster Uitvoer voor meer informatie over de status van uw Android-omgeving.

Uw iOS- en macOS-omgeving instellen

Uw Mac voor .NET MAUI-ontwikkeling instellen op iOS en Mac Catalyst met Visual Studio Code:

1. Installeer de versie van Xcode die is vereist voor de versie van .NET MAUI die u gebruikt. Zie releaseversiesvoor meer informatie. De nieuwste stabiele Xcode-release kan worden gedownload uit de Apple App Store-.

2. Voer in een terminal de volgende opdracht uit om de Xcode-opdrachtregelprogramma's te verkrijgen:

   xcode-select --install
   

3. Start Xcode en accepteer eventuele licentieovereenkomsten. Als simulators niet beginnen met installeren, gaat u naar Xcode > Settings > Components en installeert u de gekozen simulatorruntimes.

4. Controleer in Visual Studio Code of uw Xcode-omgeving is geconfigureerd door te klikken op iOS- en macOS-omgeving configureren in de stapsgewijze instructies voor het instellen van uw iOS- en macOS-omgeving .

Gedetecteerde fouten moeten worden opgelost:

• Zorg ervoor dat u xcode-select --install in een terminal hebt uitgevoerd.
• Als u een fout krijgt dat Xcode niet is gevonden, voert u xcode-select -p uit in een terminal en controleert u of er een pad naar de Xcode-installatie wordt geretourneerd.
• Open Xcode om ervoor te zorgen dat deze correct wordt geladen en navigeer vervolgens naar Xcode > Settings > Location en controleer of het veld Opdrachtregelprogramma's verwijst naar de juiste Xcode-installatie.

Wanneer uw Xcode-omgeving correct is geconfigureerd, krijgt u een melding: 'Uw iOS- en macOS-omgeving voor .NET MAUI is allemaal ingesteld!'

Feedback geven

Als u feedback wilt geven over de .NET MAUI-extensie vanuit Visual Studio Code, gaat u naar het dialoogvenster Help > rapportprobleem. Zorg er vervolgens voor dat u 'Bug Report' selecteert als de waarde van de Dit is een vervolgkeuzelijst, 'A VS Code-extensie' als de waarde van de Voor vervolgkeuzelijst en '.NET MAUI' als de waarde van de vervolgkeuzelijst Extension:

Volgende stappen

Klik op de onderstaande knop voor meer informatie over het maken en uitvoeren van uw eerste .NET MAUI-app in Visual Studio 2022 in Windows of Visual Studio Code.

uw eerste app bouwen