Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
Il numero di versione di .NET SDK usa il formato major.minor.patch, dove:
-
major.minorcorrisponde alla versione .NET che l'SDK include, su cui viene eseguito, e che prende di mira per impostazione predefinita. - La cifra delle centinaia di
patchidentifica la banda delle funzionalità, ad esempio1xx,2xx,3xxo4xx. La banda di funzionalità inizia da 1 e aumenta per ogni versione trimestrale di .NET SDK. - Le ultime due cifre di
patchsono la versione della patch, che viene incrementata con l'aggiornamento di manutenzione di ogni mese.
Ad esempio, la versione 7.0.203 viene fornita con .NET 7, è la seconda versione trimestrale di aggiornamenti funzionali dal rilascio della 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.
A partire da Visual Studio 18.0, Visual Studio offre versioni secondarie mensili, mentre .NET SDK continua a essere distribuito trimestralmente. Le versioni di Visual Studio comprese tra le versioni trimestrali del .NET SDK contengono solo le patch della versione più recente dell'SDK di .NET.
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 | Novembre '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 | Nov. '20 | 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 | Novembre '261 |
| 8.0.2xx | 17,9 | Febbraio 2024 | Maggio 2024 |
| 8.0.3xx | 17.10 | Maggio 2024 | Gennaio '26 |
| 8.0.4xx | 17.11 | 24 agosto | Novembre '262 |
| 9.0.1xx | 17.12 | Novembre ‘24 | Maggio '26 |
| 9.0.2xx | 17.13 | Febbraio '25 | Maggio '25 |
| 9.0.3xx | 17.14 | Maggio '25 | Novembre '262 |
| 10.0.1xx | 18,0 | Novembre '25 | Novembre '28 |
| 10.0.2xx | 18.4 | Mar '26 | Maggio '26 |
Nota
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à finali di .NET SDK di una versione principale sono supportate per la durata del runtime corrispondente come installazioni autonome.
Ciclo di vita di Visual Studio 2026
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 una base per gli insiemi di funzionalità dell'SDK nell'ambito delle API di Roslyn, degli obiettivi di MSBuild, dei generatori di codice, degli 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 Lo 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 |
|---|---|---|---|---|
| 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 |
| 9.0.200 | 17.13 | 17.12 | Net9.0 | Net9.0 |
| 9.0.300 | 17.14 | 17.12 | Net9.0 | Net9.0 |
| 10.0.100 | 18,0 | 17.14 | Net9.0 | Net10.0 |
| 10.0.200 | 18.4 | 18,0 | Net10.0 | Net10.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 la politica sarebbe stata applicata alle versioni fornite in precedenza di .NET SDK, se fosse stata in vigore allora. 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.
La destinazione net8.0 è ufficialmente supportata solo in Visual Studio 17.8+.
Il targeting net9.0 è ufficialmente supportato solo in Visual Studio 17.12+.
La destinazione net10.0 è ufficialmente supportata solo in Visual Studio 18.0+.
Per garantire strumenti coerenti, è consigliabile usare dotnet build anziché msbuild per compilare l'applicazione quando possibile.
Matrice di supporto di SDK e Visual Studio
Anche se la maggior parte degli sviluppatori usa .NET SDK in bundle con la versione di Visual Studio, alcune configurazioni comportano una mancata corrispondenza tra SDK e versioni di Visual Studio. Non esiste alcuna garanzia che ogni versione di Visual Studio funzioni con ogni SDK .NET supportato. Le configurazioni più comuni vengono testate per garantire un miglior sforzo di compatibilità.
Compatibilità con le versioni precedenti e successive
-
Configurazione supportata primaria: usare la versione sdk in bundle con l'installazione di Visual Studio
- Visual Studio 17.14 e .NET 9.0.3xx
- Visual Studio 18.0 e .NET 10.0.1xx
- Compatibilità con le versioni precedenti: l'uso della banda di funzionalità più recente della versione precedente dell'SDK (ad esempio, 8.0.4xx in Visual Studio 17.14) è supportato con la massima compatibilità. Il team .NET determina quando eseguire il backport delle correzioni in base al rischio e all'impatto dei clienti. Anche se gli SDK meno recenti della banda precedente potrebbero funzionare, il team di .NET non li testa o fa uno sforzo per garantire la compatibilità.
- Compatibilità in avanti: l'uso di un SDK più recente (ad esempio, .NET 10 SDK in Visual Studio 17.14) è consentito senza bloccare, ma la destinazione dei runtime più recenti nelle versioni precedenti di Visual Studio non è supportata e genera un avviso di compilazione.
Linee guida
Usare l'SDK fornito con l'istanza di Visual Studio (o la versione più recente disponibile in CI o Visual Studio Code), in quanto tale versione include sempre le funzionalità più recenti, inclusi gli aggiornamenti della sicurezza.
Supporto di targeting di livello inferiore
.NET SDK mantiene il supporto di destinazione per le versioni di .NET non più supportate. L'SDK 10.0.100 può creare app destinate net9.0 fino a netcoreapp1.0.
Principi guida
- Supporto esistente mantenuto: la destinazione del supporto per le versioni non supportate rimane nell'SDK senza la rimozione attiva. I clienti che aggiornano l'SDK o la versione di Visual Studio non dovrebbero avere compilazioni fallite solo per aver mirato a una versione precedente di .NET.
- Nuove funzionalità: le nuove funzionalità dell'SDK non sono necessarie per supportare versioni non supportate, a meno che non si escluda tale supporto comporta costi o rischi notevoli.
- Correzioni di guasti: Se si verificano problemi quando si prende di mira versioni non supportate, si applica una correzione in base al costo della correzione. L'obiettivo è evitare che i clienti riscontrino problemi durante l'aggiornamento.
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 |
|---|---|
| 10.0.100 RC 1 | 18.0.0 Insiders (11010.61) |
| 10.0.100 RC 2 | 18.0.0 Insiders (11111.16) |
| 11.0.100 Preview 1 | 18.4.0 Insider |
| 11.0.100 Preview 2 | 18.5.0 Insider |
Riferimento
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
