在 Visual Studio 中使用 Amazon Q Developer 移植 .NET 應用程式 - Amazon Q Developer
步驟 1：事前準備步驟 2：轉換應用程式

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

在 Visual Studio 中使用 Amazon Q Developer 移植 .NET 應用程式

完成這些步驟，以在 Visual Studio 中使用 Amazon Q Developer 將 Windows 型 .NET 應用程式，移植到與 Linux 相容的跨平台 .NET 應用程式。

步驟 1：事前準備

繼續進行之前，請確定您已完成在 IDE 中設定 Amazon Q 中的步驟。

在您開始 .NET 轉換任務之前，務必確定您的應用程式符合以下先決條件：

  • 您的應用程式僅包含以 C# 撰寫的 .NET 專案。

  • 您的應用程式只有 Microsoft 編寫的 NuGet 套件相依性

  • 您的應用程式僅使用 UTF-8 字元。如果您的應用程式使用非 UTF-8 字元，Amazon Q 仍會嘗試轉換您的程式碼。

  • 如果您的應用程式相依於 Internet Information Services (IIS)，則只會使用預設 IIS 組態

  • Amazon Q 將評估您選取的專案類型及其相依性，以建立程式碼群組。您的程式碼群組只會包含下列專案類型：

    • 主控台應用程式

    • 類別庫

    • Web API

    • WCF 服務

    • Model View Controller (MVC) 和 Single Page Application (SPA) 的商業邏輯層

    • 測試專案

注意

Amazon Q 不支援轉換 UI 層元件，例如 Razor 檢視或 WebForms ASPX 檔案。如果 Amazon Q 在解決方案或專案中偵測到 UI 層元件，則會藉由排除 UI 層元件的方式執行部分轉換，而且您可能需要進一步重構，才能在目標 .NET 版本上建置程式碼。

步驟 2：轉換應用程式

若要轉換 .NET 解決方案或專案，請完成下列程序：

  1. 在 Visual Studio 中開啟您要轉換的任何 C# 型解決方案或專案。

  2. 在編輯器中開啟任何 C# 檔案。

  3. 選擇解決方案總管。

  4. 在解決方案總管中，用滑鼠右鍵按一下您要轉換的解決方案或專案，然後選擇使用 Amazon Q Developer 移植。

  5. 使用 Amazon Q Developer 移植視窗隨即出現。

    選擇要轉換的解決方案或專案下拉式功能表中已選擇您選取的解決方案或專案。您可以展開功能表，以選擇不同的解決方案或專案來進行轉換。

    在選擇 .NET 目標下拉式功能表中，選擇您要升級的目標 .NET 版本。

  6. 選擇確認以開始轉換。

  7. Amazon Q 會開始轉換您的程式碼。您可以檢視其產生的轉換計畫，以了解其如何轉換您的應用程式的詳細資訊。

    此時 Transformation Hub 會開啟，您可以在此監控轉換期間的進度。Amazon Q 完成等待任務轉換啟動步驟後，您可以在轉換期間瀏覽至專案或解決方案以外的位置。

  8. 轉換完成後，瀏覽至 Transformation Hub，然後選擇檢視差異，以在差異檢視中檢閱 Amazon Q 提議的變更。

  9. 選擇檢視程式碼轉換摘要，以取得 Amazon Q 所做變更的詳細資訊。您也可以選擇將摘要下載為 .md，以下載轉換摘要。

    如果在 Linux 移植狀態下，程式碼群組表中的任何項目需要輸入，您必須手動更新一些檔案，才能在 Linux 上執行應用程式。

    1. 從動作下拉式功能表中，選擇下載 Linux 整備報告。

    2. 此時會開啟一個 .csv 檔案，其中包含您必須完成的任何專案或解決方案變更，如此您的應用程式才會與 Linux 相容。檔案中包含需要更新的專案和檔案、要更新的項目描述，以及問題的說明。使用建議欄，以獲得如何解決 Linux 整備問題的想法。

  10. 若要就地更新您的檔案，請從動作下拉式功能表選擇接受變更。