Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
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
El número de versión del SDK de .NET usa el formato major.minor.patch, donde:
-
major.minorcoincide con la versión de .NET en la que el SDK incluye, se ejecuta y tiene como destino de forma predeterminada. - El dígito de las centenas de
identifica la banda de funciones ; por ejemplo, , , o . La banda de características comienza en 1 y aumenta para cada versión trimestral del SDK de .NET. - Los dos últimos dígitos de
patchson la versión de revisión, que se incrementa con cada actualización de servicio mensual.
Por ejemplo, la versión 7.0.203 se lanza con .NET 7, es el segundo lanzamiento trimestral de actualización de características desde la versión 7.0.100, y es la tercera actualización desde que se publicó la versión 7.0.200.
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.
A partir de Visual Studio 18.0, Visual Studio publica versiones menores mensuales, mientras que el SDK de .NET continúa distribuyéndose trimestralmente. Las versiones de Visual Studio durante los lanzamientos trimestrales del SDK de .NET solo contienen versiones de parche del SDK de .NET más reciente.
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 envío | 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 envío | Ciclo de vida |
|---|---|---|---|
| 8.0.1xx | 17.8 | 23 de noviembre | 26 de noviembre1 |
| 8.0.2xx | 17,9 | 24 de febrero | Mayo de 2024 |
| 8.0.3xx | 17.10 | Mayo de 2024 | 26 de enero |
| 8.0.4xx | 17,11 | 24 de agosto | 26 de noviembre2 |
| 9.0.1xx | 17.12 | 24 de noviembre | Mayo de 26 |
| 9.0.2xx | 17.13 | 25 de febrero | Mayo de 25 |
| 9.0.3xx | 17.14 | Mayo de 25 | 26 de noviembre2 |
| 10.0.1xx | 18.0 | noviembre de 2025 | 28 de noviembre |
| 10.0.2xx | 18.4 | 26 de marzo | Mayo de 26 |
Nota:
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, vea Source-build support.
2 Las bandas de características finales de una versión principal del SDK de .NET son compatibles durante toda la vida útil del entorno de ejecución coincidente como instalaciones independientes.
Ciclo de vida de Visual Studio 2026
Reglas de segmentación y soporte
La siguiente directiva 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 marco de destino se convierte en la base para los grupos de características de ese SDK, incluyendo la superficie de la API de Roslyn, los objetivos de MSBuild, los generadores de código, los 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 (Sistema de traducción | Versión de Visual Studio el SDK se distribuye con |
Versión mínima de Visual Studio | Max TargetFramework en versión mínima de Visual Studio |
Max TargetFramework en 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:
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.
El destino net8.0 solo se admite oficialmente en la versión 17.8 o versiones posteriores de Visual Studio.
El destino net9.0 solo se admite oficialmente en la versión 17.12 o versiones posteriores de Visual Studio.
La segmentación net10.0 solo se admite oficialmente en Visual Studio 18.0 y versiones posteriores.
Para garantizar herramientas coherentes, debe usar dotnet build en lugar de msbuild para compilar la aplicación siempre que sea posible.
Matriz de compatibilidad de SDK y Visual Studio
Aunque la mayoría de los desarrolladores usan el SDK de .NET incluido con su versión de Visual Studio, algunas configuraciones implican versiones de SDK y Visual Studio no coincidentes. No hay ninguna garantía de que todas las versiones de Visual Studio funcionen con todos los SDK de .NET compatibles. Las configuraciones más comunes se prueban para garantizar un mejor esfuerzo de compatibilidad.
Compatibilidad con versiones anteriores y posteriores
-
Configuración compatible principal: use la versión del SDK agrupada con la instalación de Visual Studio.
- Visual Studio 17.14 y .NET 9.0.3xx
- Visual Studio 18.0 y .NET 10.0.1xx
- Compatibilidad con versiones anteriores: el uso de la banda de características más reciente de la versión anterior del SDK (por ejemplo, 8.0.4xx en Visual Studio 17.14) es compatible con la mejor compatibilidad. El equipo de .NET determina cuándo se deben realizar correcciones de backport en función del riesgo y el impacto del cliente. Aunque los SDK más antiguos de la última banda anterior podrían funcionar, el equipo de .NET no los prueba ni realiza un esfuerzo para garantizar la compatibilidad.
- Compatibilidad hacia adelante: se permite el uso de un SDK más reciente (por ejemplo, el SDK de .NET 10 en Visual Studio 17.14) sin limitaciones, pero no se admite dirigir a entornos de ejecución más recientes en versiones anteriores de Visual Studio y genera una advertencia de compilación.
Instrucciones
Use el SDK que se incluye con la instancia de Visual Studio (o la versión más reciente disponible en CI o Visual Studio Code), ya que esa versión siempre tiene las características más recientes, incluidas las actualizaciones de seguridad.
Compatibilidad con niveles inferiores
El SDK de .NET mantiene la compatibilidad de destino con versiones de .NET fuera de soporte técnico. El SDK 10.0.100 puede crear aplicaciones compatibles con net9.0 y hasta netcoreapp1.0.
Principios rectores
- Compatibilidad existente conservada: la compatibilidad de destino con versiones fuera de soporte técnico permanece en el SDK sin eliminación activa. Los clientes que actualizan su SDK o la versión de Visual Studio no deberían encontrar que sus compilaciones se rompen simplemente por apuntar a una versión anterior de .NET.
- Nuevas características: las nuevas características del SDK no son necesarias para admitir versiones fuera de soporte técnico, a menos que la exclusión de dicha compatibilidad suponga un costo o riesgo considerables.
- Soluciones de fallo: si surgen problemas al dirigir versiones fuera de soporte, se aplica una solución en función del costo de la misma. El objetivo es evitar que los clientes tengan problemas durante la actualización.
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 la versión preliminar más reciente se prueba 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 |
|---|---|
| 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 Insiders |
| 11.0.100 Preview 2 | 18.5.0 Insiders |
Referencia
Col·laboreu amb nosaltres a GitHub
La font d'aquest contingut es pot trobar al GitHub, on també podeu crear i revisar problemes i sol·licituds d'extracció. Per obtenir més informació, consulteu la nostra guia per a col·laboradors.
