前沿拓展：

導(dǎo)語

從去年微軟就將 WPF 開源了，差不多現(xiàn)在所有 WPF 的源代碼都開源了。在學(xué)習(xí)框架的時候，我會做一些改動，期望能構(gòu)建一個自己的版本進行測試。但是作為一個特別大的框架，想要構(gòu)建跑起來可不是直接在 VisualStudio 里面點擊一下運行就完成了，需要做很多的準(zhǔn)備才可以。本文將一步步教你如何構(gòu)建 WPF 框架源代碼

我不敢說每個版本的 WPF 框架的源代碼我都能構(gòu)建，在官方倉庫 https://github.com/dotnet/wpf 我構(gòu)建成功的版本是這個 commit 小伙伴可以嘗試使用本文的方法，先切的這個 commit 按照我的方法來進行構(gòu)建，成功了之后再做更新版本的嘗試

閱讀本文能讓你了解如何構(gòu)建WPF框架 https://github.com/dotnet/wpf源代碼，但是不確保你一定能構(gòu)建成功

構(gòu)建 WPF 的步驟如下：

下載構(gòu)建需要的依賴庫還原 NuGet 包按照順序構(gòu)建 C++ 和 C# 代碼，創(chuàng)建 NuGet 包

這里面對于咱國內(nèi)的小伙伴，最坑的問題就是下載構(gòu)建需要的庫，需要的庫如下

dotnet-sdk-5.0.100-preview.1.20155.7-win-x64.zip 安裝dotnet-runtime-5.0.0-preview.4.20220.15-win-x86.zip 安裝strawberry-perl-5.28.1.1-1-win64-x64.zip 放到 .netcoreengnativetemp 文件夾net-framework-48-ref-assemblies-0.0.0.1-win64-x64.zip 放到 .netcoreengnativetemp 文件夾dotnet-api-docs_netcoreapp3.0-0.0.0.2-win64-x64.zip 放到 .netcoreengnativetemp 文件夾msvcurt-c1xx-0.0.1.2-win64-x64.zip 放到 .netcoreengnativetemp 文件夾net-framework-472-iltools-0.0.0.1-win64-x64.zip 放到 .netcoreengnativetemp 文件夾dotnet-runtime-2.1.7-win-x86.zip 安裝

上面說的 .netcoreengnativetemp 文件夾就是在用戶名下的如 C:Userslindexi.netcoreengnativetemp 文件夾

這些文件都是十分大的，同時有一些文件會下載放在系統(tǒng)的臨時文件夾，如果一開始下載失敗了，第二次不會進行校驗，只會出現(xiàn) IO 解壓縮錯誤，此時就需要小伙伴清空自己的系統(tǒng)臨時文件夾，用戶臨時文件夾和 C:Userslindexi.netcoreengnativetemp 文件夾

在進行構(gòu)建的時候還需要讓 VisualStudio 安裝了差不多所有能裝的負(fù)載，畢竟需要構(gòu)建 C++ 這樣的東西，這對 VisualStudio 版本也有要求。最低的 VisualStudio 要求是 16.4 版本

當(dāng)前，我肯定不會一開始說這么勸退的方法，在本地構(gòu)建的失敗率太高了，即使是我全用梯子下載，也沒有成功，因為有一點是在于構(gòu)建的代碼里面，微軟的小伙伴認(rèn)為網(wǎng)速都是特別快的，沒有在一定的時間內(nèi)下載完成就是失敗。而我基本上每次都是下載到失敗。同時失敗之后下一次沒有做校驗，也就是除非我全部刪除了重新下載，否則可能因為下載不完成構(gòu)建一半翻車

一個簡單的方法是利用 GitHub 的 Action 構(gòu)建，感謝微軟，微軟收購了 GitHub 給了大量土豪的支持，所有小伙伴只要創(chuàng)建 GitHub 賬號都能** GitHub 的 Action 構(gòu)建代碼。而構(gòu)建的服務(wù)器可以選擇 Windows 全環(huán)境服務(wù)器，在服務(wù)器里面安裝了最新的 VisualStudio 和所有的負(fù)載，功能齊全，下載安裝網(wǎng)速基本有 100M 一秒的速度。重要的是這么強大的服務(wù)器還是**，不要錢，只要編寫構(gòu)建腳本就會自動執(zhí)行

好，差不多廣告費到手了，下面讓我告訴大家如何使用 GitHub 的 Action 構(gòu)建 WPF 的框架源代碼

