Controllo delle versioni di .NET SDK, MSBuild e Visual Studio
Il controllo delle versioni di .NET SDK e la correlazione con Visual Studio e MSBuild possono generare confusione. Versioni di MSBuild con Visual Studio, ma incluse anche in .NET SDK. SDK ha una versione minima di MSBuild e Visual Studio con cui funziona e non verrà caricata in una versione di Visual Studio precedente a quella versione minima.
Controllo delle versioni
La prima parte della versione di .NET SDK corrisponde alla versione di .NET inclusa, eseguita e con destinazioni per impostazione predefinita. La banda di funzionalità inizia da 1 e aumenta per ogni versione secondaria trimestrale di Visual Studio. La versione della patch viene incrementata con gli aggiornamenti di manutenzione mensili.
Ad esempio, la versione 7.0.203 viene fornita con .NET 7, è la seconda versione secondaria di Visual Studio a partire dalla versione 7.0.100 ed è la terza patch rilasciata dalla versione 7.0.200.
Un'installazione di Visual Studio include una singola copia corrispondente di .NET SDK. Se si aggiorna l'istanza di Visual Studio, viene aggiornato anche il .NET SDK installato da Visual Studio, comprese le bande di funzionalità e le bande principali di .NET SDK. Se si vuole usare un SDK .NET diverso da quello installato da Visual Studio, è possibile installarlo dalla pagina di download di .NETe l'aggiornamento di Visual Studio non tocca tale versione. L'utente è responsabile dell'aggiornamento di tale copia di .NET SDK da allora in poi.
Nota
.NET SDK supporta le versioni di livello inferiore di .NET, quindi è consigliabile aggiornare sempre .NET SDK insieme alla versione di Visual Studio.
Ciclo di vita
L'intervallo di tempo di supporto per l'SDK corrisponde in genere a quello della versione di Visual Studio in cui è incluso.
Espandi per visualizzare le versioni .NET non supportate
| Versione dell'SDK | Versione MSBuild/Visual Studio | Data di spedizione | Ciclo di vita |
|---|---|---|---|
| 2.1.5xx | 15.9 | Nov '18 | Agosto 2021 |
| 2.1.8xx | 16.2 (Senza VS) | Luglio 2019 | Agosto 2021 |
| 3.1.1xx | 16.4 | Dicembre 2019 | Ottobre 2021 |
| 3.1.4xx | 16.7 | Agosto 2020 | Dicembre 2022 |
| 5.0.1xx | 16.8 | Novembre 2020 | Marzo 2021 |
| 5.0.2xx | 16.9 | Marzo 2021 | Maggio 2022 |
| 5.0.3xx | 16,10 | Maggio 2021 | Agosto 2021 |
| 5.0.4xx | 16.11 | Agosto 2021 | Maggio 2022 |
| 6.0.1xx | 17.0 | Novembre 2021 | Novembre ‘24 |
| 6.0.2xx | 17.1 | Febbraio 2022 | Maggio 2022 |
| 6.0.3xx | 17.23 | Maggio 2022 | Ottobre 2023 |
| 6.0.4xx | 17.3 | Agosto 2022 | Novembre ‘24 |
| 7.0.1xx | 17.4 | Novembre 2022 | Maggio 2024 |
| 7.0.2xx | 17.53 | Febbraio 2023 | Maggio 2023 |
| 7.0.3xx | 17.6 | Maggio 2023 | Maggio 2024 |
| 7.0.4xx | 17.7 | Agosto 2023 | Maggio 2024 |
Versioni di .NET supportate
| Versione dell'SDK | Versione MSBuild/Visual Studio | Data di spedizione | Ciclo di vita |
|---|---|---|---|
| 8.0.1xx | 17.8 | Novembre 2023 | 25 novembre1 |
| 8.0.2xx | 17.93 | Febbraio 2024 | Maggio '243 |
| 8.0.3xx | 17.10 | Maggio 2024 | Da definire |
| 8.0.4xx | 17.11 | 24 agosto | 25 novembre2 |
| 9.0.1xx | 17.12 | Novembre ‘24 | Maggio ‘262 |
Nota
La destinazione net6.0 è ufficialmente supportata solo in Visual Studio 17.0+.
La destinazione net7.0 è ufficialmente supportata solo in Visual Studio 17.4+.
La destinazione net8.0 è ufficialmente supportata solo in Visual Studio 17.8+.
1 Le bande di funzionalità di .NET SDK .1xx sono supportate durante tutto il ciclo di vita delle principali versioni di .NET. Durante il periodo esteso, il supporto è limitato alle correzioni di sicurezza e alle correzioni minime non di sicurezza con priorità elevata solo per Linux. Per altre informazioni sul motivo di questo supporto esteso, vedere Supporto per la compilazione di origine.
2 Le bande di funzionalità .4xx .NET SDK sono supportate per la durata del runtime corrispondente come installazioni autonome.
3 8.0.200 richiede una versione più recente di Visual Studio. Per altre informazioni, vedere le regole di supporto.
Regole di destinazione e supporto
I criteri seguenti determinano le versioni di MSBuild e Visual Studio in cui verrà eseguita una determinata versione di .NET SDK:
- Ogni nuovo TargetFramework richiede una nuova versione di Visual Studio o una nuova versione
dotnet. - La prima versione di Visual Studio che supporta un nuovo TargetFramework diventa un piano per le bande di funzionalità della superficie dell'SDK per l'API Roslyn, le destinazioni MSBuild, i generatori di origine, gli analizzatori e così via.
- La prima versione di un nuovo SDK .NET che supporta un nuovo TargetFramework può comunque essere usata con la versione precedente di Visual Studio per consentire un trimestre per gli strumenti e l'infrastruttura (ad esempio, azioni e pipeline) di cui eseguire la migrazione.
| SDK | Versione di Visual Studio SDK viene fornito con |
Versione minima di Visual Studio | Numero massimo di TargetFramework in versione minima di Visual Studio |
Numero massimo di TargetFramework in dotnet |
|---|---|---|---|---|
| 6.0.200 | 17.1 | 17.0 | Net6.0 | Net6.0 |
| 6.0.300 | 17.2 | 17.0 | Net6.0 | Net6.0 |
| 6.0.400 | 17.3 | 17.0 | Net6.0 | Net6.0 |
| 7.0.100 | 17.4 | 17.3 | Net6.0 | Net7.0 |
| 7.0.200 | 17.5 | 17.4 | Net7.0 | Net7.0 |
| 7.0.300 | 17.6 | 17.41 | Net7.0 | Net7.0 |
| 7.0.400 | 17.7 | 17.4 | Net7.0 | Net7.0 |
| 8.0.100 | 17.8 | 17.7 | Net7.0 | Net8.0 |
| 8.0.200 | 17.9 | 17.8 | Net8.0 | Net8.0 |
| 8.0.300 | 17.10 | 17.8 | Net8.0 | Net8.0 |
| 8.0.400 | 17.11 | 17.8 | Net8.0 | Net8.0 |
| 9.0.100 | 17.12 | 17.11 | Net8.0 | Net9.0 |
Nota
La tabella illustra come vengono applicate queste regole di controllo delle versioni, a partire da .NET SDK 7.0.100 e .NET SDK 6.0.300. Illustra anche come i criteri sarebbero stati applicati alle versioni fornite in precedenza di .NET SDK, in seguito. Tuttavia, i requisiti per le versioni precedenti dell'SDK non cambiano, ovvero la versione minima richiesta di Visual Studio per .NET SDK 6.0.100 o 6.0.200 rimane 16.10.
1 Una modifica che causa un'interruzione nella versione 7.0.300 per lo sviluppo Blazor e Razor richiede Visual Studio versione 17.6 o successiva. Per altre informazioni, vedere dotnet/razor issue 8718.
Per garantire strumenti coerenti, è consigliabile usare dotnet build anziché msbuild per compilare l'applicazione quando possibile.
Controllo delle versioni in anteprima
Le versioni principali di .NET SDK vengono in genere rilasciate entro pochi giorni da una versione di anteprima di Visual Studio. Anche se potrebbero funzionare altre combinazioni, viene testata e ufficialmente supportata solo l'ultima anteprima rilasciata. La tabella seguente illustra la versione di Visual Studio con cui è stata testata ogni versione di anteprima .NET prima del rilascio.
| Versione di anteprima di SDK | Versione di Visual Studio |
|---|---|
| 9.0.100 Preview 1 | 17.10 Preview 1 |
| 9.0.100 Preview 2 | 17.10 Preview 2 |
| 9.0.100 Preview 3 | 17.10 Preview 3 |
| 9.0.100 Anteprima 4 | 17.11 Anteprima 1 |
| 9.0.100 Anteprima 5 | 17.11 Anteprima 2 |
| 9.0.100 Anteprima 6 | 17.11 Anteprima 3 |
| 9.0.100 Anteprima 7 | 17.12 Anteprima 1 |
| 9.0.100 RC 1 | 17.12 Anteprima 2 |
| 9.0.100 RC 2 | 17.12 Anteprima 3 |
| 9.0.100 GA | 17.12 DISPONIBILITÀ generale |
