View a markdown version of this page

解決套件相依性以準備轉換 - AWS 轉換
上傳遺失的套件資料夾結構需求版本比對需求

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

解決套件相依性以準備轉換

在 之後確認您的儲存庫以準備進行轉換，如果 AWS Transform 發現缺少套件相依性，您必須完成此步驟。您可以執行 Windows PowerShell 指令碼，從與Visual Studio開發環境相同的裝置取得缺少的套件相依性，也可以手動擷取缺少的套件。然後，上傳遺失的套件。

有兩種方式可以更新缺少套件相依性：

  • 使用成品連接器解決：透過專用 Connect 成品儲存庫 HITL 工作流程設定成品儲存庫 (ADO NuGet Connector) 來解決此問題，此工作流程會在未設定成品連接器且套件遺失時顯示。

  • 更新遺失套件： AWS Transform 會在遺失套件相依性資料表中列出遺失的套件。您可以在搜尋方塊中依名稱搜尋遺失的套件。此資料表包含下列遺失套件的詳細資訊：

    • 名稱

    • 關聯的儲存庫

    • 架構版本狀態

    • 核心版本狀態

若要解決缺少的套件相依性，請上傳遺失的套件。

上傳遺失的套件

  1. 如果您選擇，您可以下載 Windows PowerShell 協助程式指令碼，從Visual Studio開發環境中擷取缺少的套件相依性。或者，您可以手動找到遺失的套件。

    若要使用 Windows PowerShell 指令碼：

    1. 選取下載 Windows PowerShell 指令碼。

    2. 在本機以作用中連線執行指令碼，連線至包含遺失套件相依性檔案的儲存庫。

    3. 此指令碼可讓您將缺少的套件相依性下載到本機環境。

  2. 指令碼會建立單一 zip 檔案供您上傳，其中包含一個封存中的所有相依性。您也可以為每個相依性上傳個別.nupkg或 zip 檔案。

  3. 選取上傳套件檔案。

  4. 在上傳相依性檔案模態中，選取選擇檔案，然後瀏覽至裝置上的壓縮遺失套件檔案位置。

  5. 選取上傳。

  6. AWS 轉換會驗證您上傳的檔案。在驗證期間，您無法進行任何更新。 AWS Transform 會在缺少套件相依性資料表上方報告驗證狀態。

  7. AWS 轉換也會更新遺失套件相依性資料表中的狀態欄，從遺失更新為已解決。如果套件驗證失敗，其狀態會變成無效。對於無效檔案，請執行下列動作：

    1. 在遺失套件相依性表格中，使用核取方塊選取無效的套件。

    2. 選取移除上傳的檔案。

    3. 這會將其狀態變更回缺少。

  8. 在您上傳遺失的套件並解決套件相依性之後，請選取繼續檢閱。

    如果您選取繼續檢閱而不解決缺少的套件相依性， AWS Transform 會詢問您是否要在沒有缺少套件的情況下啟動轉換任務。如果您選取忽略缺少的套件相依性， AWS Transform 將使用組件參考來轉換程式碼。繼續此動作可能會影響相關資源。

資料夾結構需求

對於 NuGet 上傳， AWS 轉換需要以下其中一項：

  • 要放置在根層級.nuspec的檔案，用於手動上傳的套件，或

  • 使用提供的 PowerShell 指令碼來產生正確的結構

版本比對需求

  • Framework status： AWS Transform 會嘗試將 .csproj 檔案 （原始程式碼） 中指定的相依性版本與上傳的相依性版本進行比對。完全相符會導致成功狀態。

  • 核心狀態： AWS Transform 預期上傳.nuspec檔案之相依性區段的核心版本規格。如果找到一個，則核心狀態為成功。

    範例格式：

    <dependencies>
    <group targetFramework="net8.0" />
</dependencies>

    常見版本包括：

    • .NET 5.0 (net5.0)

    • .NET 6.0 (net6.0)

    • .NET 7.0 (net7.0)

    • .NET 8.0 (net8.0)