.NET installeren in macOS

In dit artikel leert u welke versies van .NET worden ondersteund in macOS, hoe u .NET installeert en wat het verschil is tussen de SDK en runtime.

De nieuwste versie van .NET is 10.

Ondersteunde versies

De volgende tabel bevat de ondersteunde .NET releases en op welke macOS ze worden ondersteund. Deze versies blijven ondersteund totdat de versie van .NET het einde van de ondersteuning bereikt of de versie van macOS niet meer wordt ondersteund.

De volgende versies van .NET worden ❌ niet meer ondersteund:

• .NET 7
• .NET 6
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Runtime of SDK

De runtime wordt gebruikt om apps uit te voeren die zijn gemaakt met .NET. Wanneer een app-auteur een app publiceert, kan hij de runtime met de app opnemen. Als ze de runtime niet bevatten, is het aan de gebruiker om de juiste runtime te installeren.

Er zijn twee runtimes die u kunt installeren in macOS en beide zijn opgenomen in de SDK.

• ASP.NET Core Runtime
  Hiermee worden ASP.NET Core apps uitgevoerd. Bevat de .NET runtime. Niet beschikbaar als installatieprogramma.

• .NET Runtime
  Hiermee worden normale .NET apps uitgevoerd, maar geen gespecialiseerde apps, zoals apps die zijn gebouwd op ASP.NET Core.

De SDK wordt gebruikt voor het bouwen en publiceren van .NET apps en bibliotheken. De nieuwste SDK biedt ondersteuning voor het bouwen van apps voor eerdere versies van .NET. In normale omstandigheden hebt u alleen de nieuwste SDK nodig.

Het installeren van de SDK omvat zowel de standaard-.NET Runtime als de ASP.NET Core Runtime. Als u bijvoorbeeld .NET SDK 9.0 hebt geïnstalleerd, worden .NET Runtime 9.0 en ASP.NET Core 9.0 Runtime beide geïnstalleerd. Elke andere runtimeversie zou echter niet worden geïnstalleerd met de SDK en vereist dat u deze afzonderlijk installeert.

Kiezen hoe u .NET installeert

Er zijn verschillende manieren om .NET te installeren en sommige producten kunnen hun eigen versie van .NET beheren. Als u .NET installeert via software die een eigen versie van .NET beheert, is deze mogelijk niet systeembreed ingeschakeld. Zorg ervoor dat u begrijpt wat de gevolgen zijn van het installeren van .NET via andere software.

Als u niet zeker weet welke methode u moet kiezen nadat u de lijsten in de volgende secties hebt bekeken, wilt u waarschijnlijk het .NET Installer-pakket gebruiken.

Ontwikkelaars

• Visual Studio Code - C# Dev Kit

  Installeer de extensie C# Dev Kit voor Visual Studio Code om .NET apps te ontwikkelen. De extensie kan een al geïnstalleerde SDK gebruiken of er een voor u installeren.

Gebruikers en ontwikkelaars

• .NET Installer

  Gebruik het zelfstandige installatieprogramma om .NET te installeren. Deze methode is de gebruikelijke manier om .NET te installeren op uw ontwikkel- of gebruikerscomputer.

• Installeer .NET met een script

  Een bash-script waarmee de installatie van de SDK of Runtime kan worden geautomatiseerd. U kunt kiezen welke versie van .NET u wilt installeren.

• Install .NET handmatig

  Gebruik deze installatiemethode wanneer u .NET wilt installeren in een specifieke map en deze wilt uitvoeren naast andere kopieën van .NET.

.NET installeren

Installatiepakketten zijn beschikbaar voor macOS, een eenvoudige manier om .NET te installeren.

1. Open een browser en ga naar https://dotnet.microsoft.com/download/dotnet.

2. Selecteer de koppeling naar de .NET versie die u wilt installeren, zoals .NET 10.0.

   

   Deze koppeling brengt u naar de pagina met koppelingen om die versie van .NET te downloaden

   Als u de SDK gaat installeren, kiest u de meest recente .NET versie. De SDK ondersteunt het bouwen van apps voor eerdere versies van .NET.

   Aanbeveling

   Als u niet zeker weet welke versie u wilt downloaden, kiest u de versie die als meest recent is gemarkeerd.

3. Deze pagina bevat de downloadkoppelingen voor de SDK en runtime. Hier downloadt u de .NET SDK of .NET Runtime.

   

   Er zijn twee secties gemarkeerd in de vorige afbeelding. Als u de SDK downloadt, raadpleegt u sectie 1. Raadpleeg sectie 2 voor de .NET Runtime.

   • Sectie 1 (SDK)

     Deze sectie is het sdk-downloadgebied. Onder de kolom Installers voor de macOS-rij worden twee architecturen weergegeven: Arm64 en x64.

     • Als u een Apple-processor gebruikt, zoals een M1 of een M3 Pro, selecteert u Arm64.
     • Als u een Intel-processor gebruikt, selecteert u x64.

   • Afdeling 2 (runtime)

     Deze sectie bevat de runtime-downloads. U ziet dat koppelingen voor de kolom Installers in de macOS-rij leeg zijn. Deze sectie is leeg omdat de ASP.NET Core Runtime alleen is opgegeven in de SDK of via binaire installatie.

     Schuif verder omlaag om de standaard .NET Runtime te vinden voor downloaden.

     

     • Als u een Apple-processor gebruikt, zoals een M1 of een M3 Pro, selecteert u Arm64.
     • Als u een Intel-processor gebruikt, selecteert u x64.

