Portabilidad de una aplicación .NET con Amazon Q Developer en Visual Studio - Amazon Q Developer
Paso 1: requisitos previosPaso 2: transformación de su aplicación

Portabilidad de una aplicación .NET con Amazon Q Developer en Visual Studio

Realice estos pasos para portar una aplicación .NET basada en Windows a una aplicación .NET multiplataforma compatible con Linux con Amazon Q Developer en Visual Studio.

Paso 1: requisitos previos

Antes de continuar, asegúrese de que ha completado los pasos en Configurar Amazon Q en su IDE.

Asegúrese de que se cumplen los siguientes requisitos previos antes de comenzar un trabajo de transformación de .NET:

  • La aplicación solo contiene proyectos .NET escritos en C#.

  • La aplicación solo tiene dependencias de paquetes NuGet creadas por Microsoft

  • La aplicación solo usa caracteres UTF-8. Si la aplicación utiliza caracteres distintos de UTF-8, Amazon Q seguirá intentando transformar el código.

  • Si la aplicación depende de Internet Information Services (IIS), solo se utilizan las configuraciones de IIS predeterminadas

  • Amazon Q evaluará el tipo de proyecto que ha seleccionado y sus dependencias para crear un grupo de códigos. El grupo de códigos solo puede tener los siguientes tipos de proyectos:

    • Aplicación de consolas

    • Biblioteca de clases

    • API web

    • Servicio WCF

    • Capas de lógica empresarial de Model View Controller (MVC) y de aplicación de página única (SPA)

    • Proyectos de prueba

nota

Amazon Q no es compatible con la transformación de componentes de la capa de interfaz de usuario, como vistas de Razor o archivos ASPX de WebForms. Si Amazon Q detecta componentes de la capa de interfaz de usuario en su solución o proyecto, realizará una transformación parcial excluyendo los componentes de la capa de interfaz de usuario y es posible que tenga que refactorizar aún más para que el código se pueda compilar en la versión .NET de destino.

Paso 2: transformación de su aplicación

Para transformar su proyecto o su solución .NET, realice el procedimiento que se muestra a continuación:

  1. Abra cualquier solución o proyecto basado en C# en Visual Studio que desee transformar.

  2. Abra cualquier archivo de código C# en el editor.

  3. Elija el Explorador de soluciones.

  4. En el Explorador de soluciones, haga clic con el botón secundario en la solución o el proyecto que desee transformar y, a continuación, seleccione Portar con Amazon Q Developer.

  5. Aparece la ventana Portar con Amazon Q Developer.

    La solución o el proyecto que haya seleccionado se elegirá en el menú desplegable Elegir una solución o un proyecto para transformar. Puede ampliar el menú para elegir una solución o proyecto diferente para transformarlo.

    En el menú desplegable Elegir un destino de .NET, elija la versión de .NET a la que desee actualizar.

  6. Seleccione Confirmar para iniciar la transformación.

  7. Amazon Q comienza a transformar el código. Puede ver el plan de transformación que genera para obtener detalles sobre cómo transformará su aplicación.

    Se abre un Centro de transformación en el que puede supervisar el progreso durante la transformación. Una vez que Amazon Q haya completado el paso Esperando inicio de transformación de trabajo, podrá salir del proyecto o de la solución mientras dure la transformación.

  8. Una vez completada la transformación, vaya al Centro de transformación y elija Ver diferencias para revisar los cambios propuestos desde Amazon Q en una vista de diferencias.

  9. Seleccione Ver resumen de la transformación de código para obtener detalles sobre los cambios realizados por Amazon Q. También puede descargar el resumen de la transformación seleccionando Descargar resumen como .md.

    Si alguno de los elementos de la tabla de Grupos de códigos requiere introducirse en el estado de portabilidad de Linux, debe actualizar manualmente algunos archivos para ejecutar la aplicación en Linux.

    1. En el menú desplegable Acciones, seleccione Descargar el informe de preparación para Linux.

    2. Se abrirá un archivo .csv con cualquier cambio en el proyecto o la solución que deba realizar antes de que la aplicación sea compatible con Linux. Incluye el proyecto y el archivo que deben actualizarse, una descripción del elemento que se debe actualizar y una explicación del problema. Utilice la columna de Recomendación para obtener ideas sobre cómo abordar un problema de preparación para Linux.

  10. Para actualizar los archivos en su sitio, seleccione Aceptar cambios en el menú desplegable Acciones.