本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 GitHub 中使用 Amazon Q Developer 轉換程式碼
注意
Amazon Q Developer for GitHub 為預覽版本,並可能有所變更。
您可利用程式碼轉換功能更新技術堆疊、增強效能並確保未來相容性,同時保留現有程式碼的核心功能。使用 Amazon Q Developer 可讓您避免技術負債,且您可建置應用程式以實現長期永續性和可擴展性。
當您將程式碼轉換標籤新增至問題或使用 /q
transform 斜線命令時,Amazon Q Developer 會將您的程式碼從 Java 8 或 11 版轉換成 17 版。然後 Amazon Q Developer 會建立提取請求,其中包含可供您合併至主線的變更和變更摘要。
您可以讓 Amazon Q Developer 每月執行有限次數的程式碼轉換。您可以隨時向 AWS 帳戶註冊 Amazon Q Developer 應用程式安裝,以增加您的免費用量。如需詳細資訊,請參閱在 Amazon Q Developer 主控台中提高用量限制和設定詳細資訊。
先決條件
使用 Amazon Q Developer 轉換程式碼基底之前,請考慮下列需求:
-
確定您的 GitHub 儲存庫已啟用 GitHub Actions。如需詳細資訊,請參閱 GitHub 文件中的了解 GitHub Actions
和啟用工作流程 。 -
在
.github/workflows/目錄中建立和設定您的工作流程檔案,以處理程式碼轉換任務。如需詳細資訊,請參閱自訂程式碼轉換的工作流程。
符合先決條件後,即可套用 Amazon Q 轉換代理程式標籤,並將 GitHub 儲存庫中的程式碼基底升級。
重要
Amazon Q Developer 應用程式會嘗試在您授權存取的 GitHub 儲存庫中,自動建立 Amazon Q 開發代理程式和 Amazon Q 轉換代理程式標籤。如果未自動建立標籤,或意外刪除標籤,您可以在 GitHub 中手動建立標籤。標籤必須命名為 Amazon Q 開發代理程式和 Amazon Q 轉換代理程式,才能將其辨識為 Amazon Q Developer 標籤並進行處理。如需詳細資訊,請參閱文件 GitHub 文件中的建立標籤
若要升級程式碼基底
-
如有需要,使用您的 GitHub 憑證登入 GitHub
帳戶。 -
瀏覽至您的 GitHub 組織,然後瀏覽至您要轉換程式碼基底的儲存庫。
-
選擇問題,然後建立新問題。如需詳細資訊,請參閱 GitHub 文件中的建立問題
。 -
在新增標題文字輸入欄位中,輸入標題以提供內容讓 Amazon Q Developer 進行程式碼轉換 (範例:「升級程式碼基底」)。另外還要包含問題說明,其同樣可提供內容。
-
建立問題或設定現有問題時,您可以套用程式碼轉換 Amazon Q Developer 標籤或使用
/q transform斜線命令。執行以下任意一項:-
若要將標籤套用至問題,請執行下列其中一項操作:
-
選擇作為瀏覽器延伸模組提供的指派至 Amazon Q 下拉式功能表,然後選擇 Amazon Q 轉換代理程式標籤。
-
在右側功能表中,選擇標籤,然後選擇 Amazon Q 轉換代理程式標籤。
-
-
若要在註解中使用
/q transform斜線命令:-
在問題內,瀏覽至新增註解,然後在註解文字輸入欄位中輸入
/q transform。 -
選擇 Comment (評論)。
-
-
-
選擇建立問題來完成建立問題並包含必要的詳細資訊,以供 Amazon Q Developer 轉換程式碼。
當 Amazon Q Developer 完成產生用於功能開發的程式碼變更時,它將會在問題上加註,並開啟提取請求。
-
瀏覽至 Amazon Q Developer 留下的註解 (範例:"
I finished upgrading your code and opened a pull request: Resolve Upgrade codebase."),然後選擇提取請求連結。您也可以瀏覽至提取請求索引標籤,然後選擇 Amazon Q Developer 所建立的提取請求。
-
選擇檔案已變更索引標籤,以檢視變更。
-
如果您對建議的程式碼變更感到滿意,就可以合併提取請求。如需詳細資訊,請參閱合併提取請求
。
Amazon Q Developer 會留下註解以提供轉換摘要,其中包含所更新檔案的詳細資訊。您可以在註解中提供的 build_logs.txt 檔案內找到摘要。如果 Amazon Q Developer 無法執行完整的程式碼轉換,仍會提供有關導致無法完整轉換之錯誤的摘要。