迁移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>的形式，所以须要升级。

升级会弹出一个对话框提示，所有勾选上，直接升级。最后弹出一个升级报告。

.NET Framework移植分析

VS扩展市场查找并运行.NET Portability Analyzer以分析项目。

报告若是分析结果是

这个样子的，那就没问题。特别关注一下.NET CORE，若是不支持，须要想一想别的办法：

1. 替换这个引用/方法
2. 升级对应的包

升级项目文件

最关键的一步来了，须要升级项目文件以便于支持.NET CORE。其实步骤很简单，用vs生成一个基于.NET CORE的WPF项目，而后，直接将csproj文件拷贝到原来的项目文件夹，使用VS添加现有项目，选择这个文件，能够发现原来的东西都自动添加进来了。

不过有的项不会自动处理，咱们还须要手动对照一下原来的csproj文件和新的项目csproj文件。看看是否是缺失了一些什么内容。

PackageReference不会自动处理，引用的其余项目也不会，咱们须要手动粘贴进来。
Resource也不会自动添加，可使用通配符语法<Resource Include="Images\*.png" />
程序的图标须要从新添加。

编译以后出现这个错误。

.NET CORE程序会自动根据项目属性生成这个信息，若是还有AssemblyInfo.cs文件，就会冲突。二选一解决这个问题

• 删除assemblyinfo.cs，不过原来的csproj文件将不可用。
• 在新项目文件中添加<GenerateAssemblyInfo>false</GenerateAssemblyInfo>，禁用自动生成的功能。

修复生成问题

有的项目处理完毕以后还有生成错误，能够考虑引用Microsoft.Windows.Compatibility来解决一些兼容性的问题。

个人项目出现了不少警告，提示项目package不兼容。

若是包持续有人维护的话，通常状况从新安装一下对应的包解决这些问题。

update-package -reinstall

还不行的话，那么有几率你的程序不能正常运行。不想冒险，就须要找找替代了。
好比我手头上的程序，引用了CookComputing.XmlRpcV2这个包，不支持.NET CORE，可是在网上搜索一下，能够发现Kveer.XmlRPC是一个移植，直接换就行了。

继续运行，发现一直提示资源文件错误，WPF的Properties.Resources很差用了...有几种办法能够解决。

1. 删除resx文件，将生成属性设置为resource并使用Uri参考
2. 删除resx文件，将生成属性设置为Embedded Resource并使用集成资源参考
3. 删除resx文件，将生成属性设置为Content并设置老是复制到目标目录，直接读取文件。

总结

最后编译，我这边只有几个警告，没有错误了。鉴于程序能够正常运行，我这有空再优化吧。