介紹 由於歷史原因,基於 Windows 平臺存在著大量的基於 .NetFramework 開發的 WPF 和 WinForm 相關程式,如果將這些程式全部基於 DotNetCore 3.0 重寫一遍顯然是不現實的,但是 DotNetCore 是未來發展的趨勢。所以本文通過以 WPF 為例,介紹一下 ...
介紹
由於歷史原因,基於 Windows 平臺存在著大量的基於 .NetFramework 開發的 WPF 和 WinForm 相關程式,如果將這些程式全部基於 DotNetCore 3.0 重寫一遍顯然是不現實的,但是 DotNetCore 是未來發展的趨勢。所以本文通過以 WPF 為例,介紹一下如何將傳統 WPF 遷移到 DotNetCore 3.0 上。
環境
我在之前的一篇文章 DotNetCore 3.0 助力 WPF 開發 有提到過,如果想開發基於 DotNetCore 3.0 的 WPF 程式,我們需要安裝 Visual Studio 2019 和 DotNetCore 3.0 SDK,這兩個條件是必須具備的。同樣的,我們做框架遷移,這兩個條件同樣也是必須的。
註:為了不必要的麻煩,建議使用 Visual Studio 2019 來進行遷移工作。
實驗
首先,我們通過 Visual Studio 2019 創建一個傳統的基於 .NetFramework 的 WPF 程式。如下圖所示:
項目創建完成之後,你會發現還是那個屬性的味道,沒有什麼變化。嘗試編譯運行,也是沒什麼問題。
更新 NuGet
在做遷移之前,我們需要確認一下我們的項目是否引用了 NuGet 上的一些包,如果引用了,請務必更新至最新版本。雖然這不是必須的,但是卻是有必要的,避免在遷移過程中出現一些未知錯誤。
這裡,我引用一下 Newtonsoft.Json 作為示例。在 MainWindow.xaml.cs 中嘗試使用
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
protected override void OnContentRendered(EventArgs e)
{
var user = new User { Name = "hippieZhou", Eamil = "[email protected]" };
var json = Newtonsoft.Json.JsonConvert.SerializeObject(user);
Trace.WriteLine(json);
base.OnContentRendered(e);
}
}
public class User
{
public string Name { get; set; }
public string Eamil { get; set; }
}
編譯運行程式,可以正常編譯運行和執行。控制台也輸出了 User 對象也能正確序列化。
使用 Portability Analyzer
.NET Portability Analyzer 工具是用於檢測我們當前的 WPF 程式中使用的所有 API 是否支持遷移到 DotNetCore 3.0 上。運行該工具後如下圖所示:
點擊 Browser 按鈕,將我們的項目目錄載入進來,之後點擊 Analyze,等分享完成之後,點擊 Open Report 即可查看檢測結果,如下圖所示:
從上圖中,我們可以看到,我們的程式當前的框架為 .NetFramework 4.7.2,當前使用的程式集 在 DotNetCore 3.0 受支持率為 100%,這就表明我們的程式可以無縫遷移到 DotNetCore 上了。
遷移 packages.config
如果我們的程式引用了 NuGet 上的包,那麼 VS 會為我們創建一個 packages.config,這個文件在 DotNetCore 中不受支持,所以我們需要將它修改為受支持的類型。
滑鼠右鍵它,然後點擊 Migrate packages.config to PackageReference 即可,如下圖所示:
遷移 XXX.csproj
這裡,我們修改我們示常式序中的 WpfApp1.csproj,在傳統的 .csproj 中會有一大堆配置,這些配置方式在 DotNetCore 中同樣不適用了。因此,我們需要將我們的內容修改一下,如下所示:
<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
<PropertyGroup>
<OutputType>WinExe</OutputType>
<TargetFramework>netcoreapp3.0</TargetFramework>
<UseWPF>true</UseWPF>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Newtonsoft.Json" Version="12.0.1" />
</ItemGroup>
</Project>
重新載入項目後,會如下圖所示:
接著,我們需要刪除掉項目中的 Properties,操作完畢後嘗試重新編譯運行,如果不出意外的話,應該是可以正常執行的。
最後,我們可以對比一下這種遷移後的項目結構和直接通過 DotNetCore 創建的項目結構之間的差別,如下圖所示:
總結
需要補充的一點是,目前在 VS2019 中創建 DotNetCore 3.0 的 WPF 項目時, XAML 的設計視圖還是不可用的狀態,所以這個需要註意一下。
DotNetCore 是未來發展的趨勢,由於目前還是預覽版,所以我們可以先試著做一些技術儲備,等待正式版出來後,我們就可以很快的遷移過來。
相關參考
- getting-started-net-core-3-create-wpf-application
- how-to-port-desktop-applications-to-net-core-3-0
- are-your-windows-forms-and-wpf-applications-ready-for-net-core-3-0
- Prerequisites for .NET Core on Windows