在 GitHub 中使用 Amazon Q Developer 轉換程式碼 - Amazon Q Developer

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

在 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 轉換程式碼基底之前,請考慮下列需求:

符合先決條件後,即可套用 Amazon Q 轉換代理程式標籤,並將 GitHub 儲存庫中的程式碼基底升級。

重要

Amazon Q Developer 應用程式會嘗試在您授權存取的 GitHub 儲存庫中,自動建立 Amazon Q 開發代理程式Amazon Q 轉換代理程式標籤。如果未自動建立標籤,或意外刪除標籤,您可以在 GitHub 中手動建立標籤。標籤必須命名為 Amazon Q 開發代理程式Amazon Q 轉換代理程式,才能將其辨識為 Amazon Q Developer 標籤並進行處理。如需詳細資訊,請參閱文件 GitHub 文件中的建立標籤

若要升級程式碼基底
  1. 如有需要,使用您的 GitHub 憑證登入 GitHub 帳戶。

  2. 瀏覽至您的 GitHub 組織,然後瀏覽至您要轉換程式碼基底的儲存庫。

  3. 選擇問題,然後建立新問題。如需詳細資訊,請參閱 GitHub 文件中的建立問題

  4. 新增標題文字輸入欄位中,輸入標題以提供內容讓 Amazon Q Developer 進行程式碼轉換 (範例:「升級程式碼基底」)。另外還要包含問題說明,其同樣可提供內容。

  5. 建立問題或設定現有問題時,您可以套用程式碼轉換 Amazon Q Developer 標籤或使用 /q transform 斜線命令。執行以下任意一項:

    • 若要將標籤套用至問題,請執行下列其中一項操作:

      • 選擇作為瀏覽器延伸模組提供的指派至 Amazon Q 下拉式功能表,然後選擇 Amazon Q 轉換代理程式標籤。

      • 在右側功能表中,選擇標籤,然後選擇 Amazon Q 轉換代理程式標籤。

    • 若要在註解中使用 /q transform 斜線命令:

      1. 在問題內,瀏覽至新增註解,然後在註解文字輸入欄位中輸入 /q transform

      2. 選擇 Comment (評論)

  6. 選擇建立問題來完成建立問題並包含必要的詳細資訊,以供 Amazon Q Developer 轉換程式碼。

    當 Amazon Q Developer 完成產生用於功能開發的程式碼變更時,它將會在問題上加註,並開啟提取請求。

  7. 瀏覽至 Amazon Q Developer 留下的註解 (範例:"I finished upgrading your code and opened a pull request: Resolve Upgrade codebase."),然後選擇提取請求連結。

    您也可以瀏覽至提取請求索引標籤,然後選擇 Amazon Q Developer 所建立的提取請求。

  8. 選擇檔案已變更索引標籤,以檢視變更。

  9. 如果您對建議的程式碼變更感到滿意,就可以合併提取請求。如需詳細資訊,請參閱合併提取請求

Amazon Q Developer 會留下註解以提供轉換摘要,其中包含所更新檔案的詳細資訊。您可以在註解中提供的 build_logs.txt 檔案內找到摘要。如果 Amazon Q Developer 無法執行完整的程式碼轉換,仍會提供有關導致無法完整轉換之錯誤的摘要。