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

# 通过 Amazon Q 开发者版在命令行中转换代码
<a name="transform-CLI"></a>

您可以使用 Amazon Q 开发者版命令行转换工具，从命令行对应用程序进行代码转换。要转换代码，您只需提供源代码路径及所有必要的配置文件，Amazon Q 会通过一系列步骤生成新代码。在整个转换过程中，Amazon Q 会在您的本地环境中构建代码，以验证变更的有效性。有关更多信息，请参阅 [在本地环境中构建代码](#local-builds)。Amazon Q 会在您的存储库中创建一个新分支，并将代码更改提交到该分支。转换完成后，您可将该分支合并到原始分支，从而将变更整合到代码库中。

要开始使用，需先安装命令行工具并完成身份验证，然后参考相关命令配置并启动转换作业。

**Topics**
+ [在本地环境中构建代码](#local-builds)
+ [命令](#commands)
+ [通过 Amazon Q 开发者版在命令行中运行转换作业](run-CLI-transformations.md)
+ [在命令行中排查转换问题](troubleshooting-CLI-transformations.md)
+ [Amazon Q 开发者版命令行转换工具版本历史记录](transform-CLI-versions.md)

## 在本地环境中构建代码
<a name="local-builds"></a>

代码转换过程中，Amazon Q 会在您的本地环境中执行验证构建。Amazon Q 在服务端通过多步操作对代码进行转换。每完成一步转换，Amazon Q 会将代码发送到您的本地环境，对已做的变更进行构建和测试。测试完成后，代码会被送回服务端，继续下一步转换。

在本地环境中执行构建操作能让 Amazon Q 运行需要访问私有资源的测试，从而帮助验证转换后的代码。为降低在本地环境中构建 AI 生成代码的安全风险，Amazon Q 会审查并更新其生成的代码，以解决潜在的安全问题。

**注意**  
Amazon Q 会根据您项目的请求、描述及内容执行转换。为确保安全，请避免在项目存储库中包含外部未经验证的构件，且务必对转换后的代码进行功能和安全性双重验证。

## 命令
<a name="commands"></a>

有关运行这些命令的 step-by-step说明，请参见[通过 Amazon Q 开发者版在命令行中运行转换作业](run-CLI-transformations.md)。

要配置转换并验证 Amazon Q 开发者版专业套餐身份，请运行以下命令：

```
qct configure
```

要启动 Java 升级转换，请运行以下命令。对于*<your-source-java-version>*，您可以输入`JAVA_1.8``JAVA_8`、`JAVA_11`、`JAVA_17`、或`JAVA_21`。对于*<your-target-java-version>*，您可以输入`JAVA_17`或`JAVA_21`。`--source_version` 和 `--target_version` 均为可选参数。`--trust` 用于启用转换功能，同时对代码进行验证以保障安全性。

```
qct transform --source_folder <path-to-folder>
    --source_version <your-source-java-version>        
    --target_version <your-target-java-version>
    --trust
```

要启用 SQL 转换，请运行以下命令：

```
qct transform --source_folder <path-to-folder>
    --sql_conversion_config_file <path-to-sql-config-file>
```

要查看当前使用的命令行转换工具版本，请运行以下命令：

```
qct -v
```

要获取转换相关帮助信息，请运行以下命令：

```
qct -h
```

要查看转换作业历史记录，请运行以下命令：

```
qct history
```

有关查看和管理转换作业历史记录的更多信息，请参阅[在命令行中查看作业历史记录](transformation-job-history.md#cli-job-history)。