作者 | Scott Hanselman
译者 | 弯月
早在2001年,我用C#为学校的一门300系列的操作系统课程编写了一个微型虚拟操作系统,后来在2002年将其移植到了VB.NET。这些都是在.NET Core出现之前的代码,基于Windows早期的.NET 1.1或2.0。
五年前,我将代码转移到了GitHub上,同时将项目移植到了.NET Core 2.0。当时这个项目已经有15年历史了,所以这个项目能在Windows、Linux、Docker上运行,甚至能在树莓派等项目创立时尚未存在的机器上运行。
在本文中,我想尝试一下能否利用.NET升级助手,将这个已有20年历史的项目搬到.NET 6上运行。
下面,我们开始:
$ upgrade-assistant upgrade .\TinyOS.sln
-----------------------------------------------------------------------------------------------------------------
Microsoft .NET Upgrade Assistant v0.3.256001+3c4e05c787f588e940fe73bfa78d7eedfe0190bdWe are interested in your feedback! Please use thefollowing link to open a survey: https://aka.ms/DotNetUASurvey
-----------------------------------------------------------------------------------------------------------------[22:58:01 INF] Loaded 5 extensions
[22:58:02 INF] Using MSBuild from C:\ProgramFiles\dotnet\sdk\6.0.100\
[22:58:02 INF] Using Visual Studio install from C:\ProgramFiles\Microsoft Visual Studio\2022\Preview [v17]
[22:58:06 INF] Initializing upgrade step Select anentrypoint
[22:58:07 INF] Setting entrypoint to only project insolution: C:\Users\scott\TinyOS\src\TinyOSCore\TinyOSCore.csproj
[22:58:07 INF] Recommending executable TFM net6.0 becausethe project builds to an executable
[22:58:07 INF] Initializing upgrade step Select project toupgrade
[22:58:07 INF] Recommending executable TFM net6.0 becausethe project builds to an executable
[22:58:07 INF] Recommending executable TFM net6.0 becausethe project builds to an executable
[22:58:07 INF] Initializing upgrade step Back up project
升级过程是交互式的命令行,使用了有颜色的提示信息,还有一系列带有动态选项的问题:
有意思的是,升级之后构建一次成功,没有任何错误。
手工检查.csproj文件时,我发现了一些奇怪的数字,很像是来自多年前的.NET Core 2。我的直觉告诉我这里有问题,而升级助手并没有理解。
<!-- <PackageReference Include="ILLink.Tasks" Version="0.1.4-preview-906439" /> -->
<PackageReference Include="Microsoft.Extensions.Configuration" Version="2.0.0-preview2-final" />
<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="2.0.0-preview2-final" />
<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="2.0.0-preview2-final" />
<PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="2.0.0-preview2-final" />
我还注意到一个被注释掉的指向ILLink.Tasks的引用,这是当年Mono的连接器的一个预览功能,目的是压缩应用程序的最终大小,并裁剪掉无用的代码。这项功能已经内置到.NET 6中,后面会用到。所以这里不需要这个引用了。
我决定先不管三七二十一直接升级到.NET 6看看会怎样。我只需要改一个数字,看看能否恢复并构建,但也可以尝试一下dotnetoutdated工具,这个工具非常好用:
这个“outdated”工具妙就妙在它会调用NuGet来查看某个包是否有新版本。
在测试中(此时只不过是一些批处理文件),我采用如下方式调用dotnet:
dotnet netcoreapp2.0/TinyOSCore.dll 512 scott13.txt
之后会改成现代形式,只有TinyOSCore.exe 512 scott13.txt,只需要exe文件和参数,不需要额外的东西。
经过发布和裁剪后,我的操作系统变成了一个仅有15MB的exe文件。考虑到.NET已存在,不需要额外安装,这个结果已经很优秀了。如果我愿意,甚至可以将这个操作系统变成一个微服务:
dotnet publish -r win-x64 --self-contained -p:PublishSingleFile=true-p:SuppressTrimAnalysisWarnings=true
如果加上:
-p:EnableCompressionInSingleFile=true
还能进一步缩小。不需要修改任何代码。测试也都通过了。当年为学校编写的 .NET 1.1 现在都移植到了 .NET 6.0上,而且还能跨平台,自带运行时,而且只包含一个仅有11MB的EXE文件。
参考链接:
https://www.hanselman.com/blog/upgrading-a-20-year-old-university-project-to-net-6-with-dotnetupgradeassistant