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

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

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

要转换您的代码，Amazon Q 首先使用源语言版本构建您的代码，并验证它是否包含执行转换所需的信息。Amazon Q 成功转换您的代码后，您需要在 IDE 中验证并接受更改。由于 Amazon Q Developer 只需进行最少的更改即可使升级后的代码与目标 JDK 兼容，因此需要进行额外的转换才能升级项目的库和依赖项。有关 Amazon Q 如何转换您的代码的更多信息，请参阅Amazon Q 开发者如何为 Java 语言升级转换代码。

支持的 Java 升级和 IDEs

Amazon Q 目前支持以下 Java 源代码版本和转换目标版本。将代码转换为相同 Java 版本包括升级源代码版本中的库和其他依赖项。

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

步骤 1：先决条件

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

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

步骤 2：配置您的项目

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

在 JetBrains 中配置项目

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

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

有关更多信息，请参阅 JetBrains 文档中的 Project structure settings 和 Module structure settings。

在 VS Code 中配置项目

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

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

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

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

步骤 3：创建依赖项升级文件（可选）

您可以向 Amazon Q 提供依赖项升级文件，这是一个 YAML 文件，其中列出了项目的依赖项以及转换期间要升级到的版本。通过提供依赖项升级文件，您可以指定 Amazon Q 可能不知道要升级的第三方和第一方依赖项。

第一方依赖关系是指您的组织维护的库、插件和框架，这些库、插件和框架仅在本地或组织的专用网络上可用。当 Amazon Q 在您的本地环境中执行构建时，它可以访问您的第一方依赖项。有关更多信息，请参阅 在本地环境中构建代码。第三方依赖关系是公开可用的依赖关系或开源依赖关系，这些依赖关系不是您的组织所独有的。

您可以在 YAML 文件中指定要升级的第一方依赖项，Amazon Q 会在 JDK 升级期间对其进行升级（例如，Java 8 到 17）。在初始 JDK 升级之后，您可以启动单独的转换（17 到 17 或 21 到 21），以升级第三方依赖关系。

Amazon Q 执行最低限度 JDK 升级后，您可以启动单独的转换以升级所有第三方依赖项。或者，您可以在 YAML 文件中指定第三方依赖项及其版本，以便仅在库升级转换期间升级这些依赖关系。

在转换期间，Amazon Q 将提示您提供依赖项升级文件。如果要提供一个，请先确保已正确配置该文件。YAML 文件中必须填写以下字段：

以下是依赖关系升级 YAML 文件以及 Amazon Q 解析所需的配置的示例：

name: dependency-upgrade
  
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
  
  
dependencyManagement:
  
  dependencies:
  
    - identifier: "com.example:library1"
  
      targetVersion: "2.1.0"
  
      versionProperty: "library1.version"  # Optional
  
      originType: "FIRST_PARTY"   
  
    - identifier: "com.example:library2"
  
      targetVersion: "3.0.0"
  
      originType: "THIRD_PARTY"
  
  plugins:
  
    - identifier: "com.example.plugin"
  
      targetVersion: "1.2.0"
  
      versionProperty: "plugin.version"  # Optional
            
      originType: "THIRD_PARTY"  

第 4 步：转换您的代码

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

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

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

JetBrains

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

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

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

4. Amazon Q 会提示您提供升级依赖文件。如果您已为 YAML 配置了要升级的依赖项和版本，请添加您的文件。Amazon Q 将验证文件以确保其配置正确。如果您遇到错误，请查看中描述的格式和必填字段步骤 3：创建依赖项升级文件（可选）。

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

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

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

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

Visual Studio Code

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

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

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

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

5. 如果出现提示，请输入 JDK 的 JAVA_HOME 路径。有关更多信息，请参阅 Configure your VS Code project。

6. Amazon Q 会提示您提供升级依赖文件。如果您已为 YAML 配置了要升级的依赖项和版本，请添加您的文件。Amazon Q 将验证文件以确保其配置正确。如果您遇到错误，请查看中描述的格式和必填字段步骤 3：创建依赖项升级文件（可选）。

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

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

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

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