Control de versiones del SDK de .NET, MSBuild y Visual Studio
El control de versiones del SDK de .NET y cómo se relaciona con Visual Studio y MSBuild puede resultar confuso. MSBuild se instala con Visual Studio, pero también se incluye en el SDK de .NET. El SDK tiene una versión mínima de MSBuild y Visual Studio con la que funciona, y no se cargará en una versión de Visual Studio anterior a esa versión mínima.
Control de versiones
La primera parte de la versión del SDK de NET coincide con la versión de .NET que incluye, en la que se ejecuta y que tiene como destino de manera predeterminada. La banda de características comienza en 1 y aumenta con cada versión secundaria trimestral de Visual Studio. La versión de revisión se incrementa con las actualizaciones de mantenimiento mensuales.
Por ejemplo, la versión 7.0.203 se incluye con .NET 7, es la segunda versión secundaria de Visual Studio desde la versión 7.0.100, y es la tercera revisión desde la versión 7.0.200 publicada.
Una instalación de Visual Studio incluye una sola copia coincidente del SDK de .NET. Si actualiza la instancia de Visual Studio, también se actualiza el SDK de .NET instalado por Visual Studio, incluidas las bandas de características del SDK de .NET y las bandas principales. Si quiere usar un SDK de .NET diferente al instalado por Visual Studio, puede instalarlo desde la página de descarga de .NET y la actualización de Visual Studio no tocará esa versión. Usted es responsable de actualizar esa copia del SDK de .NET a partir de ahora.
Nota:
El SDK de .NET admite versiones de nivel anterior de .NET, por lo que se recomienda actualizar siempre el SDK de .NET junto con la versión de Visual Studio.
Ciclo de vida
El período de tiempo de soporte técnico del SDK normalmente coincide con el de la versión de Visual Studio donde está incluido.
Expanda para ver las versiones de .NET no compatibles
| Versión del SDK | Versión de MSBuild o Visual Studio | Fecha de inclusión | Ciclo de vida |
|---|---|---|---|
| 2.1.5xx | 15,9 | 18 de noviembre | 21 de agosto |
| 2.1.8xx | 16.2 (sin VS) | 19 de julio | 21 de agosto |
| 3.1.1xx | 16.4 | 19 de diciembre | 21 de octubre |
| 3.1.4xx | 16.7 | 20 de agosto | 22 de diciembre |
| 5.0.1xx | 16.8 | Noviembre de 2020 | 21 de marzo |
| 5.0.2xx | 16,9 | 21 de marzo | Mayo de 2022 |
| 5.0.3xx | 16.10 | 21 de mayo | 21 de agosto |
| 5.0.4xx | 16.11 | 21 de agosto | Mayo de 2022 |
| 6.0.1xx | 17.0 | Noviembre de 2021 | 24 de noviembre |
| 6.0.2xx | 17.1 | Febrero de 2022 | Mayo de 2022 |
| 6.0.3xx | 17.23 | Mayo de 2022 | 23 de octubre |
| 6.0.4xx | 17.3 | 22 de agosto | 24 de noviembre |
| 7.0.1xx | 17.4 | 22 de noviembre | Mayo de 2024 |
| 7.0.2xx | 17.53 | 23 de febrero | 23 de mayo |
| 7.0.3xx | 17.6 | 23 de mayo | Mayo de 2024 |
| 7.0.4xx | 17,7 | 23 de agosto | Mayo de 2024 |
Versiones de .NET compatibles
| Versión del SDK | Versión de MSBuild o Visual Studio | Fecha de inclusión | Ciclo de vida |
|---|---|---|---|
| 8.0.1xx | 17.8 | 23 de noviembre | 25 de noviembre1 |
| 8.0.2xx | 17.93 | 24 de febrero | 24de mayo de 3 |
| 8.0.3xx | 17.10 | Mayo de 2024 | TBD |
| 8.0.4xx | 17,11 | 24 de agosto | 25 de noviembre2 |
| 9.0.1xx | 17.12 | 24 de noviembre | 26 de mayo1 |
Nota:
El destino net6.0 solo se admite oficialmente en la versión 17.0 o versiones posteriores de Visual Studio.
El destino net7.0 solo se admite oficialmente en la versión 17.4 o versiones posteriores de Visual Studio.
El destino net8.0 solo se admite oficialmente en la versión 17.8 o versiones posteriores de Visual Studio.
1 La banda de características del SDK .1xx de .NET se admite durante todo el ciclo de vida de las versiones principales de .NET. Durante el período de soporte extendido, el soporte se limita a correcciones de seguridad y correcciones mínimas de alta prioridad no relacionadas con la seguridad solo para Linux. Para más información sobre el razonamiento de este soporte extendido, veaCompatibilidad con el soporte extendido.
2 Las bandas de características del SDK de .NET .4xx se admiten durante la vida útil del entorno de ejecución coincidente como instalaciones independientes.
3 8.0.200 requiere una versión más reciente de Visual Studio. Para obtener más información, consulte las reglas de soporte técnico.
Reglas de destino y compatibilidad
Una directiva siguiente determina en qué versiones de MSBuild y Visual Studio se ejecutará una versión determinada del SDK de .NET:
- Cada nuevo TargetFramework requiere una nueva versión de Visual Studio o una nueva
dotnetversión. - La primera versión de Visual Studio que admite un nuevo TargetFramework se convierte en un piso para las bandas de características de ese SDK para la superficie de la API de Roslyn, destinos de MSBuild, generadores de origen, analizadores, etc.
- La primera versión de un nuevo SDK de .NET que admite un nuevo TargetFramework se puede seguir usando con la versión anterior de Visual Studio para permitir durante un trimestre poder migrar herramientas e infraestructura (por ejemplo, acciones y canalizaciones).
| SDK | Versión de Visual Studio el SDK se incluye con |
Versión mínima de Visual Studio | Max TargetFramework en versión mínima de Visual Studio |
Max TargetFramework en 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:
En la tabla se muestra cómo se aplican estas reglas de control de versiones, empezando por el SDK de .NET 7.0.100 y el SDK de .NET 6.0.300. También muestra cómo se habría aplicado la directiva a las versiones enviadas previamente del SDK de .NET, si estuviera en vigor. Sin embargo, los requisitos para las versiones anteriores del SDK no cambian, es decir, la versión mínima requerida de Visual Studio para .NET SDK 6.0.100 o 6.0.200 sigue siendo 16.10.
1 Un cambio importante en la versión 7.0.300 para el desarrollo de Blazor y Razor requiere la versión 17.6 o posterior de Visual Studio. Para obtener más información, consulte el problema 8718 en dotnet/razor.
Para garantizar herramientas coherentes, debe usar dotnet build en lugar de msbuild para compilar la aplicación siempre que sea posible.
Control de versiones preliminares
Las versiones principales del SDK de .NET se publican normalmente unos días después de una versión preliminar de Visual Studio. Aunque puede haber otras combinaciones que funcionen, solo se prueba la versión preliminar más reciente y se admite oficialmente. En la tabla siguiente se muestra con qué versión de Visual Studio se probó cada versión preliminar de .NET antes de su publicación.
| Versión preliminar del SDK | Versión de Visual Studio |
|---|---|
| 9.0.100, versión preliminar 1 | 17.10, versión preliminar 1 |
| 9.0.100, versión preliminar 2 | 17.10, versión preliminar 2 |
| 9.0.100, versión preliminar 3 | 17.10, versión preliminar 3 |
| 9.0.100, versión preliminar 4 | 17.11, versión preliminar 1 |
| 9.0.100, versión preliminar 5 | 17.11, versión preliminar 2 |
| 9.0.100, versión preliminar 6 | 17.11, versión preliminar 3 |
| 9.0.100, versión preliminar 7 | 17.12, versión preliminar 1 |
| 9.0.100 RC 1 | 17.12, versión preliminar 2 |
| 9.0.100 RC 2 | 17.12, versión preliminar 3 |
| 9.0.100 GA | 17.12 GA |
