使用升级语言版本 Amazon Q Developer Agent for code transformation - Amazon Q 开发者版
步骤 1：先决条件第 2 步：配置您的项目第 3 步：转换您的代码

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用升级语言版本 Amazon Q Developer Agent for code transformation

Amazon Q Developer Agent for code transformation可以将文件的代码语言版本升级到位。你可以在中转换一个模块JetBrains，在中转换一个项目或整个工作区Visual Studio Code。

Amazon Q 首先使用源语言版本构建您的代码，然后验证它是否包含转换代码所需的信息。Amazon Q 成功转换您的代码后，您需要验证并接受集成开发环境 (IDE) 中的更改。有关更多信息，请参阅 Amazon Q Developer Agent for code transformation的工作方式。

目前，Amazon Q 可以将 Java 8 和 Java 11 代码升级为 Java 17 个代码。

主题

步骤 1：先决条件

在继续操作之前，请确保您已完成在 IDE 中设置 Amazon Q 中的步骤。

在开始代码转换作业之前，请确保满足以下先决条件：

  • 您的项目是以 Java 8 或 Java 11 为基础构建的Maven。

  • 您的项目已成功使用您的 IDE Maven 进行构建。 Amazon Q Developer Agent for code transformation支持 Maven 2.8，但我们建议使用 Maven 3.9.5 或更高版本。

  • 您的项目源 JDK 在本地可用，并且是源代码的版本。例如，如果您正在转换 Java 8 代码，则您的本地 JDK 安装应该是 JDK 8。

  • 您的项目将在 55 分钟或更短的时间内完成构建。

  • 您的项目配置正确，并且指定了正确的 JDK 版本。有关更多信息，请参阅 第 2 步：配置您的项目。

  • 您的项目不需要访问私有网络上的资源，包括虚拟私有云 (VPC) 或本地网络。例如，如果您的项目包含连接到网络中数据库的单元测试，则转换将失败。

  • 您的项目不使用在 Java 项目中打包除 Java 以外语言的插件。例如，如果您的项目除了使用 Java 源代码之外还使用 frontend-Maven-plugin 来执行前端 JavaScript 代码，则转换将失败。

  • 您的项目不使用pom.xml文件依赖版本范围。例如，如果您的pom.xml文件包含<version>[1.0.0,)</version>，则转换将失败。有关更多信息，请参阅 Apache Maven Project 文档中的版本范围规范。

  • 您的本地网络允许上传到 Amazon S3 存储桶，Amazon Q 使用这些存储桶来转换您的代码。有关更多信息，请参阅允许访问数据外围中的 Amazon S3 存储桶。

第 2 步：配置您的项目

要配置您的项目，请使用您正在使用的 IDE 的以下信息。

在中配置项目 JetBrains

要在中配置项目JetBrains，请在 “项目结构” 设置中为项目指定 JDK 版本。有关更多信息，请参阅IntelliJ IDEA文档中的更改项目中的 JDK 版本，并按照在Maven项目结构中更改 JDK 版本的说明进行操作。

在中配置项目 VS Code

要在中配置项目VS Code，您的项目必须包含以下内容：

  • 项目根文件夹中的一个pom.xml文件

  • 项目目录中的一个.java文件

如果您的项目包含Maven包装器可执行文件（mvnwfo mvnw.cmd r macOS 或 forWindows），请确保它位于项目的根目录。Amazon Q 将使用包装器，无需进行其他Maven配置。

如果您不使用Maven包装器，请安装Maven。有关更多信息，请参阅Apache Maven文档Apache Maven中的安装。

安装后Maven，将其添加到您的PATH变量中。有关更多信息，请参阅如何将 Maven 添加到我的？PATH您的 Java runtime 变量还应指向 JDK 而不是 JRE。要确认您的配置是否正确，请运行mvn -v。输出应显示您的Maven版本和指向 JDK 路径的runtime变量。

第 3 步：转换您的代码

在转换自己的代码之前，可能需要通过转换示例项目来测试 IDE 的设置是否正确。以下是符合代码转换条件的示例 GitHub 项目：https://github.com/dhasani23/QCT-sample-app。

要测试 IDE 设置，请下载并解压缩示例项目，然后为 IDE 完成以下步骤。如果您能够查看建议的更改和转换摘要，则可以转换自己的代码项目了。如果转换失败，则说明您的 IDE 配置不正确。要解决配置问题，请查看第 2 步：配置您的项目和故障排除。

注意

如果您的项目构建时间超过 55 分钟或项目生成对象大于 1 GB，则转换将失败。有关解决构建时间和构建项目大小的信息，请参阅故障排除。

如果您在转换开始之前离开自己的 IDE，则转换将失败，必须重新启动。

要升级代码项目或模块的语言版本，请在 IDE 中完成以下步骤。

JetBrains

  1. 打开要升级的模块JetBrains。确保您已在 IDE 中成功构建项目。

  2. 选择 Amazon Q 徽标，然后进入/transform打开的 Amazon Q 聊天面板。

  3. 将出现 “转换您的应用程序” 弹出窗口。从下拉菜单中选择要升级的项目，然后选择 “转换”。

  4. Amazon Q 开始了转型。您可以在转换详细信息选项卡上查看进度。

  5. 转换完成后，您可以在更新项目之前验证升级后的代码。要查看新代码，请转到转换详细信息选项卡，然后选择查看差异。在出现的 “应用补丁” 窗口中，选择一个文件以打开包含源代码和升级代码的差异视图。

  6. 要接受 Amazon Q 所做的更改，请选择查看差异以打开 “应用补丁” 窗口。选择所有更新的文件，然后选择 “确定” 以就地更新您的项目。

  7. 要详细了解您的代码是如何升级的，以及建议的后续步骤，请在转换详细信息选项卡上，选择查看转换摘要。

Visual Studio 代码

  1. 打开要升级的项目或工作区VS Code。确保已在 IDE 中成功构建项目。

  2. 选择 Amazon Q 徽标，然后进入/transform打开的 Amazon Q 聊天面板。

  3. 从 IDE 顶部的搜索栏中选择要升级的项目。

  4. 如果 Amazon Q 找不到您的源代码版本，它会提示您选择代码版本。选择编写源代码的版本，然后在弹出窗口中选择 “转换” 以继续。

  5. 如果出现提示，请输入 JDK 的JAVA_HOME路径。有关更多信息，请参阅配置您的VS Code项目。

  6. Amazon Q 开始了转型。您可以在 “转换中心” 选项卡上查看进度。

  7. 转换完成后，将打开 “提议的更改” 选项卡。要在更新项目之前验证升级后的代码，请选择 “下载建议的更改”。选择一个文件以打开包含源代码和升级代码的差异视图。

  8. 要接受 Amazon Q 所做的更改，请前往 “提议的更改” 选项卡并选择 “接受”。

  9. 要详细了解您的代码是如何升级的，以及建议的后续步骤，请在 Transformation Hub 上选择 “视图和更多操作” 省略号按钮，然后选择 “显示转换摘要”。