Leer en inglés

Compartir a través de


Actualización a una nueva versión de .NET

Las nuevas versiones de .NET se publican cada año. Varios desarrolladores inician el proceso de actualización en cuanto la nueva versión está disponible, mientras que otros esperan hasta que ya no se admita la versión que usan. El proceso de actualización tiene varios aspectos que se deben tener en cuenta.

Motivos comunes para actualizar a una nueva versión de .NET:

  • Ya no se admite la versión de .NET usada actualmente
  • La nueva versión admite un nuevo sistema operativo
  • La nueva versión tiene una característica importante de API, rendimiento o seguridad

Actualización del entorno de desarrollo

Para actualizar a una nueva versión de .NET, el SDK de .NET es el componente principal que se debe instalar. Este incluye una CLI de .NET actualizada, un sistema de compilación y una versión en tiempo de ejecución.

El sitio web de .NET ofrece instaladores y archivos que puede descargar y usar en cualquier sistema operativo y arquitectura compatibles.

Algunos sistemas operativos tienen un administrador de paquetes que también puede usar para instalar una nueva versión de .NET; podría preferir esto.

Visual Studio instala nuevas versiones del SDK de .NET automáticamente. Para los usuarios de Visual Studio, es suficiente actualizar a una versión más reciente de Visual Studio.

Actualización del código fuente

El único cambio necesario para actualizar una aplicación es actualizar la propiedad TargetFramework en un archivo de proyecto a la versión más reciente de .NET.

Siga este procedimiento:

  • Abra el archivo del proyecto (el archivo *.csproj, *.vbproj o *.fsproj).
  • Cambie el valor de propiedad <TargetFramework> de, por ejemplo, net6.0 a net8.0.
  • Si se usa, el mismo patrón se aplica a la propiedad <TargetFrameworks>.

El Asistente para actualización puede realizar estos cambios automáticamente.

El siguiente paso es compilar el proyecto (o la solución) con el nuevo SDK. Si se necesitan cambios adicionales, el SDK proporcionará advertencias y errores que le guiarán.

Es posible que tenga que ejecutar dotnet workload restore para restaurar cargas de trabajo con la nueva versión del SDK.

Más recursos:

Actualización de la integración continua (CI)

Las canalizaciones de CI siguen un proceso de actualización similar a los archivos de proyecto y de tipo Dockerfile. Por lo general, puede actualizar canalizaciones de CI cambiando solo los valores de versión.

Actualización del entorno de hospedaje

Hay muchos patrones que se usan para hospedar aplicaciones. Si el entorno de hospedaje incluye el entorno de ejecución de .NET, debe instalarse la nueva versión del entorno de ejecución de .NET. En Linux, las dependencias deben instalarse, pero no suelen cambiar entre versiones de .NET.

En el caso de los contenedores, se deben cambiar las instrucciones FROM para que incluyan nuevos números de versión.

En el siguiente ejemplo de Dockerfile se muestra cómo extraer una imagen de ASP.NET Core 9.0.

Dockerfile
FROM mcr.microsoft.com/dotnet/aspnet:9.0

En un servicio en la nube como Azure App Service, se necesita un cambio de configuración.