Atualizando versões linguísticas com o Amazon Q Developer Agent for code transformation - Amazon Q Developer
Etapa 1: pré-requisitosEtapa 2: configurar seu projetoEtapa 3: transformar seu código

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á.

Atualizando versões linguísticas com o Amazon Q Developer Agent for code transformation

Eles Amazon Q Developer Agent for code transformation podem atualizar a versão em linguagem de código dos seus arquivos no local. Você pode transformar um módulo em JetBrains um projeto ou todo o espaço de trabalho emVisual Studio Code.

O Amazon Q primeiro cria seu código na versão do idioma de origem e verifica se tem as informações necessárias para transformar seu código. Depois que o Amazon Q transforma seu código com sucesso, você verifica e aceita as alterações em seu ambiente de desenvolvimento integrado (IDE). Para obter mais informações, consulte Como o Amazon Q Developer Agent for code transformation funciona.

Atualmente, o Amazon Q pode atualizar o código Java 8 e Java 11 para o código Java 17.

Tópicos

Etapa 1: pré-requisitos

Antes de continuar, certifique-se de ter concluído as etapas em Configurar o Amazon Q em seu IDE.

Certifique-se de que os seguintes pré-requisitos sejam atendidos antes de iniciar um trabalho de transformação de código:

  • Seu projeto é um projeto de Java 8 ou Java 11 baseado emMaven.

  • Seu projeto é construído com sucesso com Maven seuIDE. Amazon Q Developer Agent for code transformationsuporta Maven 2.8, mas recomendamos Maven 3.9.5 ou posterior.

  • A fonte do seu projeto JDK está disponível localmente e é a versão do seu código-fonte. Por exemplo, se você estiver transformando o código Java 8, sua JDK instalação local deverá ser JDK 8.

  • Seu projeto é construído em 55 minutos ou menos.

  • Seu projeto está configurado corretamente e a JDK versão correta foi especificada. Para obter mais informações, consulte Etapa 2: configurar seu projeto.

  • Seu projeto não exige acesso a recursos em sua rede privada, incluindo uma nuvem privada virtual (VPC) ou uma rede local. Por exemplo, se seu projeto contiver testes de unidade que se conectam a um banco de dados em sua rede, a transformação falhará.

  • Seu projeto não usa plug-ins que empacotam linguagens diferentes de Java em seu projeto Java. Por exemplo, se seu projeto usar o frontend-maven-pluginpara executar código de front-end além JavaScript do código-fonte Java, a transformação falhará.

  • Seu projeto não usa intervalos de versão de dependência de pom.xml arquivos. Por exemplo, se seu pom.xml arquivo incluir<version>[1.0.0,)</version>, a transformação falhará. Para obter mais informações, consulte Especificação do intervalo de versão na documentação do projeto Apache Maven.

  • Sua rede local permite uploads para buckets do Amazon S3 que o Amazon Q usa para transformar seu código. Para obter mais informações, consulte Permitir acesso aos buckets do Amazon S3 em perímetros de dados.

  • Sua versão mínima do compilador para o maven-compiler-plugin é v13.13.0.

Etapa 2: configurar seu projeto

Para configurar seu projeto, use as informações a seguir para o IDE que você está usando.

Configurar um projeto no JetBrains

Para configurar seu projeto emJetBrains, talvez seja necessário especificar as seguintes configurações da Estrutura do Projeto:

  • Projeto SDK — O JDK usado para compilar seu projeto. Isso deve ser especificado para criar seu projeto.

  • Nível da linguagem do projeto — A Java linguagem usada no seu projeto. Isso deve ser especificado se a Java versão usada em seu projeto for diferente da sua JDK versão.

  • Nível de idioma do módulo — O Java idioma usado em seu módulo. Isso deve ser especificado se a Java versão usada em seus módulos for diferente do seu projeto ou JDK versão.

Talvez seja necessário ajustar essas configurações se estiver usando uma versão não suportadaJDK, mas seu projeto ou módulos usam uma versão de idioma compatível. Por exemplo, se você estiver transformando um projeto Java 8, mas estiver usando JDK 18, deverá definir o nível de linguagem do projeto como Java 8.

Além disso, se seu projeto contiver vários módulos que usam versões de idiomas diferentes, você deve definir o nível de idioma para o módulo que você está transformando.

Atualizar as configurações do projeto

Para atualizar seu projetoSDK, idioma do projeto ou configurações de idioma do módulo, conclua as seguintes etapas:

  1. Em seu JetBrainsIDE, escolha Arquivo e, em seguida, Estrutura do Projeto.

  2. A janela Estrutura do projeto é aberta. Em Configurações do projeto, escolha Projeto.

    1. Para atualizar seuJDK, escolha no menu suspenso ao lado de. SDK

    2. Para atualizar o idioma do seu projeto, escolha no menu suspenso ao lado do nível do idioma.

  3. Em Project Settings, escolha Modules.

    1. Para atualizar o idioma do seu módulo, escolha no menu suspenso ao lado do nível do idioma.

