概述

.NET6 正式版本已經(jīng)發(fā)布有一陣子了，今天我就體驗(yàn)一下如何將.NETFramework的項(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)可以看到.NET6的框架了

.NET Portability Analyzer安裝和使用

升級(jí)前最好先分析下你的項(xiàng)目依賴的類庫(kù)是否支持最新的.NET平臺(tái),這里可以利用擴(kuò)展工具.NET Portability Analyzer去完成(僅支持.NET 5以下版本)：

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

設(shè)置完成后，在VS的工程或者解決方案右鍵菜單中，選擇：Analyze Assembly Portability，然后過(guò)一會(huì)兒就會(huì)出現(xiàn)結(jié)果。第二個(gè)Sheet頁(yè)面詳細(xì)的說(shuō)明了不支持的API信息。

升級(jí)助手介紹和安裝

我們之前的應(yīng)用在 .NET Framework 上運(yùn)行，現(xiàn)在想將它們移植到 .NET 6。當(dāng)然你可以選擇手動(dòng)移植，但是更方便的方法是利用微軟提供的升級(jí)助手去完成這個(gè)操作.

首先是升級(jí)助手安裝，方法很簡(jiǎn)單，在命令窗口執(zhí)行：

dotnet tool install -g upgrade-assistant

安裝成功后，應(yīng)該如下圖所示：

同樣地，由于 .NET 升級(jí)助手是作為 .NET 工具安裝的，因此運(yùn)行以下命令可以輕松地更新它：

dotnet tool update -g upgrade-assistant

項(xiàng)目升級(jí)

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

輸出中有很多內(nèi)部診斷信息，但某些信息非常有用。請(qǐng)注意，分析模式指示升級(jí)將建議項(xiàng)目以net6.0-windows目標(biāo)框架名字對(duì)象 (net6.0-windows) 為目標(biāo)。這是因?yàn)榻鉀Q方案引用的項(xiàng)目是 WPF 項(xiàng)目，是一種僅限 Windows 的技術(shù)?？刂婆_(tái)應(yīng)用程序可能會(huì)獲得直接升級(jí)到 TFMnet6.0的建議，除非它使用某些特定于 Windows 的庫(kù)。

如果報(bào)告了任何錯(cuò)誤或警告，請(qǐng)?jiān)陂_始升級(jí)前處理這些錯(cuò)誤或警告。

②升級(jí)：運(yùn)行upgrade-assistant upgrade命令，傳入正在升級(jí)的項(xiàng)目或解決方案的名稱。

該工具將運(yùn)行并顯示它將執(zhí)行的步驟列表。完成每個(gè)步驟后，該工具將提供一組命令，讓用戶應(yīng)用或跳過(guò)下一步或其他選項(xiàng)。按Enter而不選擇數(shù)字會(huì)選擇列表中的第一項(xiàng)。

詳細(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)：

①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í)后沒(méi)有清理多余的項(xiàng)，那我就手動(dòng)刪除下，最后如下圖：

運(yùn)行項(xiàng)目

到此這篇關(guān)于使用.NET升級(jí)助手將.NET Framework項(xiàng)目升級(jí)為.NET 6的文章就介紹到這了。希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論