前沿拓展：

導(dǎo)語(yǔ)

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

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

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

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

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

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

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 安裝

上面說(shuō)的 .netcoreengnativetemp 文件夾就是在用戶(hù)名下的如 C:Userslindexi.netcoreengnativetemp 文件夾

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

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

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

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

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

在開(kāi)始之前先說(shuō)為什么

原因一在于環(huán)境，因?yàn)?WPF 代碼包含一部分 C++ 代碼，這部分代碼特別調(diào)環(huán)境。需要差不多將 VisualStudio 的全部功能安裝才能。我就在這里翻車(chē)了，我就少安裝了一個(gè)，第二就翻車(chē)了，但是很難猜到是少安裝了，因?yàn)樘崾竞茉幃?。雖然我就一句話(huà)，給 VisualStudio 按照全部功能，但是我預(yù)計(jì)你不會(huì)聽(tīng)我的

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

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

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

這個(gè)清單文件的格式不是咱的重點(diǎn)，理論上小伙伴看了代碼大概就能理解了，不需要去學(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

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

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

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

git checkout f226a72ed5302737b14984cffdd6208731244038

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

git checkout -b 分支名

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

使用 Git 創(chuàng)建 commit 或通過(guò) VisualStudio 的團(tuán)隊(duì)管理創(chuàng)建 commit 推送到自己的 Fork 的倉(cāng)庫(kù)里面，此時(shí)將會(huì)觸發(fā) GitHub 的 Action 的自動(dòng)構(gòu)建

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

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

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

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

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

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

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

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

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

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

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

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

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

上面代碼是因?yàn)闆](méi)有指定 x86 的方式構(gòu)建，在命令行運(yùn)行 .build.cmd -pack -ci -configuration Release -prepareMachine /p:Platform=x86 嘗試構(gòu)建

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

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

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

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

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

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

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

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

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

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

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

拓展知識(shí)：