升級語言版本 Amazon Q Developer Agent for code transformation - Amazon Q 開發
步驟 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 成在 IDE.

開始程式碼轉換工作之前，請確定符合下列先決條件：

  • 您的項目是建立在其上的 Java 8 或 Java 11 個項目Maven。

  • 您的項目成功地Maven在IDE. Amazon Q Developer Agent for code transformation支持 Maven 2.8，但我們建議使用 Maven 3.9.5 或更高版本。

  • 您的項目源JDK代碼在本地可用，並且是源代碼的版本。例如，如果您要轉換 Java 8 程式碼，則本機JDK安裝應為 JDK 8。

  • 您的項目在 55 分鐘或更短的時間內構建。

  • 您的項目配置正確，並指定了正確的JDK版本。如需詳細資訊，請參閱步驟 2：配置您的項目。

  • 您的專案不需要存取私人網路上的資源，包括虛擬私有雲 (VPC) 或內部部署網路。例如，如果您的專案包含連線到網路中資料庫的單元測試，則轉換將會失敗。

  • 您的專案不會在 Java 專案中使用封裝 Java 以外語言的外掛程式。例如，如果您的專案除了 Java 原始 JavaScript 程式碼之外還使用來執行前端程式碼，則轉換將會失敗。frontend-maven-plugin

  • 您的專案不使用pom.xml檔案相依性版本範圍。例如，如果您的pom.xml文件包含<version>[1.0.0,)</version>，那么轉換將失敗。如需詳細資訊，請參閱 Apache Maven 專案文件中的版本範圍規格。

  • 您的本機網路允許上傳到 Amazon S3 儲存貯體，讓 Amazon Q 用來轉換您的程式碼。如需詳細資訊，請參閱允許在資料周圍內存取 Amazon S3 儲存貯體。

  • 您的最低編譯器版本maven-compiler-plugin為 v13.13.0。

步驟 2：配置您的項目

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

在中配置專案 JetBrains

若要在中配置專案JetBrains，您可能需要指定下列專案結構設定：

  • 專案 SDK — JDK 用來編譯專案的。這必須指定才能構建您的項目。

  • 專案語言層級 — 專案中使用的Java語言。如果專案中使用的Java版本與您的JDK版本不同，則必須指定此選項。

  • 模組語言層級 — 模組中使用的Java語言。如果模組中使用的Java版本與您的專案或JDK版本不同，則必須指定此選項。

如果您使用的是不支援的，您可能需要調整這些設定JDK，但您的專案或模組使用支援的語言版本。例如，如果您要轉換 Java 8 個專案，但您使用的是 JDK 18，則必須將專案語言層級設定為 Java 8。

此外，如果您的專案包含多個使用不同語言版本的模組，則必須為要轉換的模組設定語言層級。

更新專案設定

若要更新專案SDK、專案語言或模組語言設定，請完成以下步驟：

  1. 從您的檔案 JetBrains IDE，然後選擇專案結構。

  2. 「專案結構」視窗即會開啟。在「專案設定」 下選擇「專案」。

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

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

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

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

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

在中配置專案 VS Code

若要在中配置專案VS Code，您的專案必須包含下列項目：

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

  • 專.java案目錄中的檔案

如果您的項目包含包Maven裝器可執行文件（mvnwmvnw.cmd適用於macOS或 forWindows），請確保它位於項目的根目錄。Amazon Q 將使用包裝器，而不需要其他Maven配置。

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

安裝後Maven，將其添加到您的PATH變量中。有關更多信息，請參閱我如何將 Maven 添加到我的PATH？您的 Java runtime 變量也應指向 a JDK 而不是JRE. 若要確認您的組態是否正確，請執行mvn -v。輸出應顯示您的Maven版本和指向JDK. runtime

步驟 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 標誌，然後/transform在打開的 Amazon Q 聊天面板中輸入。

  3. 「轉換您的應用程式」彈出式視窗 從下拉式選單中選擇您要升級的專案，然後選擇 [轉換]。

  4. Amazon Q 開始轉型。您可以在「轉換」詳細資訊標籤上檢視進度。

  5. 轉換完成後，您可以在更新專案之前驗證升級的程式碼。若要檢視新程式碼，請移至 [轉換詳細資料] 索引標籤，然後選擇 [檢視差異]。在出現的 [套用修補程式] 視窗中，選擇一個檔案以開啟含有原始程式碼和升級程式碼的差異檢視。

  6. 若要接受 Amazon Q 所做的變更，請選擇檢視差異以開啟套用修補程式視窗。選擇所有更新的文件，然後選擇「確定」 以就地更新您的項目。

  7. 若要取得程式碼升級方式的詳細資料以及建議的後續步驟，請在 [轉換詳細資料] 索引標籤上選擇 [檢視轉換摘要]

Visual Studio 程式碼

  1. 開啟您要升級的專案或工作區VS Code。請確定您已在中成功建置專案IDE。

  2. 選擇 Amazon Q 標誌，然後/transform在打開的 Amazon Q 聊天面板中輸入。

  3. 從頂端的搜尋列選擇您要升級的專案IDE。

  4. 如果 Amazon Q 找不到原始程式碼的版本，會提示您選擇程式碼版本。選擇編寫源代碼的版本，然後在彈出窗口中選擇「轉換」以繼續。

  5. 如果出現提示，請JAVA_HOME輸入您的JDK. 如需詳細資訊，請參閱設定您的VS Code專案。

  6. Amazon Q 開始轉型。您可以在 [轉換中樞] 索引標籤上檢視進度。

  7. 轉換完成后，系統會打開「提議的變更」標簽。若要在更新專案之前驗證升級的程式碼，請選擇 [下載提議的變更]。選擇一個文件以打開包含源代碼和升級代碼的差異視圖。

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

  9. 若要取得程式碼升級方式和建議後續步驟的詳細資料，請在 [轉換中樞] 上選擇 [檢視和其他動作] 省略符號按鈕，然後選擇 [顯示轉換摘要]。