熟悉C#開發的朋友們都應該知道,使用C#語言編寫的程式在編譯之後生成的文件被稱做為程式集,這其中又分為dll(類庫)和exe(可執行程式)兩種類型,而程式集當中的內容其實就CIL(Common Intermediate Language,公共中間語言)。CIL最初是隨著.NET由微軟一起發佈的,因此 ...
概述
.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 中應該是在項目-》屬性中設置,如下圖:
但是升級助手升級後沒有清理多餘的項,那我就手動刪除下,最後如下圖:
運行項目
項目下載
鏈接:https://pan.baidu.com/s/1pCdAdAJ-XVG8onsZ9OCYdQ
提取碼:0000
技術群:添加小編微信並備註進群
小編微信:mm1552923 公眾號:dotNet編程大全