Inizia con dotnetup

Note

dotnetup è disponibile in anteprima pubblica. Le funzionalità e il comportamento potrebbero cambiare prima della disponibilità generale.

dotnetupè un gestore toolchain multipiattaforma per le installazioni di .NET a livello di utente. Installa, aggiorna e rimuove .NET SDK e runtime senza usare un gestore di pacchetti di sistema.

Prerequisites

  • Uno dei seguenti sistemi operativi e delle seguenti architetture:

    Sistema operativo Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), ad esempio Alpine Linux x64, Arm64

  • Terminale.

  • Per eseguire lo script di download, Bash in macOS o Linux o PowerShell in Windows.

  • In macOS o Linux curl o wget per scaricare i file e sha512sum o shasum per verificarli.

dotnetup ha gli stessi requisiti di sistema del .NET Runtime. Per i requisiti specifici del sistema operativo, vedere Installare .NET in Windows, Installare .NET in macOS o Installare .NET in Linux.

Importante

In Windows, l'installazione predefinita usa la everywhere modalità di accesso. Questa modalità:

  • Richiede l'elevazione dei privilegi per aggiornare il sistema PATH.
  • Fa sì che l'installazione gestita da dotnetup abbia la precedenza sulle installazioni .NET a livello di computer, ad esempio quelle installate da Visual Studio. Progetti e app che richiedono un SDK o un runtime a livello di sistema che non è installato anche da dotnetup non riescono a compilare o eseguire.
  • Modifica il sistema PATH, che si applica a tutti gli utenti. I processi con privilegi elevati avviati da altri utenti potrebbero individuare .NET nel profilo utente.

Per evitare questi effetti, scegliere la modalità di accesso shell o none durante l'installazione. Se si sceglie everywhere, eseguire la migrazione delle installazioni esistenti quando il programma di installazione lo offre. Per informazioni dettagliate, vedere Considerazioni sulla modalità Ovunque.

Scarica dotnetup

Gli script di download installano la build più recente preview per impostazione predefinita. Verificano il file eseguibile scaricato con il checksum SHA-512 e lo installano in ~/.dotnetup.

In macOS o Linux eseguire:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

In Windows eseguire:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Per installare la build più recente daily in macOS o Linux, eseguire:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Per installare la build più recente daily in Windows, eseguire:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Importante

Le compilazioni giornaliere non hanno completato la convalida del rilascio e non sono firmate digitalmente. Usare le compilazioni giornaliere solo per i test di breve durata.

Gli script stampano istruzioni per aggiungere dotnetup a PATH. Aprire un nuovo terminale dopo aver applicato le istruzioni.

Configurazione iniziale

Eseguire la configurazione interattiva:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

I percorsi, la visualizzazione dello stato e le indicazioni sull'ambiente dipendono dal sistema e dalla modalità selezionata.

La modalità di accesso consigliata è everywhere su Windows. In macOS e Linux, è shell quando dotnetup rileva una shell supportata e none in caso contrario.

Selezionare No, personalizzare la configurazione per scegliere il canale SDK, la modalità di accesso e le opzioni di migrazione.

Scegliere un canale SDK

Un canale SDK indica dotnetup quale SDK installare e come aggiornarlo.

Modulo del canale Example Result
Ultima versione stabile latest Ultimo SDK stabile attivo
LTS più recente lts SDK LTS stabile attivo più recente
Ultima anteprima preview SDK di anteprima più recente
Ultimo aggiornamento giornaliero daily SDK giornaliero più recente disponibile
Maggiore 10 SDK più recente per la versione principale specificata
Maggiore e Minore 10.0 SDK più recente per la versione major e minor specificata
barra delle funzionalità 10.0.1xx SDK più recente nel feature band specificato
Versione esatta 10.0.103 Solo la versione dell'SDK specificata
Nessun SDK iniziale none Saltare l'installazione durante la configurazione

Le versioni esatte non avanzano durante gli aggiornamenti. Per tutte le forme accettate, vedere canali e versioni di dotnetup.

Scegliere come accedere a .NET

La modalità di accesso controlla il modo in cui i terminali e le applicazioni trovano l'installazione di .NET gestita da dotnetup.

Modalità di accesso Behavior
none Non modifica queste variabili di ambiente. Eseguire .NET con dotnetup dotnet.
shell Modifica il profilo della shell per impostare queste variabili di ambiente. I processi avviati da tale shell usano gli SDK e i runtime di .NET installati da dotnetup.
everywhere Modifica il sistema PATH e imposta la variabile di ambiente utente di livello DOTNET_ROOT. Disponibile solo su Windows.

Per altri dettagli e considerazioni sulla everywhere modalità, vedere configurazione dell'ambiente dotnetup.

Eseguire la migrazione di installazioni esistenti

Il programma di installazione può offrire la migrazione delle installazioni esistenti di SDK e runtime .NET a livello di sistema nell'installazione gestita da dotnetup. Vedere Considerazioni sulla modalità Ovunque per i motivi per cui la migrazione è particolarmente importante con la modalità everywhere.

Verificare l'installazione

Apri un nuovo terminale dopo che la configurazione ha modificato l'ambiente.

Per la modalità shell o everywhere, eseguire:

dotnet --version
dotnetup list

Per none la modalità, eseguire:

dotnetup dotnet -- --version
dotnetup list

Eseguire dotnetup init di nuovo per modificare il programma di installazione.

  • Ultimo aggiornamento: