手把手教你如何構建 WPF 官方開源框架源代碼

来源:https://www.cnblogs.com/lindexi/archive/2020/04/24/12765185.html
-Advertisement-
Play Games

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


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

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

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

構建 WPF 的步驟如下：

  1. 下載構建需要的依賴庫
  2. 還原 NuGet 包
  3. 按照順序構建 C++ 和 C# 代碼，創建 NuGet 包

這裡面對於咱國內的小伙伴，最坑的問題就是下載構建需要的庫，需要的庫如下

  • 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 放到 .netcoreeng\native\temp 文件夾
  • net-framework-48-ref-assemblies-0.0.0.1-win64-x64.zip 放到 .netcoreeng\native\temp 文件夾
  • dotnet-api-docs_netcoreapp3.0-0.0.0.2-win64-x64.zip 放到 .netcoreeng\native\temp 文件夾
  • msvcurt-c1xx-0.0.1.2-win64-x64.zip 放到 .netcoreeng\native\temp 文件夾
  • net-framework-472-iltools-0.0.0.1-win64-x64.zip 放到 .netcoreeng\native\temp 文件夾
  • dotnet-runtime-2.1.7-win-x86.zip 安裝

上面說的 .netcoreeng\native\temp 文件夾就是在用戶名下的如 C:\Users\lindexi\.netcoreeng\native\temp\ 文件夾

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

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

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

一個簡單的方法是利用 GitHub 的 Action 構建，感謝微軟，微軟收購了 GitHub 給了大量土豪的支持，所有小伙伴只要創建 GitHub 賬號都能免費使用 GitHub 的 Action 構建代碼。而構建的伺服器可以選擇 Windows 全環境伺服器，在伺服器裡面安裝了最新的 VisualStudio 和所有的負載，功能齊全，下載安裝網速基本有 100M 一秒的速度。重要的是這麼強大的伺服器還是免費使用，不要錢，只要編寫構建腳本就會自動執行

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

在開始之前先說為什麼

原因一在於環境，因為 WPF 代碼包含一部分 C++ 代碼，這部分代碼特別調環境。需要差不多將 VisualStudio 的全部功能安裝才能。我就在這裡翻車了，我就少安裝了一個，然後就翻車了，但是很難猜到是少安裝了，因為提示很詭異。雖然我就一句話，給 VisualStudio 按照全部功能，但是我預計你不會聽我的

原因二在於網速，要下載的包還是大了一點，同時還原 NuGet 的伺服器也沒有國內源

剛好 GitHub 的 Action 都能滿足條件，包含了全部環境，下載速度特別快

使用 GitHub 的 Action 的方法就是創建一個構建清單文件，放在 .github\workflows\ 文件夾裡面。清單文件是 yml 格式，如 dotnetcore.yml 文件

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

name: .NET Core

on: [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 構建起來

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

在日誌裡面看到輸出構建了 nupkg 文件就是構建成功

2020-04-23T04:00:24.5493423Z   Successfully created package 'D:\a\wpf\wpf\artifacts\packages\Release\NonShipping\runtime.win-x86.Microsoft.DotNet.Wpf.GitHub.5.0.0-ci.nupkg'.
2020-04-23T04:00:40.3376680Z   Successfully created package 'D:\a\wpf\wpf\artifacts\packages\Release\NonShipping\Microsoft.DotNet.Arcade.Wpf.Sdk.5.0.0-ci.nupkg'.
2020-04-23T04:00:41.1278940Z   Successfully created package 'D:\a\wpf\wpf\artifacts\packages\Release\NonShipping\Microsoft.DotNet.Wpf.GitHub.5.0.0-ci.nupkg'.
2020-04-23T04:00:42.2993941Z   Successfully created package 'D:\a\wpf\wpf\artifacts\packages\Release\NonShipping\Microsoft.DotNet.Wpf.ProjectTemplates.5.0.0-ci.nupkg'.
2020-04-23T04:00:43.0266336Z   Successfully created package 'D:\a\wpf\wpf\artifacts\packages\Release\NonShipping\Microsoft.NET.Sdk.WindowsDesktop.5.0.0-ci.nupkg'.
2020-04-23T04:00:45.5485389Z 
2020-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.5489325Z 
2020-04-23T04:00:45.5921119Z Time Elapsed 00:05:29.82

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

git checkout f226a72ed5302737b14984cffdd6208731244038

然後新建一個分支，使用 Git 命令如下

git checkout -b 分支名

複製本文上面的清單文件的代碼，在相對於 .git 文件夾的 .github\workflows\ 文件夾創建 dotnetcore.yml 文件，將上面的清單代碼放入到 dotnetcore.yml 文件

使用 Git 創建 commit 或通過 VisualStudio 的團隊管理創建 commit 推送到自己的 Fork 的倉庫裡面，此時將會觸發 GitHub 的 Action 的自動構建

在構建完成的 WPF 的輸出是 NuGet 包，在 artifacts\packages 文件夾

在構建成功之後，還請小伙伴試試切換 WPF 的源代碼到最新，嘗試構建一下

本地構建的方法相對來說比較複雜，雖然從上面的清單文件可以看到，其實構建的代碼只有調用腳本一句話。但是本地需要先讓環境搭建，如讓 VisualStudio 安裝全部功能等

本地構建的方法如下

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

保持本地是系統是 Windows 10 最新版本

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

搭建好梯子，設置全局代理

通過 PowerShell 執行 .\build.cmd 腳本，註意此時不要添加任何尾碼，這樣將可以在輸出信息裡面快速知道是不是下載失敗了

如果下載失敗了，將會提示如解壓縮失敗等，此時請清空自己的系統臨時文件夾，用戶臨時文件夾，和 .netcoreeng 文件夾。這裡的 .netcoreeng 放在用戶文件夾，如 C:\Users\lindexi\.netcoreeng\ 文件夾。清空 NuGet 緩存文件夾。調用 git clean -xdf 清空代碼文件

可以通過梯子的輸出找到當前需要下載的文件的鏈接，可以嘗試做本地的代理，先用其他方式下載然後用 Fiddler 模擬路徑提升下載速度

如果可以到輸出下麵代碼，表示前面的下載工具應該完成

LINK : fatal error LNK1104: cannot open file 'MSVCURTD_netcore.LIB' [D:\a\wpf\wpf\src\Microsoft.DotNet.Wpf\src\DirectWriteForwarder\DirectWriteForwarder.vcxproj]

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

如果還是失敗了，可以多次嘗試上面的命令，先不要做任何的清理。或者先調用git clean -xdf 清理一下，然後繼續調用上面命令

大概在嘗試很多次，應該可以構建成功，之後就可以愉快打開 VisualStudio 了，在裡面單獨構建某個項目了。當然也不是所有的項目都能成功構建

在調用上面的腳本的命令裡面，其實還有以下的調用方法，分別是進行 x86 和 x64 的構建，以及進行 Debug 和 Release 的構建

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

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

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

上面參數的 -ci 是 arcade 提供的功能，用來啟動 CI 構建

能構建官方開源代碼就可以作出自己私有的版本，在使用上面命令構建完成之後，可以在 artifacts\packages 文件夾找到構建的 NuGet 包，這些文件可以私有發佈，或者自己修改 Id 發佈

現在微軟的開源協議非常友好，允許小伙伴對源代碼進行修改和發佈

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

原因是如果都用自己的版本，後續官方修了一些內容，將很難合併到自己的版本


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 【劍指Offer】鏈表中倒數第k個結點
    題目描述 輸入一個鏈表，輸出該鏈表中倒數第k個結點。 解法 基本思路是使用兩個輔助指針p, q，讓p先走k 1步後，p, q兩個指針再一起走 這樣當p指針走到鏈表的末尾時，q指針剛好走到的就是倒數第k個結點 如下圖所示 實現代碼 更多演算法題目的完整描述，AC代碼，以及解題思路可以查看GitHub倉庫 ...
  • Entity Framework發佈到IIS報錯
    參考資料：https://www.cnblogs.com/mrma/p/5404584.html 報錯信息 The Entity Framework provider type 'System.Data.Entity.SqlServer.SqlProviderServices, EntityFram ...
  • SetParameterValue for main report or subreport in crystal report
    為水晶報表傳遞參數。 在水晶報表中，有從資料庫的存儲過程作為數據源。 當然存儲過程是帶有參數的。 在ASP.NET ASPX 網頁或是在ASP.NET MVC呈現報表時，我們得為存儲過程的參數傳值至水晶報表中。 如下： 以上為報表佈局。除了高亮的區塊為主報表，其餘的均為子報表。 不管是主報表，還是子 ...
  • C# 基礎知識系列- 12 任務和多線程
    0. 前言 照例一份前言，在介紹任務和多線程之前，先介紹一下非同步和同步的概念。我們之間介紹的知識點都是在同步執行，所謂的同步就是一行代碼一行代碼的執行，就像是我們日常乘坐地鐵通過安檢通道一樣，想象我們每個人都是一行代碼，我們依次通過安檢儀器的時候就是同步。 那麼，什麼是非同步呢？有一個時間利用率的故事 ...
  • WPF在Gmap.net中將Marker動起來
    前一段時間說過一篇繪製極坐標的，這段時間對它進行了改造已經今非昔比了，功能實現了很多，我目的是讓Marker動起來，然後還會繪製Route，上篇也就是簡單的繪製了Route,沒有關於Marker的相關知識。那個Circle有一定的改造，原來的純色改成了漸變，這個你可以提前想好，不過在代碼中你要做好適... ...
  • WPF 引用字體文件資源
    外部字體文件 1.後臺代碼引用字體 將一個名為“ChineseCharacterSpecialFont.ttf”的ttf文件，放在桌面路徑，後臺引用方式如下： 1 var ttfFilePath = @"C:\Users\user\Desktop\"; 2 HanziTextBlock.FontFa ...
  • [Asp.Net Core] Blazor Server Side 開發教程 - 進度, 計劃, 安排
    前言: 在寫了上一篇文章之後, Blazor Server Side 開發教程 - 安裝環境與運行第一個程式 還寫了一個較遠的東西 : 視頻圖文教學 - 用最快的速度把 DotNet Core Blazor 程式安裝到 樹莓派中 並且用網頁控制 GPIO 閃燈 到現在, 居然已經過了一個多星期了. ...
  • net core天馬行空系列：降低net core門檻，資料庫操作和http訪問僅需寫介面，實現類由框架動態生成
    引文 hi，大家好，我是三合。不知各位有沒有想過，如果能把資料庫操作和http訪問都統一封裝成介面（interface）的形式， 然後介面對應的實現類由框架去自動生成，那麼必然能大大降低工作量，因為不需要去寫很多重覆的代碼了，還有一個好處是，都是提供介面，我們把原來資料庫操作的部分，改成http訪問 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類