如何编译dotnet/runtime源代码

前言

最近,准备为 dotnet/runtime 修改 issue,但是在 clone 代码后,发现要编译成功,远没有想象中那么容易。

因此,将整个过程进行记录,以供大家参考。.

以下操作都是在 Windows 10 下完成。

0.环境准备

详见官方文档:《在Windows上构建dotnet/runtime的要求》(https://github.com/dotnet/runtime/blob/main/docs/workflow/requirements/windows-requirements.md)

我的机器只是提前装了 Visual Studio 2022。

大家可以自行按需安装。

1.初次尝试

在命令行窗口进入代码所在目录,输入如下命令开始编译代码:

build.cmd

等待少许,就碰到了第一个错误:

如何编译dotnet/runtime源代码

按照错误提示,找到文件python.targets的对应位置:

如何编译dotnet/runtime源代码

原来是需要安装 python3。

2.再次尝试

安装 python3 后,再次编译。

不久,又显示了另一个错误:

如何编译dotnet/runtime源代码

按照错误提示,找到文件acquire-wix.proj的对应位置:

如何编译dotnet/runtime源代码

可以看到,这是一个下载文件任务。但是下载地址是个参数,看不到具体的值,这就有点抓瞎了!

在 dotnet/runtime 的 issue 中找到了一个解决方案:

如何编译dotnet/runtime源代码

看发帖的用户名,应该也是个中国人!囧

3.生成日志

运行命令:

build.cmd -bl

再次出错时,可以看到记录了日志:

如何编译dotnet/runtime源代码

使用“MSBuild Structured Log Viewer”(软件具体使用方法参看《天呐!你知道MSBuild都干了些什么》)打开日志文件,可以看到详细下载地址如下:

如何编译dotnet/runtime源代码

4.编译成功

再就好办了。

下载文件,复制到日志中提示的位置解压,问题解决。

后面又发现几个下载错误,依照同样方式处理。

最后,终于提示编译成功:

如何编译dotnet/runtime源代码

最后提示的几个是 Nuget 打包的错误,对编译无影响,因此没有处理。

5.再次编译

但是,当我们运行 dotnet/runtime 自带的任意一个测试用例时,却提示找不到指定 dll:

如何编译dotnet/runtime源代码

我们发现,对应的dll已经编译了,但是默认编译的是net7.0-Debug版本,而现在查找的是net462-Debug

使用build.cmd -h可以看到,可以指定编译框架版本:

如何编译dotnet/runtime源代码

那就再编译一次吧:

build.cmd -bl -f net48

编译完成后,再次运行测试成功:

如何编译dotnet/runtime源代码

结论

这次编译碰到的主要问题,是由于访问国外的网速太慢造成的。