本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon Q Developer 在命令列上轉換程式碼
<a name="transform-CLI"></a>

您可以使用 Amazon Q Developer 命令列轉換工具，從命令列轉換您的應用程式。若要轉換程式碼，請提供原始程式碼和任何必要組態檔案的路徑，Amazon Q 會進行一系列步驟來產生新的程式碼。在整個轉換過程中，Amazon Q 會在您的本機環境中建置程式碼，以驗證變更。如需詳細資訊，請參閱[在本機環境中建置程式碼](#local-builds)。Amazon Q 會在您的儲存庫中建立新的分支，並在此處遞交程式碼變更。轉換完成後，您可以將分支合併到原始分支中，以將變更合併到程式碼基底中。

若要開始進行，請安裝命令列工具並進行身分驗證，然後查看設定和啟動轉換的命令。

**Topics**
+ [在本機環境中建置程式碼](#local-builds)
+ [命令](#commands)
+ [使用 Amazon Q Developer 在命令列上執行轉換](run-CLI-transformations.md)
+ [對命令列上的轉換進行故障診斷](troubleshooting-CLI-transformations.md)
+ [Amazon Q Developer 命令列轉換工具版本歷史記錄](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>

如需執行這些命令的逐步指示，請參閱 [使用 Amazon Q Developer 在命令列上執行轉換](run-CLI-transformations.md)。

若要設定轉換並向 Amazon Q Developer 專業方案進行身分驗證，請執行：

```
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)。