如何開始閱讀ASP.NET Core源代碼

来源:https://www.cnblogs.com/wenhx/archive/2020/02/17/Build-ASP-NET-Core-from-Source.html
-Advertisement-
Play Games

背景 當我們對ASP.Net Core內部的某些方法、類的實現感興趣時,有很多方法可以去瞭解,看書,看各種文章,但是最直接也是最深入的辦法就是去閱讀源代碼。ASP.NET Core的源代碼托管在Github,項目地址是:https://github.com/dotnet/aspnetcore。如果只 ...


背景

當我們對ASP.Net Core內部的某些方法、類的實現感興趣時,有很多方法可以去瞭解,看書,看各種文章,但是最直接也是最深入的辦法就是去閱讀源代碼。
ASP.NET Core的源代碼托管在Github,項目地址是:https://github.com/dotnet/aspnetcore
如果只是簡單的想看某個方法是如何實現的,我們可以直接在github網站上瀏覽。
但是通過網頁閱讀源代碼會遇到一些問題,首先是找到指定的類或方法並不容易,其次代碼的展示效果並不友好。
因此最佳的方式就是下載源代碼到我們本機。

下載源代碼

在GitHub上托管的項目的源代碼提供了幾種下載方式:

使用git、SVN、GitHub的客戶端,或者直接下載GitHub打包好的源代碼壓縮包。
如果是簡單的項目,你可以直接下載GitHub打包好的源代碼壓縮包。

但是對於ASP.NET Core這種大型項目,下載的源代碼壓縮包由於缺少子模塊的代碼,無法通過編譯。
不能通過編譯的代碼,下麵這些功能無法使用:IDE提供的類和方法間的快速導航(F12),針對某個屬性、方法等查找它被哪些代碼所引用。
對於大型項目來說,缺少這些功能幾乎沒辦法深入閱讀該項目的源代碼。
尤其是ASP.NET Core這種大量使用了擴展方法的項目,擴展方法可能定義在一個不起眼的角落,通過手工查找繁瑣且困難。
所以強烈推薦使用git來克隆ASP.NET Core項目的倉庫:

git clone --recursive https://github.com/dotnet/aspnetcore


編譯的準備工作

現在,我們已經有源代碼了,但是由於ASP.NET Core項目使用了很多其他技術,所以編譯源代碼之前需要準備編譯環境。
不同的操作系統需求不一樣,以Windows環境下使用Visual Stuido舉例,當前官方文檔(3.1.1版本)上面列出的需求是:

  • Windows 10 version 1803 或更新版本
  • Visual Studio 2019
    版本雖然沒有要求,但是實際依賴的部分組件會在更新版本的更新中包含。
    例如,如果你編譯3.1.0版本的代碼,需要更新到16.4.4以上版本(包含新版本的MSBuild)。
    如果使用VS Code,請看後面的介紹。
  • Git https://git-scm.org
  • NodeJS 10.14.2或更新版本 https://nodejs.org
  • Java Development Kit 11 或更新版本
  • Chrome 基於Selenium的測試要用到

如果你使用的是其它環境(Linux或macOS, VS Code等),請查看詳細的安裝文檔(源代碼中的docs/BuildFromSource.md文件),按照其中Install pre-requisites部分的指引準備編譯環境。
更細節的內容,比如編譯時怎麼查找JDK的(如果你本機已經安裝過了,但是腳本提示找不到),你可以直接查看編譯腳本,.\build.ps1(或.\build.sh)文件。

還原

當編譯環境準備好以後,記得開啟新的命令行視窗,因為新增的環境變數只在安裝後啟動的命令行中生效。
前面克隆到本機的是最新的代碼(更新頻繁),但是對於大多數人來說,我們只關註自己目前正在使用的版本。
ASP.NET Core所有版本的發佈都打了標簽(tag)。
因此,我們可以先使用git命令列出所有的版本。

git tag

然後根據標簽名稱,切換到我們的目標版本,比如3.1.0版本。

git checkout v3.1.0

在你使用Visual Studio或VS Code瀏覽代碼之前需要運行.\restore.cmd(Windows環境,Linux和macOS請使用對應的.sh文件,下同)來還原編譯所依賴的運行環境和各種組件。
每次源代碼有大的更新時,你都需要重新運行.\restore.cmd。
運行.\restore.cmd後,腳本會立即開始檢查編譯所依賴的運行環境並下載各種組件(第一次運行時),
由於伺服器都在國外,因此有些組件下載速度很慢。(如果某個組件下載速度很慢,kexue上網會有極大的改善)

