Lezen in het Engels

Delen via


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

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.

macOS-versie .NET
macOS 15 "Sequoia" 9.0, 8.0
macOS 14 'Sonoma' 9.0, 8.0
macOS 13 "Ventura" 9.0, 8.0

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 auteur van een app een app publiceert, kan deze 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
    Voert ASP.NET Core-apps uit. 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 het mogelijk niet mogelijk dat het systeembreed wordt 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 C# Dev Kit-extensie 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.

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

  • .NET handmatig installeren

    Gebruik deze installatiemethode wanneer u .NET moet installeren in een specifieke map en deze moet uitvoeren, afgezien van 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 8.0.

    De .NET-downloadwebsite. Versies 6.0 tot en met 9.0 worden vermeld. In een rood vak worden deze downloadkoppelingen gemarkeerd.

    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 nieuwste .NET-versie. De SDK ondersteunt het bouwen van apps voor eerdere versies van .NET.

    Tip

    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.

    De .NET-downloadwebsite met de SDK- en Runtime-downloadkoppelingen. De SDK- en Runtime-headers zijn gemarkeerd met een rood vak. Elk vak heeft een pijl omlaag naar de macOS-sectie.

    Er zijn twee secties gemarkeerd in de vorige afbeelding. Als u de SDK downloadt, raadpleegt u sectie 1. Raadpleeg sectie 2 voor .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.
    • Sectie 2 (runtime)

      Deze sectie bevat de runtimedownloads. 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.

      Een schermopname van alleen de .NET Runtime-downloadtabel van de .NET-downloadwebsite. De rij macOS is gemarkeerd met een rood vak.

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

    Een schermopname van alleen het .NET-installatieprogramma dat wordt uitgevoerd op macOS.

.NET handmatig 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.

Tip

Gebruik het install-dotnet.sh script om deze stappen automatisch uit te voeren.

  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 nieuwste .NET-versie. De SDK ondersteunt het bouwen van apps voor eerdere versies van .NET.

    Tip

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

    De .NET-downloadwebsite. Versies 6.0 tot en met 9.0 worden vermeld. In een rood vak worden deze downloadkoppelingen gemarkeerd.

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

    De .NET-downloadwebsite met de SDK-downloadkoppelingen. De SDK-header is gemarkeerd met een rood vak. Het vak heeft een pijl omlaag naar de sectie macOS.

    • 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-bestand is gedownload.

  5. Pak de tarball uit naar waar u .NET op uw systeem wilt. In het volgende voorbeeld wordt de basismap ~/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 waar .NET is geïnstalleerd en voer de dotnet --info opdracht 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 is standaard ingesteld op het installeren van de nieuwste LTS-versie (Long Term Support), die .NET 8 is. U kunt een specifieke release kiezen door de channel switch op te geven. Neem de runtime switch op om een runtime te installeren. Anders installeert het script de SDK.

Tip

Deze opdrachten worden aan het einde van deze procedure voorzien van een scriptfragment.

  1. Open een terminal.

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

  3. Als u de opdracht niet hebt, installeert u deze wget 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 ~/.dotnet map te navigeren en de dotnet --info opdracht uit te voeren:

chdir ~/.dotnet
./dotnet --info

Belangrijk

Sommige programma's kunnen omgevingsvariabelen gebruiken om .NET op uw systeem te vinden en het gebruik van de opdracht werkt mogelijk niet bij het dotnet openen van een nieuwe terminal. Zie de sectie .NET beschikbaar maken voor het hele systeem voor hulp bij het oplossen van dit probleem.

.NET voor Visual Studio Code installeren

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

Zie Aan de slag met 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ïnitialiseerd, 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:

waarschuwing voor macOS Catalina-notarisatie

Zie Werken met 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.

De .NET-downloadpagina met controlesom

Gebruik de sha512sum 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-8.0.100-linux-x64.tar.gz-bestand gerapporteerd:

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  dotnet-sdk-8.0.100-linux-x64.tar.gz

Vergelijk de controlesom met de waarde van de downloadsite.

Belangrijk

Hoewel in deze voorbeelden een Linux-bestand wordt weergegeven, is deze informatie ook van toepassing op macOS.

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 controlesombestand downloadt en een binaire .NET-installatie valideert:

  1. De releaseopmerkingenpagina voor .NET 8 op GitHub bevat https://github.com/dotnet/core/tree/main/release-notes/8.0#releases een sectie met de naam Releases. De tabel in die sectie is gekoppeld aan de downloads en controlesombestanden voor elke .NET 8-release:

    De github-releaseopmerkingen voor versietabel voor .NET

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

    In de vorige sectie is .NET SDK 8.0.100 gebruikt. Deze bevindt zich in de .NET 8.0.0-release.

  3. Op de releasepagina ziet u de .NET Runtime- en .NET SDK-versie en een koppeling naar het controlesombestand:

    De downloadtabel met controlesommen voor .NET

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

  5. Open een terminal.

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

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

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
    
  7. Wanneer zowel het checksum-bestand als het .NET-releasebestand naar dezelfde map zijn gedownload, gebruikt u de sha512sum -c {file} --ignore-missing opdracht om het gedownloade bestand te valideren.

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

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
    dotnet-sdk-8.0.100-linux-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.

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
    dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
    sha512sum: WARNING: 1 computed checksum did NOT match
    sha512sum: 8.0.0-sha.txt: no file was verified
    

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.

Verschillen in pad

Op een Op Arm gebaseerde Mac worden alle Arm64-versies van .NET geïnstalleerd in 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 PATH variabele, 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 DOTNET_ROOT omgevingsvariabele, 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:

.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 handmatige installatiemethode of het .NET-installatiescript hebt gebruikt, moet u de map toevoegen waarin .NET is geïnstalleerd aan de PATH variabele.

Sommige apps zoeken mogelijk naar de DOTNET_ROOT variabele 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 .NET is geïnstalleerd op, 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
    

System.Drawing.Common en opgedeelde

.NET-toepassingen die gebruikmaken van de System.Drawing.Common assembly moeten libgdiplus worden geïnstalleerd.

Een eenvoudige manier om te verkrijgen libgdiplus is door het Homebrew-pakketbeheer ('brew') voor macOS te gebruiken. Nadat u brew hebt geïnstalleerd, installeert libgdiplus u deze door de volgende opdrachten uit te voeren in de terminal:

brew update
brew install mono-libgdiplus