Portar uma aplicação .NET com o Amazon Q Developer no Visual Studio - Amazon Q Developer
Etapa 1: pré-requisitosEtapa 2: transformar sua aplicação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Portar uma aplicação .NET com o Amazon Q Developer no Visual Studio

Conclua estas etapas para portar uma aplicação .NET baseada em Windows para uma aplicação .NET multiplataforma compatível com Linux com o Amazon Q Developer no Visual Studio.

Etapa 1: pré-requisitos

Antes de continuar, certifique-se de que você concluiu as etapas em Configurar o Amazon Q no IDE.

Verifique se os seguintes pré-requisitos para sua aplicação foram atendidos antes de iniciar um trabalho de transformação .NET:

  • Sua aplicação contém somente projetos .NET escritos em C#.

  • Seu aplicativo só tem dependências de pacotes de autoria da Microsoft NuGet

  • Sua aplicação usa somente caracteres UTF-8. Se sua aplicação usar caracteres não UTF-8, o Amazon Q ainda tentará transformar seu código.

  • Se sua aplicação depender do Internet Information Services (IIS), somente as configurações padrão do IIS serão usadas.

  • O Amazon Q avaliará o tipo do projeto que você selecionou e suas dependências para criar um grupo de códigos. O grupo de códigos só pode ter os seguintes tipos de projeto:

    • Aplicação de console

    • Biblioteca de classes

    • API Web

    • Serviço WCF

    • Camadas de lógica de negócios do controlador de visualização de modelo (MVC) e da aplicação de página única (SPA)

    • Projetos de teste

nota

O Amazon Q não oferece suporte à transformação de componentes da camada de interface do usuário, como Razor visualizações ou arquivos WebForms ASPX. Se o Amazon Q detectar componentes da camada de interface do usuário em sua solução ou projeto, ele realizará uma transformação parcial, excluindo-os, e talvez você precise refatorar ainda mais para tornar seu código compilável na versão .NET de destino.

Etapa 2: transformar sua aplicação

Para transformar sua solução ou projeto .NET, realize o seguinte procedimento:

  1. Abra uma solução ou projeto baseado em C# no Visual Studio que você deseja transformar.

  2. Abra qualquer arquivo de código C# no editor.

  3. Selecione o Gerenciador de Soluções.

  4. No Gerenciador de Soluções, clique com o botão direito do mouse em uma solução ou projeto que deseja transformar e, em seguida, selecione Portar com o Amazon Q Developer.

  5. A janela Portar com o Amazon Q Developer é exibida.

    A solução ou projeto que você selecionou será escolhido no menu suspenso Escolher uma solução ou projeto para transformar. Você pode expandir o menu para selecionar uma solução ou projeto diferente para transformar.

    No menu suspenso Escolher um destino .NET, selecione a versão do .NET para a qual você deseja atualizar.

  6. Clique em Confirmar para começar a transformação.

  7. O Amazon Q começa a transformar o código. Você pode visualizar o plano de transformação gerado para obter detalhes sobre como ele transformará sua aplicação.

    Um Hub de transformação é aberto, onde você pode monitorar o progresso durante a transformação. Depois que o Amazon Q concluir a etapa de inicialização da transformação de trabalhos em espera, você poderá sair do projeto ou da solução durante a transformação.

  8. Depois que a transformação for concluída, navegue até o Hub de transformação e selecione Exibir diferenças para revisar as alterações propostas do Amazon Q em uma visualização de diferenças.

  9. Selecione Exibir resumo da transformação do código para obter detalhes sobre as alterações feitas pelo Amazon Q. Você também pode baixar o resumo da transformação selecionando Baixar resumo como .md.

    Se algum dos itens na tabela Grupos de códigos exigir entrada no status de portabilidade do Linux, você deverá atualizar manualmente alguns arquivos para executar sua aplicação no Linux.

    1. No menu suspenso Ações, selecione Baixar relatório de disponibilidade do Linux.

    2. Um arquivo .csv é aberto com todas as alterações em seu projeto ou solução que você deve concluir antes que sua aplicação seja compatível com Linux. Ele inclui o projeto e o arquivo que precisam ser atualizados, uma descrição do item a ser atualizado e uma explicação do problema. Use a coluna Recomendação para obter ideias sobre como resolver um problema de disponibilidade do Linux.

  10. Para atualizar seus arquivos no local, selecione Aceitar alterações no menu suspenso Ações.