Installare .NET in macOS

Questo articolo illustra quali versioni di .NET sono supportate in macOS, come installare .NET e qual è la differenza tra l'SDK e il runtime.

La versione più recente di .NET è 10.

Versioni supportate

Nella tabella seguente sono elencate le versioni di .NET supportate e le versioni di macOS supportate. Queste versioni rimangono supportate fino a quando la versione di .NET raggiunge la fine del supporto o la versione di macOS non è più supportata.

Le versioni seguenti di .NET sono ❌ non più supportate:

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

Il runtime viene usato per eseguire le app create con .NET. Quando un autore di app pubblica un'app, può includere il runtime con l'app. Se non include il runtime, l'utente dovrà installare quello corretto.

Esistono due runtime che è possibile installare in macOS ed entrambi sono inclusi nell'SDK.

• ASP.NET Core Runtime
  Esegue applicazioni ASP.NET Core. Include il runtime di .NET. Non disponibile come programma di installazione.

• .NET Runtime
  Questa esegue app .NET normalmente, ma non app specializzate, come le app basate su ASP.NET Core.

Il SDK viene usato per compilare e pubblicare .NET app e librerie. L'SDK più recente supporta la creazione di app per le versioni precedenti di .NET. In circostanze normali, è necessario installare solo l'SDK più recente.

L'installazione dell'SDK include sia il runtime di .NET standard che il runtime di ASP.NET Core. Ad esempio, se è installato .NET SDK 9.0, .NET Runtime 9.0 e ASP.NET Core runtime 9.0 sono entrambi installati. Tuttavia, qualsiasi altra versione del runtime non verrà installata con l'SDK e richiederebbe di installarla separatamente.

Scegliere come installare .NET

Esistono diversi modi per installare .NET e alcuni prodotti possono gestire la propria versione di .NET. Se si installa .NET tramite software che gestisce la propria versione di .NET, potrebbe non essere abilitata a livello di sistema. Assicurarsi di comprendere le implicazioni dell'installazione di .NET tramite altri software.

Se non si è certi del metodo da scegliere dopo aver esaminato gli elenchi nelle sezioni seguenti, è probabile che si voglia usare il pacchetto del programma di installazione di .NET.

Sviluppatori

• Visual Studio Code - C# Dev Kit

  Installare l'estensione C# Dev Kit per Visual Studio Code per sviluppare app .NET. L'estensione può usare un SDK già installato o installarlo automaticamente.

Utenti e sviluppatori

• .NET Installer

  Usare il programma di installazione autonomo per installare .NET. Questo metodo è il modo tipico per installare .NET nel computer sviluppatore o utente.

• Installare .NET con uno script

  Uno script bash in grado di automatizzare l'installazione dell'SDK o del runtime. È possibile scegliere la versione di .NET da installare.

• Installare .NET manualmente

  Usare questo metodo di installazione quando è necessario installare .NET in una cartella specifica ed eseguirlo oltre ad altre copie di .NET.

Installare .NET

I pacchetti del programma di installazione sono disponibili per macOS, un modo semplice per installare .NET.

1. Aprire un browser e passare a https://dotnet.microsoft.com/download/dotnet.

2. Selezionare il collegamento alla versione .NET da installare, ad esempio .NET 10.0.

   

   Questo collegamento consente di visualizzare la pagina con collegamenti per scaricare tale versione di .NET

   Se si intende installare l'SDK, scegliere la versione .NET più recente. L'SDK supporta la creazione di app per le versioni precedenti di .NET.

   Suggerimento

   Se non si è certi della versione da scaricare, scegliere la versione contrassegnata come più recente.

3. Questa pagina presenta i collegamenti di download per l'SDK e il runtime. Qui è possibile scaricare .NET SDK o .NET Runtime.

   

   Nell'immagine precedente, sono evidenziate due sezioni. Se si sta scaricando l'SDK, vedere la sezione 1. Per il runtime di .NET, vedere la sezione 2.

   • Sezione 1 (SDK)

     Questa sezione è l'area di download dell'SDK. Nella colonna Programmi di installazione per la riga macOS sono elencate due architetture: Arm64 e x64.

     • Se si esegue un processore Apple, ad esempio M1 o M3 Pro, selezionare Arm64.
     • Se stai usando un processore Intel, seleziona x64.

   • Sezione 2 (ambiente di esecuzione)

     Questa sezione contiene i download di runtime. Si noti che i collegamenti per la colonna Installers nella riga macOS sono vuoti. Questa sezione è vuota perché l'ASP.NET Core Runtime viene fornito solo nell'SDK o tramite l'installazione binary.

     Scorrere più verso il basso per trovare il .NET Runtime standard per il download.

     

     • Se si esegue un processore Apple, ad esempio M1 o M3 Pro, selezionare Arm64.
     • Se stai utilizzando un processore Intel, seleziona x64.