Para obter mais informações, consulte Configurações da estrutura do projeto e Configurações da estrutura do módulo na JetBrains documentação.

Configurar um projeto no VS Code

Para configurar seu projeto emVS Code, seu projeto deve conter o seguinte:

  • Um pom.xml arquivo na pasta raiz do projeto

  • Um .java arquivo no diretório do projeto

Se seu projeto contiver um Maven wrapper executável (mvnwpara macOS ou mvnw.cmd paraWindows), verifique se ele está na raiz do seu projeto. O Amazon Q usará o wrapper e nenhuma outra Maven configuração será necessária.

Se você não estiver usando um Maven wrapper, instaleMaven. Para obter mais informações, consulte Instalação Apache Maven na Apache Maven documentação.

Depois de instalarMaven, adicione-o à sua PATH variável. Para obter mais informações, consulte Como faço para adicionar o Maven ao meu? PATH Sua runtime variável Java também deve estar apontando para a JDK e não para JRE a. Para confirmar se sua configuração está correta, executemvn -v. A saída deve mostrar sua Maven versão e a runtime variável apontando para o caminho para suaJDK.

Etapa 3: transformar seu código

Antes de transformar seu próprio código, talvez você queira testar se ele IDE está configurado corretamente transformando um projeto de amostra. A seguir está um exemplo de GitHub projeto que é elegível para transformação de código: https://github.com/aws-samples/aws-appconfig-java-sample.

Para testar sua IDE configuração, baixe e descompacte o projeto de amostra e conclua as etapas a seguir para seuIDE. Se você conseguir visualizar as alterações propostas e o resumo da transformação, estará pronto para transformar seu próprio projeto de código. Se a transformação falhar, a sua não IDE está configurada corretamente. Para resolver problemas de configuração, revise Etapa 2: configurar seu projeto Solução de problemas e.

nota

Se você se afastar do seu IDE antes do início da transformação, a transformação falhará e você terá que reiniciá-la.

Para atualizar a versão do idioma do seu projeto ou módulo de código, conclua as etapas a seguir para seuIDE.

JetBrains

  1. Abra o módulo no qual você deseja atualizarJetBrains. Certifique-se de ter construído seu projeto com sucesso noIDE.

  2. Escolha o logotipo do Amazon Q e, em seguida, entre /transform no painel de bate-papo do Amazon Q que se abre.

  3. Um pop-up Transforme seu aplicativo é exibido. Escolha o projeto que você deseja atualizar no menu suspenso e escolha Transformar.

  4. O Amazon Q inicia a transformação. Você pode ver o progresso na guia Detalhes da transformação.

  5. Depois que a transformação for concluída, você poderá verificar o código atualizado antes de atualizar seu projeto. Para ver o novo código, vá até a guia Detalhes da transformação e escolha Exibir diferença. Na janela Aplicar patch exibida, escolha um arquivo para abrir uma visualização de diferenças com seu código-fonte e o código atualizado.

  6. Para aceitar as alterações feitas pelo Amazon Q, escolha Exibir diferença para abrir a janela Aplicar patch. Selecione todos os arquivos atualizados e escolha OK para atualizar seu projeto no local.

  7. Para obter detalhes sobre como seu código foi atualizado e sugerir as próximas etapas, na guia Detalhes da transformação, escolha Exibir resumo da transformação.

Código do Visual Studio

  1. Abra o projeto ou espaço de trabalho no qual você deseja atualizar. VS Code Certifique-se de ter construído seu projeto com sucesso noIDE.

  2. Escolha o logotipo do Amazon Q e, em seguida, entre /transform no painel de bate-papo do Amazon Q que se abre.

  3. Escolha o projeto que você deseja atualizar na barra de pesquisa na parte superior doIDE.

  4. Se o Amazon Q não conseguir encontrar a versão do seu código-fonte, ele solicitará que você escolha a versão do seu código. Escolha a versão em que seu código-fonte está escrito e, em seguida, escolha Transformar no pop-up para continuar.

  5. Se solicitado, insira o JAVA_HOME caminho para o seuJDK. Para obter mais informações, consulte Configurar seu VS Code projeto.

  6. O Amazon Q inicia a transformação. Você pode ver o progresso na guia Transformation Hub.

  7. Depois que a transformação for concluída, a guia Alterações propostas será aberta. Para verificar o código atualizado antes de atualizar seu projeto, escolha Baixar as alterações propostas. Escolha um arquivo para abrir uma visualização de diferenças com seu código-fonte e código atualizado.

  8. Para aceitar as alterações feitas pela Amazon Q, acesse a guia Alterações propostas e escolha Aceitar.

  9. Para obter detalhes sobre como seu código foi atualizado e sugerir as próximas etapas, no Transformation Hub, escolha o botão de reticências Views and More Actions e, em seguida, escolha Mostrar resumo da transformação.