4. Zodra het downloaden is voltooid, opent u het.

5. Volg de stappen in het installatieprogramma.

   

Handmatig .NET installeren

Als alternatief voor de macOS-installatieprogramma's kunt u de SDK en runtime downloaden en handmatig installeren. Handmatige installatie wordt meestal uitgevoerd als onderdeelautomatisering in een scenario voor continue integratie. Ontwikkelaars en gebruikers willen meestal het installatieprogramma gebruiken.

1. Open een browser en ga naar https://dotnet.microsoft.com/download/dotnet.

2. Selecteer de koppeling naar de .NET versie die u wilt installeren, zoals .NET 8.0.

   Deze koppeling brengt u naar de pagina met koppelingen om die versie van .NET te downloaden

   Als u de SDK gaat installeren, kiest u de meest recente .NET versie. De SDK ondersteunt het bouwen van apps voor eerdere versies van .NET.

   Aanbeveling

   Als u niet zeker weet welke versie u wilt downloaden, kiest u de versie die als meest recent is gemarkeerd.

   

3. Selecteer de koppeling naar de SDK of Runtime die u wilt installeren. Zoek de Binaries-kolom in de macOS-rij.

   

   • Als u een Apple-processor gebruikt, zoals een M1 of een M3 Pro, selecteert u Arm64.
   • Als u een Intel-processor gebruikt, selecteert u x64.

4. Open een terminal en navigeer naar de locatie waar het binaire .NET is gedownload.

5. Pak de tarball uit op de locatie waar u .NET op uw systeem wilt installeren. In het volgende voorbeeld wordt de HOME-directory~/Applications/.dotnetgebruikt.

   mkdir -p ~/Applications/.dotnet
   tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
   

Test of .NET werkt door de map te wijzigen in de locatie waar .NET is geïnstalleerd en voer de opdracht dotnet --info uit:

chdir ~/Applications/.dotnet/
./dotnet --info

.NET installeren met een script

De dotnet-install-scripts worden gebruikt voor automatisering en niet-geëleveerde installaties van de runtime. U kunt het script downloaden van https://dot.net/v1/dotnet-install.sh.

Het script installeert standaard de nieuwste long term support (LTS) versie, die .NET 8 is. U kunt een specifieke release kiezen door de channel switch op te geven. Gebruik de runtime switch om runtime te installeren. Anders installeert het script de SDK.

1. Open een terminal.

2. Navigeer naar een map waarin u het script wilt downloaden, zoals ~/Downloads.

3. Als je de opdracht wget niet hebt, installeer het dan met Brew

   brew install wget
   

4. Voer de volgende opdracht uit om het script te downloaden:

   wget https://dot.net/v1/dotnet-install.sh
   

5. Geef het script uitvoermachtigingen

   chmod +x dotnet-install.sh
   

6. Voer het script uit om .NET te installeren.

   Het script is standaard ingesteld op het installeren van de nieuwste SDK in de ~/.dotnet map.

   ./dotnet-install.sh
   

Hier volgen alle opdrachten als één bash-script:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Test .NET door naar de map ~/.dotnet te navigeren en de opdracht dotnet --info uit te voeren:

chdir ~/.dotnet
./dotnet --info

.NET installeren voor Visual Studio Code

Visual Studio Code is een krachtige en lichtgewicht broncode-editor die op uw bureaublad wordt uitgevoerd. Visual Studio Code kunt de SDK gebruiken die al op uw systeem is geïnstalleerd. Daarnaast installeert de extensie C# Dev Kit .NET als deze nog niet is geïnstalleerd.

Zie Getting Started with C# in VS Code voor instructies over het installeren van .NET via Visual Studio Code.

Notarisatie

Software die is gemaakt voor macOS die wordt gedistribueerd met een ontwikkelaars-id, moet worden ge notariseerd, inclusief apps die zijn gemaakt met .NET.

Als u een niet-ge notariseerde app uitvoert, wordt er een foutvenster weergegeven dat lijkt op de volgende afbeelding:

Zie Working with macOS Catalina Notarization voor meer informatie over hoe afgedwongen notarisatie van invloed is op .NET (en uw .NET-apps).

Validatie

Nadat u een installatieprogramma of binaire versie hebt gedownload, controleert u of het bestand niet is gewijzigd of beschadigd. U kunt de controlesom op uw computer controleren en deze vergelijken met wat er is gerapporteerd op de downloadwebsite.

