C# 利用.NET 升级助手将.NET Framework项目升级为.NET 6
概述
.NET6 正式版本已經(jīng)發(fā)布有一陣子了,今天我就體驗(yàn)一下如何將.NET?Framework的項(xiàng)目升級(jí)為.NET 6.
升級(jí)條件:
Windows 操作系統(tǒng)
.NET 6 SDK
Visual Studio 2022 17.0 或更高版本
環(huán)境準(zhǔn)備
①首先是VS2022下載,直接上微軟官方網(wǎng)站,下載地址:
https://visualstudio.microsoft.com/zh-hans/downloads/
下載后,在線安裝就行,如果之前有vs的其它版本也不用卸載,VS可以多個(gè)版本共存,安裝的時(shí)候.NET 6的運(yùn)行時(shí)默認(rèn)會(huì)勾選安裝,如下圖:
②如果需要單獨(dú)下載SDK和運(yùn)行時(shí),可以上微軟官網(wǎng),地址:
.NET SDKs downloads for Visual Studio (microsoft.com)
③安裝好以后,可以在window命令窗口確認(rèn).NET 6是否安裝正常,可以輸入:
vs安裝完成后,在新建項(xiàng)目時(shí)應(yīng)該已經(jīng)可以看到.NET?6的框架了
.NET Portability Analyzer安裝和使用
? ? ? 升級(jí)前最好先分析下你的項(xiàng)目依賴的類庫是否支持最新的.NET平臺(tái),這里可以利用擴(kuò)展工具.NET Portability Analyzer去完成(僅支持.NET 5以下版本):
擴(kuò)展工具下載安裝完成后,重啟VS。在工程或者解決方案的右鍵菜單中,選擇:Portability Analyzer Settings。在配置頁面,選擇要分析的.net ?版本即可。
設(shè)置完成后,在VS的工程或者解決方案右鍵菜單中,選擇:Analyze Assembly Portability,然后過一會(huì)兒就會(huì)出現(xiàn)結(jié)果。第二個(gè)Sheet頁面詳細(xì)的說明了不支持的API信息。
升級(jí)助手介紹和安裝
? ?我們之前的應(yīng)用在 .NET Framework 上運(yùn)行,現(xiàn)在想將它們移植到 .NET 6。?當(dāng)然你可以選擇手動(dòng)移植,但是更方便的方法是利用微軟提供的升級(jí)助手去完成這個(gè)操作.
首先是升級(jí)助手安裝,方法很簡單,在命令窗口執(zhí)行:
安裝成功后,應(yīng)該如下圖所示:
同樣地,由于 .NET 升級(jí)助手是作為 .NET 工具安裝的,因此運(yùn)行以下命令可以輕松地更新它:
項(xiàng)目升級(jí)
?①分析?:?.NET 升級(jí)助手工具包括一種分析模式,它可以提供有關(guān)在升級(jí)開始之前可能需要進(jìn)行的更改的見解。在命令窗口?運(yùn)行?upgrade-assistant analyze?命令,傳入正在升級(jí)的項(xiàng)目或解決方案的名稱。如下圖:
輸出中有很多內(nèi)部診斷信息,但某些信息非常有用。請注意,分析模式指示升級(jí)將建議項(xiàng)目以?net6.0-windows?目標(biāo)框架名字對象 (net6.0-windows) 為目標(biāo)。這是因?yàn)榻鉀Q方案引用的項(xiàng)目是 WPF 項(xiàng)目,是一種僅限 Windows 的技術(shù)。控制臺(tái)應(yīng)用程序可能會(huì)獲得直接升級(jí)到 TFM net6.0?的建議,除非它使用某些特定于 Windows 的庫。
如果報(bào)告了任何錯(cuò)誤或警告,請?jiān)陂_始升級(jí)前處理這些錯(cuò)誤或警告。
②升級(jí):?運(yùn)行?upgrade-assistant upgrade?命令,傳入正在升級(jí)的項(xiàng)目或解決方案的名稱。
該工具將運(yùn)行并顯示它將執(zhí)行的步驟列表。完成每個(gè)步驟后,該工具將提供一組命令,讓用戶應(yīng)用或跳過下一步或其他選項(xiàng)。按?Enter?而不選擇數(shù)字會(huì)選擇列表中的第一項(xiàng)。杰西萊一頓按鍵enter,完成后如下圖:
詳細(xì)步驟可參考官網(wǎng)文檔--鏈接地址:
https://docs.microsoft.com/zh-cn/dotnet/core/porting/upgrade-assistant-wpf-framework
打開項(xiàng)目
升級(jí)完成后,選擇VS2022打開項(xiàng)目,我舊項(xiàng)目依賴的Caliburn.Micro版本是3.2的不支持.NET 6,它已經(jīng)自動(dòng)升級(jí)到最高版本,解決方法項(xiàng)目數(shù)如如下圖:
變更項(xiàng):
①packages.config被遷移到項(xiàng)目.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:升級(jí)到最新支持.NET6的4.0版本;
③AssemblyInfo.cs:程序集版本按理在.NET6 中應(yīng)該是在項(xiàng)目-》屬性中設(shè)置,如下圖:
但是升級(jí)助手升級(jí)后沒有清理多余的項(xiàng),那我就手動(dòng)刪除下,最后如下圖:
運(yùn)行項(xiàng)目
項(xiàng)目下載
鏈接:https://pan.baidu.com/s/1pCdAdAJ-XVG8onsZ9OCYdQ
提取碼:0000
技術(shù)群:添加小編微信并備注進(jìn)群
小編微信:mm1552923 ??
公眾號(hào):dotNet編程大全? ??
總結(jié)
以上是生活随笔為你收集整理的C# 利用.NET 升级助手将.NET Framework项目升级为.NET 6的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: .NetCore中IdentitySer
- 下一篇: C# 使用TCP创建HTTP客户程序