Compartir a través de

Actualización a .NET.NET Aspire 9

En este artículo, aprenderá los pasos necesarios para actualizar los 8 proyectos existentes .NET Aspire a .NET Aspire 9. Hay varias maneras de actualizar los proyectos a .NET.NET Aspire 9:

  • Actualice manualmente los proyectos a .NET.NET Aspire 9.0.
  • Usa el Asistente para actualizaciones para actualizar tus proyectos a .NET.NET Aspire 9.0.

Propina

Si no está familiarizado con .NET.NET Aspire, no hay ninguna razón para actualizar nada. Para obtener más información, consulte .NET.NET Aspire configuración y herramientas.

Prerrequisitos

Antes de actualizar los proyectos a .NET.NET Aspire 9.0, asegúrese de que tiene los siguientes requisitos previos:

Actualización del entorno de desarrollo

Para poder usar .NET.NET Aspire 9, debe quitar componentes obsoletos y actualizar las herramientas.

.NET.NET Aspire carga de trabajo

Anteriormente, se requería la carga de trabajo aspire para crear y ejecutar .NET.NET Aspire proyectos. Sin embargo, con .NET Aspire 9 la carga de trabajo ya no es necesaria y debe quitarse de su .NET entorno.

Importante

Debe quitar .NET.NET Aspire 8 (la carga de trabajo aspire) para habilitar las .NET.NET Aspire 9 plantillas.

  1. Busque el origen de instalación abriendo un terminal y ejecutando el dotnet workload list comando .

    El comando anterior enumera las cargas de trabajo instaladas en el .NET entorno. El método que se usa para instalar .NET.NET Aspire aparece en la columna Origen de instalación de la salida y es VS para Visual Studio o SDK para el .NET SDK. Por ejemplo, el fragmento de código siguiente indica que Visual Studio se usó para instalar .NET Aspire:

    Installed Workload Id      Manifest Version      Installation Source
--------------------------------------------------------------------
aspire                     8.2.2/8.0.100         VS 17.14.36109.1

  2. Eliminar .NET.NET Aspire 8.

    • Si el origen de instalación comienza con VS:

      1. Abra la aplicación Visual Studio Instalador.
      2. Modifique la instancia de instalación de Visual Studio.
      3. Seleccionar Componentes individuales.
      4. Busque aspire.
      5. Deseleccionar .NET.NET Aspire SDK.
      6. Seleccione el botón Modificar para aplicar los cambios.

    • Si el origen de instalación comienza con el SDK, ejecute dotnet workload uninstall aspire para quitar .NET.NET Aspire.

  3. Instale las .NET.NET Aspire plantillas 9.0 con el dotnet new install Aspire.ProjectTemplates comando .

Actualizar manualmente a .NET.NET Aspire 9.0

Para actualizar los proyectos a .NET.NET Aspire 9.0, debe actualizar los archivos del proyecto. Los pasos siguientes le guían a través del proceso:

  • Edite el archivo de proyecto host de la aplicación de para usar el nuevo SDK de 9.0 ().
  • Actualice los paquetes NuGet de los archivos del proyecto a las versiones más recientes.
  • Ajuste el archivo de Program.cs para usar las nuevas API y quite las API obsoletas.

Edite el archivo de proyecto del host de la aplicación

Para actualizar el proyecto host de la aplicación a .NET.NET Aspire 9.0, debe actualizar el archivo de proyecto para usar el nuevo 📦Aspire. AppHost.Sdk:

<Project Sdk="Microsoft.NET.Sdk">

+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
  </ItemGroup>

</Project>

De manera opcional, actualice el identificador del marco de destino (TFM)

.NET Aspire 9.0 se ejecuta en .NET 9.0, pero también puede ejecutarlo en .NET 8.0. En otras palabras, solo porque usa el SDK de .NET Aspire y apunta a los paquetes de la versión 9.0, todavía puede tener como destino .NET 8.0. Si desea ejecutar el proyecto de .NET Aspire 9.0 en .NET 9.0, debe actualizar la propiedad TargetFramework en el archivo de proyecto:

<Project Sdk="Microsoft.NET.Sdk">

  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
-   <TargetFramework>net8.0</TargetFramework>
+   <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
  </ItemGroup>

</Project>

Para obtener más información sobre los TFM, consulte Plataformas de destino en proyectos de estilo SDK: Versiones más recientes.

Diferencias generales en el proyecto de host de aplicaciones

Si ha seguido todos los pasos anteriores, el archivo de proyecto host de la aplicación debe tener este aspecto:

<Project Sdk="Microsoft.NET.Sdk">

+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
-   <TargetFramework>net8.0</TargetFramework>
+   <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
-   <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+   <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
  </ItemGroup>

</Project>

Los cambios incluyen la adición del Aspire.AppHost.Sdk, la actualización de la propiedad TargetFramework a net9.0y la actualización del paquete de Aspire.Hosting.AppHost a la versión 9.0.0.

Ajuste el archivo Program.cs