在開始之前先說為什么

原因一在于環(huán)境，因為 WPF 代碼包含一部分 C++ 代碼，這部分代碼特別調(diào)環(huán)境。需要差不多將 VisualStudio 的全部功能安裝才能。我就在這里翻車了，我就少安裝了一個，第二就翻車了，但是很難猜到是少安裝了，因為提示很詭異。雖然我就一句話，給 VisualStudio 按照全部功能，但是我預(yù)計你不會聽我的

原因二在于網(wǎng)速，要下載的包還是大了一點，同時還原 NuGet 的服務(wù)器也沒有國內(nèi)源

剛好 GitHub 的 Action 都能滿足條件，包含了全部環(huán)境，**特別快

使用 GitHub 的 Action 的方法就是創(chuàng)建一個構(gòu)建清單文件，放在 .githubworkflows 文件夾里面。清單文件是 yml 格式，如 dotnetcore.yml 文件

這個清單文件的格式不是咱的重點，理論上小伙伴看了代碼大概就能理解了，不需要去學(xué)習(xí)

name: .NET Coreon: [push]jobs: build: runs-on: windows-latest steps: – uses: actions/checkout@v1 – name: Install Nuget uses: nuget/setup-nuget@v1 with: nuget-version: '5.x' – name: Build run: .build.cmd -pack -ci -configuration Release -prepareMachine /p:Platform=x86

沒錯，將這個清單文件放在清單文件夾里面，如 這個 commit 的做法 就可以讓 WPF 構(gòu)建起來

上面的清單文件也是最簡單的讓 WPF 構(gòu)建的代碼了，核心代碼是 .build.cmd -pack -ci -configuration Release -prepareMachine /p:Platform=x86 通過這句代碼就可以調(diào)用微軟小伙伴寫好的腳本進行構(gòu)建

在日志里面看到輸出構(gòu)建了 nupkg 文件就是構(gòu)建成功

2020-04-23T04:00:24.5493423Z Successfully created package 'D:awpfwpfartifactspackagesReleaseNonShippingruntime.win-x86.Microsoft.DotNet.Wpf.GitHub.5.0.0-ci.nupkg'.2020-04-23T04:00:40.3376680Z Successfully created package 'D:awpfwpfartifactspackagesReleaseNonShippingMicrosoft.DotNet.Arcade.Wpf.Sdk.5.0.0-ci.nupkg'.2020-04-23T04:00:41.1278940Z Successfully created package 'D:awpfwpfartifactspackagesReleaseNonShippingMicrosoft.DotNet.Wpf.GitHub.5.0.0-ci.nupkg'.2020-04-23T04:00:42.2993941Z Successfully created package 'D:awpfwpfartifactspackagesReleaseNonShippingMicrosoft.DotNet.Wpf.ProjectTemplates.5.0.0-ci.nupkg'.2020-04-23T04:00:43.0266336Z Successfully created package 'D:awpfwpfartifactspackagesReleaseNonShippingMicrosoft.NET.Sdk.WindowsDesktop.5.0.0-ci.nupkg'.2020-04-23T04:00:45.5485389Z2020-04-23T04:00:45.5486750Z Build succeeded.2020-04-23T04:00:45.5488608Z 0 Warning(s)2020-04-23T04:00:45.5489064Z 0 Error(s)2020-04-23T04:00:45.5489325Z2020-04-23T04:00:45.5921119Z Time Elapsed 00:05:29.82

也就是最簡單的構(gòu)建 WPF 的方法就是先 Fork 官方倉庫到自己的倉庫，將 WPF 代碼 Clone 到本地，切換 commit 到 f226a72ed5302737b14984cffdd6208731244038 版本，切換 commit 可以使用下面 Git 命令

git checkout f226a72ed5302737b14984cffdd6208731244038

第二新建一個分支，使用 Git 命令如下

git checkout -b 分支名

**本文上面的清單文件的代碼，在相對于 .git 文件夾的 .githubworkflows 文件夾創(chuàng)建 dotnetcore.yml 文件，將上面的清單代碼放入到 dotnetcore.yml 文件

使用 Git 創(chuàng)建 commit 或通過 VisualStudio 的團隊管理創(chuàng)建 commit 推送到自己的 Fork 的倉庫里面，此時將會觸發(fā) GitHub 的 Action 的自動構(gòu)建