Wanneer u het bestand downloadt vanaf een officiële downloadpagina, wordt de controlesom voor het bestand weergegeven in een tekstvak. Selecteer de knop Kopiëren om de waarde van de controlesom naar het klembord te kopiëren.

Gebruik de shasum -a 512 opdracht om de controlesom af te drukken van het bestand dat u hebt gedownload. Met de volgende opdracht wordt bijvoorbeeld de controlesom van het dotnet-sdk-9.0.306-osx-x64.tar.gz-bestand gerapporteerd:

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Vergelijk de controlesom met de waarde van de downloadsite.

Een controlesombestand gebruiken om te valideren

De .NET releaseopmerkingen bevatten een koppeling naar een controlesombestand dat u kunt gebruiken om het gedownloade bestand te valideren. In de volgende stappen wordt beschreven hoe u het controlegetallenbestand downloadt en een .NET-installatieprogramma valideert:

1. De releaseopmerkingenpagina voor .NET 9 op GitHub op https://github.com/dotnet/core/tree/main/release-notes/9.0#releases bevat een sectie met de naam Releases. De tabel in dat gedeelte verwijst naar de downloads en controlesombestanden voor elke release van .NET 9. In de volgende afbeelding ziet u de releasetabel .NET 8 als referentie:

   

2. Selecteer de koppeling voor de versie van .NET die u hebt gedownload.

   In de vorige sectie is .NET SDK 9.0.306 gebruikt. Deze bevindt zich in de release van .NET 9.0.10.

3. Op de releasepagina ziet u de .NET Runtime- en .NET SDK-versie en een koppeling naar het controlesombestand. In de volgende afbeelding ziet u de releasetabel .NET 8 als referentie:

   

4. Klik met de rechtermuisknop op de koppeling Checksum en kopieer deze naar het klembord.

5. Open een terminal.

6. Gebruik curl -O {link} om het controlesombestand te downloaden.

   Vervang de koppeling in de volgende opdracht door de koppeling die u hebt gekopieerd.

   curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
   

7. Met zowel het checksum-bestand als het .NET-releasebestand gedownload naar dezelfde directory, gebruikt u de opdracht shasum -a 512 -c {file} om het gedownloade bestand te valideren.

   Wanneer de validatie is geslaagd, ziet u dat het bestand wordt afgedrukt met de status OK :

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
   

   Als u het bestand ziet dat is gemarkeerd als MISLUKT, is het bestand dat u hebt gedownload, niet geldig en mag het niet worden gebruikt.

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

Op ARM-gebaseerde Macs

In de volgende secties worden de zaken beschreven die u moet overwegen bij het installeren van .NET op een Mac op basis van Arm.

Padverschillen

Op een Mac op basis van Arm worden alle Arm64-versies van .NET geïnstalleerd op de normale map /usr/local/share/dotnet/. Wanneer u echter de x64-versie van .NET SDK installeert, wordt deze geïnstalleerd in de map /usr/local/share/dotnet/x64/dotnet/.

Padvariabelen

Omgevingsvariabelen die .NET toevoegen aan het systeempad, zoals de variabele PATH, moeten mogelijk worden gewijzigd als u zowel de x64- als Arm64-versies van de .NET SDK hebt geïnstalleerd. Daarnaast zijn sommige hulpprogramma's afhankelijk van de omgevingsvariabele DOTNET_ROOT, die ook moet worden bijgewerkt om te verwijzen naar de juiste .NET SDK-installatiemap.

Probleemoplossing

De volgende secties zijn beschikbaar voor hulp bij het oplossen van problemen:

• ARM-gebaseerde Macs
• Maak .NET systeemwijd beschikbaar

.NET beschikbaar maken voor het hele systeem

Soms moeten apps op uw systeem, inclusief de terminal, vinden waar .NET is geïnstalleerd. Het .NET macOS Installer-pakket moet uw systeem automatisch configureren. Als u echter de manuele installatiemethode of het installatiescript .NET hebt gebruikt, moet u de map toevoegen waar .NET is geïnstalleerd aan de PATH-variabele.

Sommige apps zoeken mogelijk naar de variabele DOTNET_ROOT bij het bepalen waar .NET is geïnstalleerd.

Er zijn veel verschillende shells beschikbaar voor macOS en elk heeft een ander profiel. Voorbeeld:

• Bash Shell: ~/.profile, /etc/profile
• Korn Shell: ~/.kshrc of .profile
• Z Shell: ~/.zshrc of .zprofile

Stel de volgende twee omgevingsvariabelen in uw shell-profiel in:

• DOTNET_ROOT

  Deze variabele is ingesteld op de map waar .NET is geïnstalleerd, zoals $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Deze variabele moet zowel de DOTNET_ROOT map als de DOTNET_ROOT/tools map bevatten:

  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
  

Gerelateerde inhoud

• Het controleren of .NET al is geïnstalleerd.
• Werken met macOS Catalina-notarisatie.
• Tutorial: Maak een .NET consoletoepassing.
• Tutorial: Containerize a .NET app.