C# 利用.NET 升級助手將.NET Framework項目升級為.NET 6

本文轉載自查看原文 2022-04-10 14:51 2548 C#/ mvvm/ WPF/ caliburn.Micro/ .NET 6

概述

.NET6 正式版本已經發布有一陣子了，今天我就體驗一下如何將.NET Framework的項目升級為.NET 6.

升級條件：

Windows 操作系統
.NET 6 SDK
Visual Studio 2022 17.0 或更高版本

環境准備

①首先是VS2022下載，直接上微軟官方網站，下載地址：

https://visualstudio.microsoft.com/zh-hans/downloads/

下載后，在線安裝就行，如果之前有vs的其它版本也不用卸載，VS可以多個版本共存，安裝的時候.NET 6的運行時默認會勾選安裝，

②如果需要單獨下載SDK和運行時，可以上微軟官網，地址：

.NET SDKs downloads for Visual Studio (microsoft.com)

③安裝好以后，可以在window命令窗口確認.NET 6是否安裝正常，可以輸入：

vs安裝完成后，在新建項目時應該已經可以看到.NET 6的框架了

.NET Portability Analyzer安裝和使用

升級前最好先分析下你的項目依賴的類庫是否支持最新的.NET平台,這里可以利用擴展工具.NET Portability Analyzer去完成(僅支持.NET 5以下版本)：

擴展工具下載安裝完成后，重啟VS。在工程或者解決方案的右鍵菜單中，選擇：Portability Analyzer Settings。在配置頁面，選擇要分析的.net 版本即可。

設置完成后，在VS的工程或者解決方案右鍵菜單中，選擇：Analyze Assembly Portability，然后過一會兒就會出現結果。第二個Sheet頁面詳細的說明了不支持的API信息。

升級助手介紹和安裝

我們之前的應用在 .NET Framework 上運行，現在想將它們移植到 .NET 6。當然你可以選擇手動移植，但是更方便的方法是利用微軟提供的升級助手去完成這個操作.

首先是升級助手安裝，方法很簡單，在命令窗口執行：

dotnet tool install -g upgrade-assistant

安裝成功后，應該如下圖所示：

同樣地，由於 .NET 升級助手是作為 .NET 工具安裝的，因此運行以下命令可以輕松地更新它：

dotnet tool update -g upgrade-assistant

項目升級

①分析： .NET 升級助手工具包括一種分析模式，它可以提供有關在升級開始之前可能需要進行的更改的見解。在命令窗口運行 upgrade-assistant analyze 命令，傳入正在升級的項目或解決方案的名稱。如下圖：

輸出中有很多內部診斷信息，但某些信息非常有用。請注意，分析模式指示升級將建議項目以 net6.0-windows 目標框架名字對象 (net6.0-windows) 為目標。這是因為解決方案引用的項目是 WPF 項目，是一種僅限 Windows 的技術。控制台應用程序可能會獲得直接升級到 TFM net6.0 的建議，除非它使用某些特定於 Windows 的庫。

如果報告了任何錯誤或警告，請在開始升級前處理這些錯誤或警告。

②升級：運行 upgrade-assistant upgrade 命令，傳入正在升級的項目或解決方案的名稱。

該工具將運行並顯示它將執行的步驟列表。完成每個步驟后，該工具將提供一組命令，讓用戶應用或跳過下一步或其他選項。按 Enter 而不選擇數字會選擇列表中的第一項。

詳細步驟可參考官網文檔--鏈接地址：

https://docs.microsoft.com/zh-cn/dotnet/core/porting/upgrade-assistant-wpf-framework

打開項目

升級完成后，選擇VS2022打開項目，我舊項目依賴的Caliburn.Micro版本是3.2的不支持.NET 6，它已經自動升級到最高版本

變更項：

①packages.config被遷移到項目.csproj文件；如下圖

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0-windows</TargetFramework>
    <OutputType>WinExe</OutputType>
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <UseWPF>true</UseWPF>
    <ImportWindowsDesktopTargets>true</ImportWindowsDesktopTargets>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.CSharp" Version="4.7.0" />
    <PackageReference Include="System.Data.DataSetExtensions" Version="4.5.0" />
    <PackageReference Include="Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers" Version="0.3.310801">
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
    <PackageReference Include="Caliburn.Micro" Version="4.0.173" />
  </ItemGroup>
</Project>

②Caliburn.Micro：升級到最新支持.NET6的4.0版本；

③AssemblyInfo.cs：程序集版本按理在.NET6 中應該是在項目-》屬性中設置，如下圖：