首先會下載dotnet運行環境,這個是最大也是最慢的,做好心理準備。
它被存放在根目錄的.dotnet目錄下,差不多有1GB。

接下來開始下載各個項目所依賴的組件,這部分是通過nuget工具來下載的,
因為網路的原因,下載常常會出錯,在我的中國電信寬頻下反覆重試依然如此。
因為nuget會在本地緩存曾經下載過的組件,所以一旦發生上面的情況,你可以通過下麵這種方式解決:
在VS中新建一個ASP.NET Core的項目,然後在管理NuGet包界面來下載這個包(這時候就能下載了,問號臉),
之後因為本地有緩存了,再次通過命令行下載的時候就無需網路了。

在我本機編譯的過程中,遇到了找不到某個包的情況:Microsoft.Internal.AspNetCore.H2Spec.All 2.1.1。
手工在nuget.org上搜索居然沒有。後來在myget上找到了,還是先在Visual Studio的Package Manager Console中使用下麵的這個命令先安裝在上面新建的項目中:

PM> Install-Package Microsoft.Internal.AspNetCore.H2Spec.All -Version 2.1.1 -Source https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json

再次運行命令就能找到包了。
運行圖:
 


打開解決方案

由於ASP.NET Core項目實在太大了——包含單元測試在內有626個csproj文件,8207個cs文件——所以並沒有一個包含所有子項目的解決方案(.sln文件)。
在.\src目錄下麵有很多子目錄,每一個子目錄都是一個子項目,每個子項目中都包含了一個解決方案(.sln文件)。
和我們平常打開自己的項目不一樣,ASP.NET Core的解決方案文件(.sln)由於需要設置環境變數因此需要使用腳本命令來打開。
運行子目錄中的startvs.cmd即可啟動Visual Studio打開相應的子項目。

根據電腦配置,第一次啟動可能需要耗費相當長的時間,下次就快了。
下圖是MVC項目的解決方案,巨大無比吧。

現在,讓我們開始好好享受閱讀的樂趣吧。(手動狗頭)

如果你需要編譯源代碼的話,修改源代碼以後運行.\build.cmd文件,然後你可以去泡茶了,回來應該就差不多了。(再次狗頭)


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

-Advertisement-
Play Games
更多相關文章
  • 通過上一章的學習,Geometry抽象類表示形狀或路徑。Drawing抽象類扮演了互補的角色,它表示2D圖畫(Drawing)——換句話說,它包含了顯示矢量圖像或點陣圖需要的所有信息。 儘管有幾類畫圖類,但只有GeometryDrawing類能使用已經學習過的幾何圖形。它增加了決定如何繪製圖形的畫筆和 ...
  • String類型很簡單,就不做示例演示了,這裡只貼出Helper類 /// <summary> /// 判斷key是否存在 /// </summary> /// <param name="key"></param> /// <param name="db"></param> /// <returns ...
  • 過濾漢字 Regex.Replace(inputStr,@"[\u4e00-\u9fa5]",string.Empty); 提取漢字: Regex.Replace(inputStr,@"[^\u4e00-\u9fa5]",string.Empty);//註意這裡多了個^符號 ...
  • //從第1個開始,依次向左插入值。如果鍵不存在,先創建再插入值 隊列形式 先進後出,後進先出 //插入後形式 <-- 10,9,8,7,6,5,4,3,2,1 <-- 方向向左依次進行 stopwatch.Start(); for (int i = 0; i < 10; i++) { var get ...
  • 前言 IdentityServer4(以下簡稱 Id4) 是 Asp.Net Core 中一個非常流行的 OpenId Connect 和 OAuth 2.0 框架,可以輕鬆集成到 Asp.Net Core 應用中,並且與 Asp.Net Core Identity 也可以輕鬆集成。博客園也有大佬發 ...
  • 文章出處: https://www.cnblogs.com/dotnet261010/p/6275821.html 一、WPF簡介 WPF:WPF即Windows Presentation Foundation,翻譯為中文“Windows呈現基礎”,是微軟推出的基於Windows Vista的用戶界 ...
  • 定義委托 委托實例化 定義具體執行的方法 綁定方法 觸發委托 ...
  • 1. 前言 Xceed wpftoolkit提供了一個 "CheckListBox" ,效果如下: 不過它用起來不怎麼樣,與其這樣還不如參考UWP的ListView實現,而且動畫效果也很好看: 它的樣式如下: 屬性是很多了,但這裡沒有自定義CheckBox樣式的方法,而且也沒法參考它的動畫如何實現。 ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...