遷移WPF項目到.NET CORE

綜述

.NET CORE 3.0開始,桌面端支援WPF了。很多.NET FRAMEWORK的項目已經跑了一陣子了,不是很有必要支援.NET CORE,不過最近用一個程式,為了貫徹一些C# 8的特性,需要升級項目到.NET CORE 3.1。

方法

參考官方指導,需要這麼幾步:

  1. 了解並更新 NuGet 依賴項:
    • 升級NuGet以使用格式。
    • 查看.NET Core或.NET Standard的頂級NuGet依賴項兼容性。
    • 將NuGet包升級到較新版本。
    • 使用.NET Portability Analyzer分析依賴項。
  2. 將項目文件遷移到新的SDK樣式格式:
    • 選擇是同時生成.NET Core和 .NET Framework,還是僅支援.NET Core。
    • 將相關的項目文件屬性和項複製到新項目。
  3. 修復生成問題:
    • 添加對Microsoft.Windows.Compatibility兼容性包的引用。
    • 查找並修復API-level差異。
    • 刪除app.config中appSettings和connectionStrings以外的部分。
    • 如有必要,重新生成自動生成的程式碼。
  4. 運行時測試:
    • 確認移植的應用按預期工作。
    • 注意NotSupportedException異常。

升級nuget引用

原來的nuget使用packages.config進行管理,.netcore已經全面使用<PackageReference>的形式,因此需要升級。

升級nuget

升級會彈出一個對話框提示,全部勾選上,直接升級。最後彈出一個升級報告。

.NET Framework移植分析

VS擴展市場查找並運行.NET Portability Analyzer以分析項目。
img

報告如果分析結果是
img
這個樣子的,那就沒問題。特別關注一下.NET CORE,如果不支援,需要想想別的辦法:

  1. 替換這個引用/方法
  2. 升級對應的包

升級項目文件

最關鍵的一步來了,需要升級項目文件以便於支援.NET CORE。其實步驟很簡單,用vs生成一個基於.NET CORE的WPF項目,然後,直接將csproj文件拷貝到原來的項目文件夾,使用VS添加現有項目,選擇這個文件,可以發現原來的東西都自動添加進來了。

不過有的項不會自動處理,我們還需要手動對照一下原來的csproj文件和新的項目csproj文件。看看是不是缺失了一些什麼內容。

PackageReference不會自動處理,引用的其他項目也不會,我們需要手動粘貼進來。
Resource也不會自動添加,可以使用通配符語法<Resource Include="Images\*.png" />

編譯之後出現這個錯誤。
img
.NET CORE程式會自動根據項目屬性生成這個資訊,如果還有AssemblyInfo.cs文件,就會衝突。二選一解決這個問題

  • 刪除assemblyinfo.cs,不過原來的csproj文件將不可用。
  • 在新項目文件中添加<GenerateAssemblyInfo>false</GenerateAssemblyInfo>,禁用自動生成的功能。

修復生成問題

有的項目處理完畢之後還有生成錯誤,可以考慮引用Microsoft.Windows.Compatibility來解決一些兼容性的問題。

我的項目出現了很多警告,提示項目package不兼容。
img
如果包持續有人維護的話,一般情況重新安裝一下對應的包解決這些問題。

update-package -reinstall

還不行的話,那麼有概率你的程式不能正常運行。不想冒險,就需要找找替代了。
比如我手頭上的程式,引用了CookComputing.XmlRpcV2這個包,不支援.NET CORE,但是在網上搜索一下,可以發現Kveer.XmlRPC是一個移植,直接換就好了。

繼續運行,發現一直提示資源文件錯誤,WPF的Properties.Resources不好用了…有幾種辦法可以解決。

  1. 刪除resx文件,將生成屬性設置為resource並使用Uri參考
  2. 刪除resx文件,將生成屬性設置為Embedded Resource並使用集成資源參考
  3. 刪除resx文件,將生成屬性設置為Content並設置總是複製到目標目錄,直接讀取文件。

總結

最後編譯,我這邊只有幾個警告,沒有錯誤了。鑒於程式可以正常運行,我這有空再優化吧。