使用 升級語言版本 Amazon Q Developer Agent for code transformation - Amazon Q Developer
步驟 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 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. 專案結構視窗隨即開啟。在專案設定 下，選擇專案 。

    1. 若要更新您的專案 JDK，請從 旁的下拉式清單中選擇 SDK。

    2. 若要更新您的專案語言，請從語言層級 旁的下拉式清單中選擇 。

  3. 請在 Project Settings (專案詳細資訊) 下選擇 Modules (模組)。

    1. 若要更新模組 JDK，請從 旁的下拉式清單中選擇 SDK。

    2. 若要更新模組語言，請從語言層級 旁的下拉式清單中選擇 。

如需詳細資訊，請參閱中的專案結構設定和模組結構設定 JetBrains 文件中)。

更新 Maven 設定

若要更新您的 Maven Runner JRE，請完成下列步驟：

  1. 從您的 JetBrains IDE，選擇齒輪圖示，然後在出現的選單中選擇設定。

  2. 在設定視窗中，選擇建置、執行、部署 ，然後選擇建置工具 ，然後是 Maven ，然後選擇 Runner 。

  3. 在 JRE欄位中，選擇JDK用於建置您要轉換之模組的 。

在 中設定專案 VS Code

在 中設定專案 VS Code，您的專案必須包含下列項目：

  • 專案根資料夾中pom.xml的檔案

  • 專案目錄中.java的檔案

如果您的專案包含 Maven 包裝程式可執行檔 （mvnw for macOS 或 mvnw.cmd 的 Windows），請確定它位於專案的根目錄。Amazon Q 將使用包裝，沒有其他 Maven 組態是必要的。

如果您不使用 Maven 包裝，安裝 Maven。 如需詳細資訊，請參閱安裝 Apache Maven 在 中 Apache Maven 文件中)。

安裝後 Maven，將其新增至您的PATH變數。如需詳細資訊，請參閱如何將 Maven 新增至我的 PATH？您的 Java runtime變數也應該指向 JDK，而不是指向 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. 轉換完成後，您可以在更新專案之前驗證升級的程式碼。若要檢視新程式碼，請前往轉換詳細資訊索引標籤，然後選擇檢視差異。在出現的套用修補程式視窗中，選擇檔案以使用您的原始程式碼和升級程式碼開啟 diff 檢視。

  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 會開始轉換。您可以在 Transformation Hub 索引標籤上檢視進度。

  7. 轉換完成後，建議變更索引標籤會開啟。若要在更新專案之前驗證升級的程式碼，請選擇下載建議的變更。選擇檔案以使用您的原始程式碼和升級程式碼開啟 diff 檢視。

  8. 若要接受 Amazon Q 所做的變更，請前往建議變更索引標籤，然後選擇接受 。

  9. 若要取得如何升級程式碼並建議後續步驟的詳細資訊，請在轉型中樞 上，選擇檢視和更多動作省略按鈕，然後選擇顯示轉型摘要 。