4. Al termine del download, aprirlo.

5. Seguire la procedura descritta nel programma di installazione.

   

Installare .NET manualmente

In alternativa ai programmi di installazione di macOS, è possibile scaricare e installare manualmente l'SDK e il runtime. L'installazione manuale viene in genere eseguita come parte automatica dello scenario di integrazione continua. Gli sviluppatori e gli utenti in genere vogliono usare il programma di installazione.

1. Aprire un browser e passare a https://dotnet.microsoft.com/download/dotnet.

2. Selezionare il collegamento alla versione .NET da installare, ad esempio .NET 8.0.

   Questo collegamento consente di visualizzare la pagina con collegamenti per scaricare tale versione di .NET

   Se si intende installare l'SDK, scegliere la versione .NET più recente. L'SDK supporta la creazione di app per le versioni precedenti di .NET.

   Suggerimento

   Se non si è certi della versione da scaricare, scegliere la versione contrassegnata come più recente.

   

3. Selezionare il collegamento all'SDK o al runtime da installare. Cercare la colonna Binaries nella riga macOS.

   

   • Se si esegue un processore Apple, ad esempio M1 o M3 Pro, selezionare Arm64.
   • Se si sta eseguendo un processore Intel, selezionare x64.

4. Aprire un terminale e passare alla posizione in cui è stato scaricato il file binario .NET.

5. Estrarre il tarball nella posizione desiderata per .NET sul sistema. Nell'esempio seguente, viene utilizzata la directory HOME~/Applications/.dotnet.

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

Verificare che .NET funzioni modificando la directory in cui è stato installato .NET ed eseguire il comando dotnet --info:

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

Installare .NET con uno script

Gli script dotnet-install vengono utilizzati per l'automazione e le installazioni del runtime senza privilegi elevati. È possibile scaricare lo script da https://dot.net/v1/dotnet-install.sh.

Per impostazione predefinita, lo script installa la versione più recente long term support (LTS), che è .NET 8. È possibile scegliere una versione specifica specificando l'opzione channel. Includere l'opzione runtime per installare un runtime. In caso contrario, lo script installa l'SDK.

1. Aprire un terminale.

2. Passare a una cartella in cui si desidera scaricare lo script, ad esempio ~/Downloads.

3. Se il comando wget non è disponibile, installarlo con Brew

   brew install wget
   

4. Eseguire il comando seguente per scaricare lo script:

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

5. Assegnare allo script le autorizzazioni di esecuzione

   chmod +x dotnet-install.sh
   

6. Eseguire lo script per installare .NET.

   Lo script usa per impostazione predefinita l'installazione dell'SDK più recente nella directory ~/.dotnet.

   ./dotnet-install.sh
   

Ecco tutti i comandi come singolo script bash:

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

Testare .NET passando alla cartella ~/.dotnet ed eseguendo il comando dotnet --info:

chdir ~/.dotnet
./dotnet --info

Installare .NET per Visual Studio Code

Visual Studio Code è un editor di codice sorgente potente e leggero che viene eseguito sul desktop. Visual Studio Code può usare l'SDK già installato sul tuo sistema. Inoltre, l'estensione C# Dev Kit installerà automaticamente .NET se non è già installata.

Per istruzioni sull'installazione di .NET tramite Visual Studio Code, vedere Introduzione a C# in VS Code.

Notarizzazione/Cerificazione notarile

Il software creato per macOS distribuito con un ID sviluppatore deve essere notarizzato, incluse le app create con .NET.

Se si esegue un'app non autenticata, verrà visualizzata una finestra di errore simile all'immagine seguente:

Per ulteriori informazioni su come la notarizzazione obbligatoria influisce su .NET (e sulle tue app .NET), vedere Come lavorare con la notarizzazione di macOS Catalina.

Validazione

