ASP.NET Core Daily Builds 實(shí)踐指南NuGet 每日構(gòu)建源配置、運(yùn)行時(shí)下載與 Visual Studio 調(diào)試【免費(fèi)下載鏈接】aspnetcoreASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/as/aspnetcore本文基于 ASP.NET Core 倉(cāng)庫(kù)的 DailyBuilds 官方文檔 展開講解如何獲取和使用 ASP.NET Core 的每日構(gòu)建Daily/Nightly Builds包括為項(xiàng)目配置指向 dnceng 每日構(gòu)建 NuGet 源的 NuGet.Config、按平臺(tái)下載最新的 ASP.NET Core 共享框架Shared Framework安裝包與二進(jìn)制文件以及配置 Visual Studio 以調(diào)試每日構(gòu)建產(chǎn)物。讀完本文你將能夠把任意 ASP.NET Core 應(yīng)用指向最新的每日構(gòu)建包進(jìn)行嘗鮮驗(yàn)證并具備在無(wú)源碼符號(hào)服務(wù)器上調(diào)試框架內(nèi)部代碼的能力。1. Daily Builds 是什么適用邊界在哪里Daily builds 包含 ASP.NET Core 倉(cāng)庫(kù)中最新的源碼變更。官方文檔明確給出三點(diǎn)定位見 docs/DailyBuilds.md包含最新變更Daily builds 會(huì)持續(xù)納入主干上的最新源碼修改不用于生產(chǎn)它們不受支持not supported for production use且可能頻繁變化盡力保證可用官方會(huì)盡力確保每日構(gòu)建功能正確但出現(xiàn)問(wèn)題時(shí)它只是定位新 bug 或驗(yàn)證修復(fù)的渠道不是穩(wěn)定的發(fā)布渠道。從倉(cāng)庫(kù)當(dāng)前狀態(tài)可以推斷其定位倉(cāng)庫(kù)的 eng/Versions.props 中定義了AspNetCoreMajorVersion為11且eng/Version.Details.props中各依賴包版本形如11.0.0-rc.1.26427.131——即當(dāng)前主干處于 11.0 的預(yù)發(fā)布階段這類 pre-release 版本只會(huì)發(fā)布到每日構(gòu)建源而不會(huì)出現(xiàn)在 NuGet.org 的正式版中。因此Daily builds 的典型使用場(chǎng)景是在正式版本發(fā)布前驗(yàn)證某項(xiàng)新特性、復(fù)現(xiàn)上游剛修復(fù)的問(wèn)題、或追蹤某個(gè) PR 合入后的實(shí)際行為。獲取每日構(gòu)建有兩條互補(bǔ)的路徑后文分別展開NuGet 包路線讓應(yīng)用項(xiàng)目從 dnceng 的每日構(gòu)建 NuGet 源恢復(fù)Microsoft.AspNetCore.*預(yù)發(fā)布包適合自包含/框架引用方式開發(fā)驗(yàn)證運(yùn)行時(shí)路線直接下載安裝最新的 ASP.NET Core Shared Framework 安裝包或二進(jìn)制文件適合驗(yàn)證運(yùn)行時(shí)行為、部署冒煙測(cè)試。兩條路線都需要先準(zhǔn)備好對(duì)應(yīng)的 .NET SDK 每日構(gòu)建因?yàn)樾掳?target framework 往往需要 prerelease 工具鏈支持。2. NuGet 路線為項(xiàng)目配置每日構(gòu)建源2.1 前置條件SDK 每日構(gòu)建第一步是獲取最新的 .NET Core SDK 每日構(gòu)建官方文檔指向 dotnet 倉(cāng)庫(kù)的 builds table。如果使用的是穩(wěn)定版 SDK可能無(wú)法識(shí)別每日構(gòu)建包中的新 target framework 或新特性 API倉(cāng)庫(kù)自身也是這一做法的例證——其 global.json 固定使用11.0.100-rc.1.26420.103這一預(yù)發(fā)布 SDK 版本并給出明確的報(bào)錯(cuò)提示{ sdk: { version: 11.0.100-rc.1.26420.103, paths: [.dotnet, $host$], errorMessage: The .NET SDK could not be found, run ./restore.cmd or ./restore.sh first. } }其中paths中的.dotnet表示倉(cāng)庫(kù)期望把 SDK 安裝到本地目錄通過(guò)restore.sh/restore.cmd觸發(fā)$host$則回退到全局安裝的 SDK。2.2 各主版本的 NuGet.Config 配置官方文檔為每個(gè)仍在維護(hù)的主版本提供了獨(dú)立的每日構(gòu)建 feed。以下配置需完整繼承——將其保存為項(xiàng)目目錄下的NuGet.Config注意大小寫按 NuGet 約定文件名為NuGet.Config或nuget.config均可被識(shí)別NET 8?xml version1.0 encodingutf-8? configuration packageSources clear / add keydotnet8 valuehttps://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json / add keyNuGet.org valuehttps://api.nuget.org/v3/index.json / /packageSources /configuration.NET 9?xml version1.0 encodingutf-8? configuration packageSources clear / add keydotnet9 valuehttps://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json / add keyNuGet.org valuehttps://api.nuget.org/v3/index.json / /packageSources /configuration.NET 10?xml version1.0 encodingutf-8? configuration packageSources clear / add keydotnet10 valuehttps://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet10/nuget/v3/index.json / add keyNuGet.org valuehttps://api.nuget.org/v3/index.json / /packageSources /configuration.NET 11?xml version1.0 encodingutf-8? configuration packageSources clear / add keydotnet11 valuehttps://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet11/nuget/v3/index.json / add keyNuGet.org valuehttps://api.nuget.org/v3/index.json / /packageSources /configuration各配置項(xiàng)的作用元素作用clear /清除繼承自用戶級(jí)/機(jī)器級(jí) NuGet 配置的既有源確保源列表是干凈、可預(yù)期的add keydotnetX ... /添加對(duì)應(yīng)主版本的 dnceng 每日構(gòu)建 feed其中的Microsoft.AspNetCore.*包帶有與主干匹配的 pre-release 版本號(hào)add keyNuGet.org ... /保留 NuGet.org 作為回退源用于恢復(fù)第三方依賴非 ASP.NET Core 的包關(guān)于版本選擇由于每日構(gòu)建的 pre-release 版本號(hào)通常高于正式版例如11.0.0-*高于11.0.x正式號(hào)只要項(xiàng)目未鎖死版本號(hào)dotnet restore時(shí) NuGet 會(huì)優(yōu)先選中每日構(gòu)建源中的最新 pre-release 包這正是吃到每日構(gòu)建的機(jī)制。2.3 關(guān)鍵注意事項(xiàng)NuGet.Config 的作用域官方文檔特別強(qiáng)調(diào)原文 NOTE這份 NuGet.Config 應(yīng)當(dāng)放在你的應(yīng)用旁邊除非你希望機(jī)器上的其他應(yīng)用也開始恢復(fù) nightly 包。也就是說(shuō)放到項(xiàng)目目錄或解決方案目錄只有該項(xiàng)目的恢復(fù)行為受影響隔離性最好是推薦做法放到用戶級(jí)/機(jī)器級(jí)配置位置本機(jī)所有項(xiàng)目的 restore 都可能開始解析到每日構(gòu)建的 nightly 包造成環(huán)境污染一般只在專用的開發(fā)機(jī)上這樣做。這一建議與倉(cāng)庫(kù)自身的組織方式一致ASP.NET Core 倉(cāng)庫(kù)根目錄就有一份帶dotnet8/dotnet9/dotnet10/dotnet11等每日構(gòu)建源的 NuGet.config其中標(biāo)注了Package sources managed by Dependency Flow automation——它只對(duì)該倉(cāng)庫(kù)的構(gòu)建生效。對(duì)照 docs/UpdatingMajorVersionAndTFM.md 中的說(shuō)明可以進(jìn)一步看到該源配置的演進(jìn)規(guī)則每新增一個(gè)主版本就需要把現(xiàn)有 feed如dotnet8和dotnet8-transport復(fù)制出對(duì)應(yīng)新版本的條目dotnet9、dotnet9-transport并盡量移除舊 feed。這里出現(xiàn)了文檔正文未展開的概念——transport feed2.4 倉(cāng)庫(kù)源碼佐證transport feed 與版本命名倉(cāng)庫(kù)根 NuGet.config 中每個(gè)主版本 feed 都有一個(gè)形如dotnetX-transport的配對(duì)源例如add keydotnet11-transport valuehttps://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet11-transport/nuget/v3/index.json /從源碼結(jié)構(gòu)看transport feed 用于傳遞倉(cāng)庫(kù)構(gòu)建期間需要、但尚未發(fā)布到正式 dotnetX feed 的跨倉(cāng)庫(kù)依賴。eng/Version.Details.props 中的MicrosoftInternalRuntimeAspNetCoreTransportPackageVersion當(dāng)前值11.0.0-rc.1.26427.131經(jīng)由MicrosoftInternalRuntimeAspNetCoreTransportVersion屬性被 global.json 的tools.runtimes引用用于下載匹配版本的運(yùn)行時(shí)。對(duì)普通使用者而言應(yīng)用級(jí)配置通常只需要dotnetX主 feed NuGet.org 兩個(gè)源即上文四個(gè)模板transport feed 主要服務(wù)于 ASP.NET Core 倉(cāng)庫(kù)自身及其構(gòu)建鏈但若你的場(chǎng)景涉及恢復(fù)倉(cāng)庫(kù)內(nèi)部的實(shí)驗(yàn)性組件則需要理解這一機(jī)制。3. 運(yùn)行時(shí)路線下載 ASP.NET Core 每日構(gòu)建的 Shared Framework除了 NuGet 包還可以直接下載 ASP.NET Core 共享框架的每日構(gòu)建。官方文檔指引到 README.md 的Nightly builds小節(jié)其中提供了一張按平臺(tái)組織的下載表當(dāng)前指向 11.0 每日構(gòu)建平臺(tái)Shared Framework安裝包Shared Framework二進(jìn)制Hosting Bundle安裝包Windows x64InstallerBinariesInstallerWindows x86InstallerBinariesInstallerWindows arm64InstallerBinariesInstallermacOS x64N/ABinariesN/AmacOS arm64N/ABinariesN/ALinux x64Deb / RPMBinariesN/ALinux armN/ABinariesN/ALinux arm64RPMBinariesN/ALinux-musl x64/arm/arm64N/ABinaries 等N/AREADME 原文對(duì)三列的說(shuō)明值得完整保留Hosting Bundle包含 ASP.NET Core Shared Framework、.NET Runtime Shared Framework 以及 IIS 插件ASP.NET Core Module如果不確定自己需要什么安裝 SDK 即可——它包含除 IIS 插件之外的一切。表中 URL 采用aka.ms/dotnet/{版本}/daily/...短鏈形式會(huì)持續(xù)重定向到當(dāng)天的最新構(gòu)建因此無(wú)需每天抓取新鏈接。配套說(shuō)明.NET Runtime 的每日構(gòu)建與 .NET SDK 的每日構(gòu)建分別在 dotnet/runtime 與 dotnet 倉(cāng)庫(kù)的對(duì)應(yīng)文檔中提供README 表格腳注給出。也就是說(shuō)一次完整的每日構(gòu)建嘗鮮可能涉及三塊組件——SDK編譯、Runtime執(zhí)行、AspNetCore Shared FrameworkWeb 運(yùn)行時(shí)三者版本應(yīng)保持在同一主干時(shí)間點(diǎn)上。4. 用 Visual Studio 調(diào)試 Daily Builds嘗鮮每日構(gòu)建后往往需要直接調(diào)試框架內(nèi)部實(shí)現(xiàn)。官方文檔給出了四項(xiàng)必須調(diào)整的 Visual Studio 設(shè)置docs/DailyBuilds.md啟用 Source Link 支持Enable Source Link support使調(diào)試器能通過(guò)源碼倉(cāng)庫(kù)還原源文件路徑與內(nèi)容啟用 source server 支持Enable source server support允許調(diào)試器從遠(yuǎn)程 source server 拉取當(dāng)時(shí)的源文件禁用 Just My CodeEnable Just My Code 應(yīng)關(guān)閉否則調(diào)試器會(huì)跳過(guò)框架/庫(kù)代碼無(wú)法進(jìn)入 ASP.NET Core 內(nèi)部Symbols 中啟用 Microsoft Symbol Servers從微軟符號(hào)服務(wù)器下載與構(gòu)建匹配的 PDB。這四項(xiàng)分別對(duì)應(yīng)找到源碼 → 拉取源碼 → 不跳庫(kù)代碼 → 解析符號(hào)的調(diào)試閉環(huán)缺一環(huán)都可能導(dǎo)致斷點(diǎn)變灰或棧幀無(wú)法顯示源碼。另外官方文檔還提醒某些功能例如新的 target framework可能需要Visual Studio 的 prerelease 工具鏈才能支持這些工具鏈可通過(guò) Visual Studio Preview 獲取。這與第 2.1 節(jié)的SDK 每日構(gòu)建是同一件事的兩面SDK/VS 工具鏈決定你能編譯到什么版本NuGet feed 決定你能引用到什么版本。5. 補(bǔ)充從本倉(cāng)庫(kù)本地構(gòu)建 ASP.NET Core如果你不只是想使用每日構(gòu)建而是想自己從源碼構(gòu)建本文倉(cāng)庫(kù)即 aspnetcore 倉(cāng)庫(kù)本身官方提供了一鍵恢復(fù)腳本。倉(cāng)庫(kù)根目錄的 restore.sh 與 restore.cmd 做的事情完全一致# restore.sh $DIR/eng/build.sh --all --restore --no-build $:: restore.cmd PowerShell ... -Command ... %~dp0\eng\build.ps1 -all -nobuild -restore %*; exit $LASTEXECUTE ...即調(diào)用 Arcade 構(gòu)建入口 eng/build.sh/eng/build.ps1以--all --restore --no-build恢復(fù)整棵依賴圖。結(jié)合 docs/BuildFromSource.md 的說(shuō)明restore完成后即可用eng/common/build.sh --all之類的命令進(jìn)行完整構(gòu)建。構(gòu)建產(chǎn)物的版本由 eng/Versions.props 的VersionPrefix$(AspNetCoreMajorMinorVersion).$(AspNetCorePatchVersion)當(dāng)前即11.0.0控制。6. 快速核對(duì)清單確認(rèn)目標(biāo)主版本8/9/10/11取得對(duì)應(yīng)dotnetX每日構(gòu)建 feed 的 NuGet.Config 模板本文 2.2 節(jié)四份配置將 NuGet.Config 放在應(yīng)用/項(xiàng)目目錄下而非用戶級(jí)配置避免污染本機(jī)其他項(xiàng)目的 restore同步獲取 .NET SDK 每日構(gòu)建涉及新 TFM 時(shí)確認(rèn)使用 Visual Studio Preview 工具鏈需要驗(yàn)證運(yùn)行時(shí)行為時(shí)從 README.md Nightly builds 表下載對(duì)應(yīng)平臺(tái)的 Shared Framework不確定就裝 SDK調(diào)試前按第 4 節(jié)開啟 Source Link / source server關(guān)閉 Just My Code啟用 Microsoft Symbol Servers記住邊界daily builds 不適用于生產(chǎn)功能與行為可能隨時(shí)變化。以上即 docs/DailyBuilds.md 覆蓋的全部操作要素——NuGet 每日源配置四個(gè)主版本模板、SDK/Preview 工具鏈前置條件、項(xiàng)目級(jí) NuGet.Config 作用域注意事項(xiàng)、Visual Studio 四項(xiàng)調(diào)試設(shè)置以及指向 README.md Nightly builds 表的下載入口——并補(bǔ)充了倉(cāng)庫(kù)自身的NuGet.config、Version.Details.props、global.json與 restore 腳本作為實(shí)現(xiàn)層面的佐證?！久赓M(fèi)下載鏈接】aspnetcoreASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/as/aspnetcore創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考