使用 Amazon Q 开发人员升级 Java 版本 - Amazon Q 开发者版
支持的 Java 升级和 IDEs步骤 1：先决条件步骤 2：配置您的项目步骤 3：转换您的代码

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

使用 Amazon Q 开发人员升级 Java 版本

Amazon Q 开发者可以在集成开发环境中将您的 Java 应用程序升级到较新的语言版本（IDE）。Amazon Q 在升级您的代码时可以进行的更改包括更新已弃用的代码组件，APIs以及升级代码中的库、框架和其他依赖项。

要转换您的代码，Amazon Q 首先使用源语言版本构建您的代码，并验证它是否包含执行转换所需的信息。在 Amazon Q 成功转换您的代码后，您验证并接受您的IDE更改。有关 Amazon Q 如何转换您的代码的更多信息，请参阅Amazon Q 开发者如何为 Java 语言升级转换代码。

主题

支持的 Java 升级和 IDEs

Amazon Q 目前支持以下 Java 升级：

  • 升级 Java 8 和 Java 11 个代码到 Java 17 个代码

  • 升级 Java 17 个包含最新库和其他依赖项的代码

Amazon Q 支持以下方面的 Java 升级IDEs：

  • 中的模块 JetBrains IDEs

  • 中的项目和工作空间 Visual Studio Code

步骤 1：先决条件

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

在开始代码转换任务之前，确保您满足以下先决条件：

  • 您的项目是用支持的语言编写的 Java 版本并在此基础上构建 Maven.

  • 您的项目成功使用以下方法构建 Maven 在你的IDE.Maven 目前支持 3.8 或更高版本。

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

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

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

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

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

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

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

步骤 2：配置您的项目

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

在中配置项目 JetBrains

要在中配置您的项目 JetBrains，您可能需要指定以下项目和模块设置。

如果您的模块使用JDK与项目相同的语言级别，则无需更新模块设置。

  • 项目 SDK-JDK 用于编译您的项目。

  • 项目语言级别 — Java 您的项目中使用的版本。

  • 模块 SDK — JDK 用于编译您的模块。

  • 模块语言级别 — Java 您的模块中使用的版本。

  • Maven Runner JRE — JDK 你用它来构建你的模块。

更新项目和模块设置

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

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

  2. 此时会打开“Project Structure”窗口。在 Project Settings 下，选择 Project。

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

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

  3. 在 Project Settings 下，选择 Modules。

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

    2. 要更新模块语言，请从 Language level 旁边的下拉列表中进行选择。

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

更新 Maven 设置

要更新你的 Maven RunnerJRE，请完成以下步骤：

  1. 来自你的 JetBrains IDE，选择齿轮图标，然后在出现的菜单中选择 “设置”。

  2. 在 Settings 窗口中，依次选择 Build, Execution, Deployment、Build Tools、Maven 以及 Runner。

  3. 在该JRE字段中，选择JDK用于构建要转换的模块。

在中配置项目 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 徽标，然后在打开的 Amazon Q 聊天面板中输入 /transform。

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

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

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

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

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

Visual Studio Code

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

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

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

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

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

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

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

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

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