本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
升級語言版本 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、專案語言或模組語言設定,請完成以下步驟:
-
從您的檔案 JetBrains IDE,然後選擇專案結構。
-
「專案結構」視窗即會開啟。在「專案設定」 下選擇「專案」。
-
若要更新您的JDK,請從旁邊的下拉式選單中選擇SDK。
-
若要更新您的專案語言,請從 [語言層級] 旁的下拉式選單中選擇。
-
-
請在 Project Settings (專案詳細資訊) 下選擇 Modules (模組)。
-
若要更新您的模組語言,請從 [語言層級] 旁的下拉式選單中選擇。
-
如需詳細資訊,請參閱JetBrains文件中的專案
在中配置專案 VS Code
若要在中配置專案VS Code,您的專案必須包含下列項目:
-
專
pom.xml
案根資料夾中的檔案 -
專
.java
案目錄中的檔案
如果您的項目包含包Maven裝器可執行文件(mvnw
mvnw.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.