Dopo aver scaricato un programma di installazione o la versione binaria, verificare che il file non sia stato modificato o danneggiato. È possibile verificare il checksum nel computer e quindi confrontarlo con ciò che è stato segnalato nel sito Web di download.

Quando si scarica il file da una pagina di download ufficiale, viene visualizzato il checksum per il file in una casella di testo. Selezionare il pulsante Copia per trasferire il valore del checksum nella clipboard.

Usare il comando shasum -a 512 per stampare il checksum del file scaricato. Ad esempio, il comando seguente segnala il checksum del file dotnet-sdk-9.0.306-osx-x64.tar.gz :

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

Confrontare il checksum con il valore fornito dal sito di download.

Usare un file di checksum per la convalida

Le note sulla versione .NET contengono un collegamento a un file di checksum che è possibile usare per convalidare il file scaricato. I passaggi seguenti descrivono come scaricare il file di checksum e convalidare un file binario di installazione .NET:

1. La pagina delle note sulla versione per .NET 9 su GitHub al https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contiene una sezione chiamata Releases. La tabella in questa sezione è collegata ai file di download e checksum per ogni versione .NET 9. L'immagine seguente mostra la tabella di rilascio .NET 8 come riferimento:

   

2. Selezionare il collegamento per la versione di .NET scaricata.

   La sezione precedente usava .NET SDK 9.0.306, che si trova nella versione .NET 9.0.10.

3. Nella pagina della versione è possibile visualizzare la versione di .NET Runtime e .NET SDK e un collegamento al file di checksum. L'immagine seguente mostra la tabella di rilascio .NET 8 come riferimento:

   

4. Fare clic con il pulsante destro del mouse sul collegamento Checksum e copiarlo negli Appunti.

5. Aprire un terminale.

6. Usare curl -O {link} per scaricare il file di checksum.

   Sostituire il collegamento nel seguente comando con il collegamento copiato.

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

7. Con il file checksum e il file di versione .NET scaricato nella stessa directory, usare il comando shasum -a 512 -c {file} per convalidare il file scaricato.

   Quando la convalida viene superata, viene visualizzato il file stampato con lo stato OK:

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

   Se il file viene contrassegnato come FAILED, il file scaricato non è valido e non deve essere usato.

   $ 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
   

Mac con architettura ARM

Le sezioni seguenti descrivono gli aspetti da considerare durante l'installazione di .NET in un Mac basato su Arm.

Differenze di percorso

In un Mac basato su Arm, tutte le versioni arm64 di .NET vengono installate nella normale cartella /usr/local/share/dotnet/. Tuttavia, quando si installa x64 versione di .NET SDK, viene installata nella cartella /usr/local/share/dotnet/x64/dotnet/.

Variabili di percorso

Le variabili di ambiente che aggiungono .NET al percorso di sistema, ad esempio la variabile PATH, potrebbero essere modificate se sono installate sia le versioni x64 che Arm64 dell'SDK di .NET. Inoltre, alcuni strumenti si basano sulla variabile di ambiente DOTNET_ROOT, che dovrebbe anche essere aggiornata per puntare alla cartella di installazione appropriata di .NET SDK.

Risoluzione dei problemi

Le sezioni seguenti sono disponibili per la risoluzione dei problemi:

• Mac con tecnologia Arm
• Make .NET disponibile a livello di sistema

Rendere .NET disponibile a livello di sistema

A volte le app nel sistema, incluso il terminale, devono trovare dove è installato .NET. Il pacchetto del programma di installazione .NET macOS deve configurare automaticamente il sistema. Tuttavia, se è stato usato il metodo di installazione manual o .NET script di installazione, è necessario aggiungere la directory in cui è stata installata .NET alla variabile PATH.

Alcune app potrebbero cercare la variabile DOTNET_ROOT quando si tenta di determinare dove è installato .NET.

Sono disponibili molte shell diverse per macOS e ognuna ha un profilo diverso. Ad esempio:

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

Impostare le due variabili di ambiente seguenti nel profilo della shell:

• DOTNET_ROOT

  Questa variabile è impostata sulla cartella .NET installata, ad esempio $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Questa variabile deve includere sia la cartella DOTNET_ROOT sia la cartella DOTNET_ROOT/tools:

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

Contenuto correlato

• Come verificare se .NET è già installato.
• Uso dell'autenticazione di macOS Catalina.
• Tutorial: creare un'applicazione console .NET.
• Tutorial: containerizzare un'app .NET.