Con la introducción de .NET.NET Aspire 9.0, hay algunos cambios disruptivos . Algunas API se marcaron originalmente como experimentales (con la ExperimentalAttribute) y ahora se quitan, mientras que otras API ahora se atribuyen como ObsoleteAttribute con detalles sobre las nuevas API de reemplazo. Debe ajustar el archivo de Program.cs (y potencialmente otras API afectadas) para usar las nuevas API. Si usa el Asistente para actualización para actualizar los proyectos, ajusta automáticamente el archivo Program.cs en la mayoría de los casos.

Para obtener la lista completa de cambios importantes en .NET.NET Aspire 9.0, consulte Cambios importantes en .NET.NET Aspire 9.0.

Usar el Asistente para actualización

El Asistente de actualización es una herramienta que ayuda a actualizar los proyectos específicos a la versión más reciente. Si eres nuevo en el Asistente de actualización, puedes elegir entre dos modalidades.

  • Visual Studiode la extensión .
  • .NETde la herramienta global de la CLI .

Independientemente de cómo instale el Asistente para actualización, puede usarlo para actualizar los proyectos de .NET Aspire 8.x a .NET Aspire 9.0.

Para actualizar el proyecto host de aplicación de .NET Aspire a .NET Aspire 9.0 con Visual Studio, haga clic con el botón derecho en el proyecto en Explorador de Soluciones y seleccione Actualizar.

Importante

Si el Asistente para mejoras de aún no está instalado, se le pedirá que lo instale.

El Asistente para actualización muestra un paquete de bienvenida. Seleccione la opción de actualizaciones Aspire:

Visual Studio: página principal del Asistente para actualización con .NET Aspire proyecto host de la aplicación.

Con la opción de actualizaciones Aspire seleccionada, el Asistente de actualización muestra los componentes de destino de la actualización seleccionables. Deje activadas todas las opciones y seleccione Selección de actualización:

Visual Studio: Asistente para actualización .NET Aspire componentes seleccionables para actualizar.

Por último, después de seleccionar los componentes que desea actualizar, el Asistente para actualización muestra los resultados del proceso de actualización. Si todo se realizó correctamente, verá marcas de verificación verdes junto a cada componente:

Visual Studio: El proyecto host de la aplicación del Asistente de Actualización .NET Aspire se actualizó correctamente.

Para actualizar el proyecto host de la aplicación .NET.NET Aspire, asegúrese de instalar la CLI del Asistente para actualización. Abra una sesión de terminal en el directorio raíz del archivo de proyecto host de aplicación .NET.NET Aspire y ejecute el siguiente comando:

upgrade-assistant upgrade

La salida es interactiva y espera que seleccione el tipo de actualización. Elija la opción de actualizaciones Aspire:

 Selected options
────────────────────────────────────────────────────────────────────────────────────
 Source project     ..\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj

 Steps
────────────────────────────────
 Source project / Upgrade type
────────────────────────────────

How do you want to upgrade project AspireSample.AppHost?

> Aspire upgrades
    Upgrade to latest .NET Aspire version (aspire.latest)

  Upgrade project to a newer .NET version
    In-place project upgrade (framework.inplace)

  NuGet upgrades
    NuGet central package management (CPM) (nuget.cpm)

  Navigation
    Back
    Exit

Use el teclado para navegar hacia arriba , o hacia abajo y seleccione la opción Aspire actualizaciones. El Asistente para actualización solicita confirmación final. Escriba Y para continuar con la actualización:

 Selected options
────────────────────────────────────────────────────────────────────────────────────
 Source project     ..\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj
 Upgrade type       aspire.latest

 Steps
──────────────────────────────────────────
 Source project / Upgrade type / Upgrade
──────────────────────────────────────────

We have gathered all required options and are ready to do the upgrade. Do you want to continue? [y/n] (y):

Por último, una vez completado el proceso de actualización, el Asistente para actualización muestra los resultados del proceso de actualización:

Finalizing operation...
Complete: 3 succeeded, 0 failed, 7 skipped.

Actualización de los paquetes NuGet

Para aprovechar las actualizaciones más recientes de la solución de .NET.NET Aspire, actualice todos los paquetes NuGet a la versión 9.0.0.

Visual Studio: actualice todos los paquetes NuGet para la solución .NET Aspire.

Para actualizar el proyecto host de la aplicación, use el siguiente comando de la CLI de .NET para actualizar el paquete de Aspire.Hosting.AppHost a la versión 9.0.0:

dotnet add package Aspire.Hosting.AppHost --version 9.0.0

Cuando ya existe una referencia de paquete, el comando dotnet add package actualiza la referencia a la versión especificada. Para más detalles, consulte dotnet add package.

Con el proyecto host de la aplicación actualizado, el archivo del proyecto debe tener este aspecto:

<Project Sdk="Microsoft.NET.Sdk">

  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
-   <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+   <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
  </ItemGroup>

</Project>

Propina

También querrá actualizar los paquetes NuGet de los otros proyectos a las versiones más recientes.

Comprobación de la actualización

Al igual que con cualquier actualización, asegúrese de que la aplicación se ejecuta según lo previsto y que todas las pruebas superan. Compile la solución y busque sugerencias, advertencias o errores en la ventana de salida: solucione todo lo que no fuera un problema antes. Si tiene algún problema, háganoslo saber presentando un informe de GitHub problema.