在構(gòu)建完成的 WPF 的輸出是 NuGet 包，在 artifactspackages 文件夾

在構(gòu)建成功之后，還請小伙伴試試切換 WPF 的源代碼到最新，嘗試構(gòu)建一下

本地構(gòu)建的方法相對來說比較復(fù)雜，雖然從上面的清單文件可以看到，其實構(gòu)建的代碼只有調(diào)用腳本一句話。但是本地需要先讓環(huán)境搭建，如讓 VisualStudio 安裝全部功能等

本地構(gòu)建的方法如下

先打開 VisualStudio 讓 VisualStudio 安裝全部的功能，特別是 C++ 的全部勾選

保持本地是系統(tǒng)是 Windows 10 最新版本

下載 Download the Windows Driver Kit (WDK) 安裝，我不確定這是不是必須的

搭建好（不可描述），設(shè)置全局（不可描述）

通過 PowerShell 執(zhí)行 .build.cmd 腳本，注意此時不要添加任何后綴，這樣將可以在輸出信息里面快速知道是不是下載失敗了

如果下載失敗了，將會提示如解壓縮失敗等，此時請清空自己的系統(tǒng)臨時文件夾，用戶臨時文件夾，和 .netcoreeng 文件夾。這里的 .netcoreeng 放在用戶文件夾，如 C:Userslindexi.netcoreeng 文件夾。清空 NuGet 緩存文件夾。調(diào)用 git clean -xdf 清空代碼文件

可以通過（不可描述）的輸出找到當(dāng)前需要下載的文件的鏈接，可以嘗試做本地的**，先用其他方式下載第二用 Fiddler 模擬路徑提升**

如果可以到輸出下面代碼，表示前面的下載工具應(yīng)該完成

LINK : fatal error LNK1104: cannot open file 'MSVCURTD_netcore.LIB' [D:awpfwpfsrcMicrosoft.DotNet.WpfsrcDirectWriteForwarderDirectWriteForwarder.vcxproj]

上面代碼是因為沒有指定 x86 的方式構(gòu)建，在命令行運行 .build.cmd -pack -ci -configuration Release -prepareMachine /p:Platform=x86 嘗試構(gòu)建

如果還是失敗了，可以多次嘗試上面的命令，先不要做任何的清理。或者先調(diào)用git clean -xdf 清理一下，第二繼續(xù)調(diào)用上面命令

大概在嘗試很多次，應(yīng)該可以構(gòu)建成功，之后就可以愉快打開 VisualStudio 了，在里面單獨構(gòu)建某個項目了。當(dāng)然也不是所有的項目都能成功構(gòu)建

在調(diào)用上面的腳本的命令里面，其實還有以下的調(diào)用方法，分別是進行 x86 和 x64 的構(gòu)建，以及進行 Debug 和 Release 的構(gòu)建

build.cmd -pack -ci -configuration $(Configuration) -prepareMachine /p:Platform=$(Platform)

請將上面代碼的 $(Configuration) 替換為 Debug 或 Release 將 $(Platform) 替換為 x86 或 x64 進行構(gòu)建

如果能生成官方的構(gòu)建 ID 可以在命令行添加下面參數(shù) /p:OfficialBuildId=$(BuildId) 這里的 BuildId 在官方倉庫里面用的是 $(BUILD.BUILDNUMBER) 這是在 Azure Pipelines 的參數(shù)，大概的值的是 20190909.1 這樣的值，可以自己隨意給

上面參數(shù)的 -ci 是 arcade 提供的功能，用來啟動 CI 構(gòu)建

能構(gòu)建官方開源代碼就可以作出自己私有的版本，在使用上面命令構(gòu)建完成之后，可以在 artifactspackages 文件夾找到構(gòu)建的 NuGet 包，這些文件可以私有發(fā)布，或者自己修改 Id 發(fā)布

現(xiàn)在微軟的開源協(xié)議非常友好，允許小伙伴對源代碼進行修改和發(fā)布

雖然可以進行自己的私有發(fā)布，當(dāng)時我還是推薦將代碼提到官方倉庫，有官方的大佬幫忙看看代碼是否合理。只要在官方的大佬認(rèn)為代碼不合理但是自己卻覺得必須，或者官方發(fā)布太慢了，才使用自己的版本

原因是如果都用自己的版本，后續(xù)官方修了一些內(nèi)容，將很難合并到自己的版本

拓展知識：