使用升级语言版本 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：先决条件

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

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

  • 你的项目是 Java 8 或 Java 11 个项目在此基础上构建 Maven.

  • 使用以下方法成功构建您的项目 Maven 在你的IDE.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 源 JavaScript 代码之外还使用执行前端代码，则转换将失败。frontend-maven-plugin

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

  • 您的编译器的最低版本maven-compiler-plugin是 v13.13.0。

第 2 步：配置您的项目

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

在中配置项目 JetBrains

要在中配置您的项目 JetBrains，则可能需要指定以下项目结构设置：

  • 项目 SDK-JDK 用于编译您的项目。必须指定此项才能生成项目。

  • 项目语言级别 — Java 项目中使用的语言。如果 Java 您的项目中使用的版本与您的JDK版本不同。

  • 模块语言级别 — Java 您的模块中使用的语言。如果 Java 您的模块中使用的版本与您的项目或JDK版本不同。

如果您使用的是不受支持的语言，但您的项目或模块使用的是支持的语言版本JDK，则可能需要调整这些设置。例如，如果你正在变换 Java 8 个项目，但你使用的是 JDK 18 个，你必须将项目语言级别设置为 Java 8.

此外，如果您的项目包含多个使用不同语言版本的模块，则必须为要转换的模块设置语言级别。

更新项目设置

要更新您的项目SDK、项目语言或模块语言设置，请完成以下步骤：

  1. 来自你的 JetBrains IDE，选择 “文件”，然后选择 “项目结构”。

  2. “项目结构” 窗口打开。在 “项目设置” 下，选择 “项目”。

    1. 要更新您的JDK，请从旁边的下拉列表中进行选择SDK。

    2. 要更新项目语言，请从 “语言级别” 旁边的下拉列表中进行选择。

  3. 在 Project Settings 下，选择 Modules。

    1. 要更新您的模块语言，请从 “语言级别” 旁边的下拉列表中进行选择。

有关更多信息，请参阅中的项目结构设置和模块结构设置 JetBrains 文档中）。

在中配置项目 VS Code

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

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

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

如果您的项目包含 Maven 包装器可执行文件（适用于 mvnw macOS 或者mvnw.cmd对于 Windows），请确保它位于项目的根目录。Amazon Q 将使用包装纸，不使用其他包装 Maven 配置是必要的。

如果你没有使用 Maven 包装器，安装 Maven。 有关更多信息，请参阅安装 Apache Maven在 Apache Maven 文档中）。

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

第 3 步：转换您的代码

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

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

注意

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

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

JetBrains

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

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

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

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

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

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

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

Visual Studio Code

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

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

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

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

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

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

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

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

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