aspnetcore源码编译剖析

概要
基本流程
搭建环境
安装依赖软件
下载源代码
克隆速速慢
版本选择
关键文件说明
Build
输出目录结构
Build命令
注意事项
问题分析
本文主要记录Windows环境下编译aspnetcore源码的基本流程及遇到的问题，官方文档可作为参考。
购买代理（作者采用该方式）
使用vmware安装干净的windows10(版本>=1803)环境, 官网下载windows10光盘镜像文件制作工具(MediaCreationTool20H2),如下图：
💡虚拟机磁盘空间建议>=100G、内存建议>=8G
Win10官网下载地址 https://www.microsoft.com/zh-cn/software-download/windows10/
作者使用的代理地址 https://www.panhdpe.xyz/r/26941964
安装依赖软件

Visual Studio 2019
[下载地址] https://visualstudio.microsoft.com
Git
[下载地址] https://git-scm.org/
JAVA>=11
- OpenJDK https://jdk.java.net/
- Oracle’s JDK https://www.oracle.com/technetwork/java/javase/downloads/index.html
NodeJS >=10.14.2
[下载地址] https://nodejs.org/
下载源代码

因为编译过程中需要从代码库拉取文件，所以不能直接下载压缩包，需要通过git 克隆下来。
git clone --recursive https://github.com/dotnet/aspnetcore
克隆速速慢
 
从gitee已有的aspnetcore仓库克隆代码，然后把远程地址修改为官方地址,该方法克隆的代码可能不是最新官方的代码 
 作者的gitee aspnetcore地址：https://gitee.com/58502050/aspnetcore.git 
把官网仓库导入到gitee,再从gitee克隆，把远程地址修改为官方地址 
本次编译选择的是release/3.1分支，3.1和5.0都是当前支持版本，建议选择3.1和5.0的代码 
关键文件说明
 
Arcade SDK
 
Arcade SDK是MSBuild属性、目标文件集和包，提供了多仓库环境下通用Build功能,包括持续集成、打包、测试、签名、发布等功能。它是.net core 3.0项目集的工程框架，所有.net core3.0后的相关项目都是基于此框架构建的。详细介绍请参考官方文档 
/global.json
 
global.json文件主要描述了依赖工具的版本、dotnet版本和Microsoft.DotNet.Arcade.Sdk版本，其中主要关注dotnet版本， 
  "sdk": {
    "version": "3.1.110"   <————**需要的.netcore sdk版本**
  "tools": {
    "dotnet": "3.1.110",
    "runtimes": {
      "dotnet/x64": [
        "$(MicrosoftNETCoreAppInternalPackageVersion)"   <————**.netcore 运行时版本**
      "dotnet/x86": [
        "$(MicrosoftNETCoreAppInternalPackageVersion)"
    "Git": "2.22.0",
    "jdk": "11.0.3",
    "vs": {
      "version": "16.3",
      "components": [
        "Microsoft.VisualStudio.Component.VC.ATL",
        "Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
        "Microsoft.VisualStudio.Component.Windows10SDK.17134"
  "msbuild-sdks": {
    "Yarn.MSBuild": "1.15.2",
    "Microsoft.DotNet.Arcade.Sdk": "1.0.0-beta.20509.7",
    "Microsoft.DotNet.Helix.Sdk": "2.0.0-beta.20509.7"
💡.net core sdk包含的运行时版本和.net runtime版本可能不是同一版本，需要分别下载安装。.net runtime版本需要参考/eng/Versions.props文件中的MicrosoftNETCoreAppInternalPackageVersion属性 
/build.ps1
 
编译入口文件，里面包含了编译参数的说明，build.cmd和restore.cmd 都是调用的该脚本 
/Directory.Build.props
 
所有项目的属性定义，其中包括本地.dotnet安装位置和.net runtime 安装位置 
/eng目录
 
该目录包括Build过程中的各种资源，其中主要关注以下文件： 
Versions.props 
 包括各种外部依赖的版本 
Build.props 
 Build配置属性，包括需要Build的项目列表等 
common/tools.ps1 
 Build脚本定义的全局变量及相关函数 
Build
 
输出目录结构
 
仓库根目录/
	artifacts/
	  bin/  			<——项目的dll及其他输出
	  installers/ 		<——安装包（eg.msi,zip）
	  obj/ 				<——项目的中间结果
	  log/ 				<——日志文件包括binlog
	  packages/ 		<——NuGet packages，jar包
	  TestResults/	 	<——测试结果
	  VSSetup/
	  symbols/ 			<——调试符号文件
	  tmp/ 				<——build过程中的临时文件
	  toolset/ 			<——toolset恢复生产的文件
Build命令
 
.\build.cmd
💡 执行该命令建议选择系统菜单Visual Studio2019->Developer PowerShell for VS 2019 执行，否则可能导致sdk版本不匹配问题 
C:\Users\node\.nuget\packages\microsoft.dotnet.arcade.sdk\1.0.0-beta.20509.7\tools\Tools.proj : error : . net core sdk
的版本 5.0.100 至少需要 msbuild 的 16.8.0 版本。当前可用的 msbuild 版本为 16.3.0.46305。将在 global. json 中指定的. net core sdk 更改为需要当前可用的 msbui
ld 版本的旧版本。
C:\Users\node\.nuget\packages\microsoft.dotnet.arcade.sdk\1.0.0-beta.20509.7\tools\Tools.proj : error MSB4236: 找不到指 定的 S
DK“Microsoft.NET.Sdk”。
Build failed.
build.cmd completed
💡 build命令参数参见/build.ps1文件参数说明 
编译的过程中需要下载依赖工具，特别是.net core sdk和.net core runtime，建议先下载安装到对应的目录 
注释掉.net core sdk 的下载任务
 由于.net core sdk包比较大，先手动安装，注释掉对应的build 任务 
 在当前windows用户目录下找到C:\Users\$(usename)\.nuget\packages\microsoft.dotnet.arcade.sdk\$(msbuild-sdks.Microsoft.DotNet.Arcade.Sdk)\tools\Tools.proj文件
 💡 $(usename) windows用户名
 💡 $(msbuild-sdks.Microsoft.DotNet.Arcade.Sdk)为global.json文件中Microsoft.DotNet.Arcade.Sdk对应的版本 
 注释掉导入InstallDotNetCore.targets语句 
下载安装 .net core sdk 
 直接从官网上下载global.json 中 sdk对应版本的zip包，然后解压到仓库根目录下的.dotnet目录下即可，如果没有.dotnet目录，可以用命令手动创建一个 
下载安装.net core runtime
 如果build Microsoft.AspNetCore.App.Runtime 项目时出现如下问题，需要先下载对应版本的zip包放入 artifacts\obj\Microsoft.AspNetCore.App.Runtime\目录 
Errors
    C:\aspnetcore\aspnetcore\src\Framework\App.Runtime\src\Microsoft.AspNetCore.App.Runtime.csproj(388,5): Problems downloading file from 'https://dotnetcli.blob.core.windows.net/dotnet/Runtime/3.1.6/dotnet-runtime-3.1.6-win-x64.zip'. 已取消一个任务。    在 System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   在 System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   在 System.Runtime.CompilerServices.TaskAwaiter`1.GetResult()
   在 RepoTasks.DownloadFile.<DownloadWithRetriesAsync>d__26.MoveNext() 位置 
 下载地址为：https://dotnetcli.blob.core.windows.net/dotnet/Runtime/$(tools.dotnet)/dotnet-runtime-$(MicrosoftNETCoreAppInternalPackageVersion)-win-x64.zip
 💡$(tools.dotnet)和$(MicrosoftNETCoreAppInternalPackageVersion)为global.json文件对应的配置 
内存溢出
 编译过程中如出现内存溢出，重新运行build命令即可 
System.OutOfMemoryException: 引发类型为“System.OutOfMemoryException”的异常。
  在 System.Collections.Immutable.SortedInt32KeyNode`1.Mutate(SortedInt32KeyNode`1 left, SortedInt32KeyNode`1 right)
  在 System.Collections.Immutable.SortedInt32KeyNode`1.SetOrAdd(Int32 key, TValue value, IEqualityComparer`1 valueComparer, Boolean overwriteExistingValue, Boolean& replacedExistingValue, Boolean& mutated)
  在 System.Collections.Immutable.SortedInt32KeyNode`1.SetItem(Int32 key, TValue value, IEqualityComparer`1 valueComparer, Boolean& replacedExistingValue, Boolean& mutated)
  在 System.Collections.Immutable.ImmutableDictionary`2.UpdateRoot(SortedInt32KeyNode`1 root, Int32 hashCode, HashBucket newBucket, IEqualityComparer`1 hashBucketComparer)
  在 System.Collections.Immutable.ImmutableDictionary`2.Add(TKey key, TValue value, KeyCollisionBehavior behavior, MutationInput origin)
  在 System.Collections.Immutable.ImmutableDictionary`2.SetItem(TKey key, TValue value)
  在 Microsoft.Build.Collections.CopyOnWritePropertyDictionary`1.Set(T projectProperty)
  在 Microsoft.Build.Collections.CopyOnWritePropertyDictionary`1.set_Item(String name, T value)
  在 Microsoft.Build.Collections.CopyOnWritePropertyDictionary`1.System.Collections.Generic.IDictionary<System.String,T>.set_Item(String name, T value)
  在 Microsoft.Build.BackEnd.BinaryTranslator.BinaryReadTranslator.TranslateDictionary[D,T](D& dictionary, ObjectTranslator`1 objectTranslator)
  在 Microsoft.Build.BackEnd.TranslatorHelpers.TranslateDictionary[D,T](ITranslator translator, D& dictionary, NodePacketValueFactory`1 valueFactory)
  在 Microsoft.Build.Execution.ProjectItemInstance.TaskItem.Microsoft.Build.BackEnd.ITranslatable.Translate(ITranslator translator)
  在 Microsoft.Build.Execution.ProjectItemInstance.TaskItem..ctor(ITranslator translator)
  在 Microsoft.Build.Execution.ProjectItemInstance.TaskItem.FactoryForDeserialization(ITranslator translator)
  在 Microsoft.Build.BackEnd.TranslatorHelpers.Translate[T](ITranslator translator, T& instance, NodePacketValueFactory`1 valueFactory)
  在 Microsoft.Build.Execution.ProjectItemInstance.Microsoft.Build.BackEnd.ITranslatable.Translate(ITranslator translator)
  在 Microsoft.Build.Execution.ProjectInstance.<>c__DisplayClass220_0.<TranslateItems>b__0(ITranslator <p0>)
  在 Microsoft.Build.BackEnd.TranslatorHelpers.Translate[T](ITranslator translator, T& instance, NodePacketValueFactory`1 valueFactory)
  在 Microsoft.Build.Execution.ProjectInstance.TranslateItems(ITranslator translator)
  在 Microsoft.Build.Execution.ProjectInstance.TranslateMinimalState(ITranslator translator)
  在 Microsoft.Build.Execution.ProjectInstance.Microsoft.Build.BackEnd.ITranslatable.Translate(ITranslator translator)
  在 Microsoft.Build.BackEnd.BuildRequestConfiguration.RetrieveFromCache()
  在 Microsoft.Build.BackEnd.BuildRequestEngine.ActivateBuildRequest(BuildRequestEntry entry)
  在 Microsoft.Build.BackEnd.BuildRequestEngine.<>c__DisplayClass39_0.<SubmitBuildRequest>b__0()
  在 Microsoft.Build.BackEnd.BuildRequestEngine.<>c__DisplayClass67_0.<QueueAction>b__0()
在build过程中如果出现其他问题，可以在命令中加入-bl参数，将在log目录中生成binlog日志，然后通过msbuildlog工具查看日志，分析原因 
编译成功后,在artifacts\installers\Debug目录下会生成相应的zip包，把该压缩包解压到本机的dotnet安装目录下，然后新建项目就可以跟踪调试aspnetcore的代码
                    问题C:\Users\node\.nuget\packages\microsoft.dotnet.arcade.sdk\1.0.0-beta.20509.7\tools\Tools.proj : error : . net core sdk的版本 5.0.100 至少需要 msbuild 的 16.8.0 版本。当前可用的 msbuild 版本为 16.3.0.46305。将在 global. json 中指定的. net core sdk 更改为需要当前可用的 msbuild 版本的旧版本。C:\
				今天从GitHub上拉下来一个工程，正想要学习的时候，打开工程结果出现了 “无法找到 .NET Core SDK。请检查确保已安装此项且 global.json 中指定的版本(如有)与所安装的版本相匹配” 的报错，在经过一系列百度之后，得到最简单解决方案：
使用cmd命令 dotnet --info 查看自己使用的SDK版本，然后直接找到项目中的 global.json 文件，右键打开，直接修改版...




    

				有时，我们可能会在VS打开项目时，报因MSBuild版本问题而无法打开项目的情况，里面有一条关键的提示：“请将在 global.json 中指定的 .NET SDK 更改为需要当前可用的 MSBuild 版本的旧版。”
解决方法：
到微软官方（Url: https://dotnet.microsoft.com/en-us/download/dotnet）下载对应的.Net SDK即可。如果下载安装后仍无法解决，在项目.csproj对应目录中放置global.json文件（具体内容见正文），然后再打开。
				假如项目规定了MSBUild版本，那么在安装完Visual Studio后，假如带的MSBUild版本与项目要求的版本不符合要求，那么可以把需要的MSBUild添加到系统中，然后即可使用。步骤如下：
           假如项目需要使用V12的MSBUild，而安装的Visual Studio带的MSBUild版本为V14。
①到MSDN下载V12 MSBUild包，把V12包解压到目录
				今天从GitHub上拉下来一个工程，正想要学习的时候，打开工程结果出现了 “无法找到 .NET Core SDK。请检查确保已安装此项且 global.json 中指定的版本(如有)与所安装的版本相匹配” 的报错。
❶ 检查CORE是否安装，在控制面板程序查看。
❷使用cmd命令，但是提示提示dotnet 不是外部或内部有效命令。
dotnet --version
❸此电脑–>属性–>高级系统设置–>环境变量–>系统变量–>Path–>编辑–>把下面的这句添加进去
				Android源码编译的命令包括以下几个步骤：
1. 在Android源码根目录下执行build/envsetup.sh脚本，该脚本用于设置Android的编译环境。\[1\]
2. 使用lunch命令选择要编译的目标。\[1\]
3. 使用make命令编译整个Android系统。\[1\]
此外，还有一些其他的编译命令可以使用：
- 使用m命令对整个Android源代码进行编译，它是对make命令的简单封装。\[2\]
- 使用mm命令对Android源码中的指定模块进行编译，它也是通过make命令来实现的。\[2\]
- 使用mmm命令对Android源码中的指定模块进行编译，与mm命令类似，但需要指定Android.mk文件的相对路径。\[2\]\[3\]
综上所述，编译Android源码的常用命令包括build/envsetup.sh、lunch和make，而m、mm和mmm命令是对make命令的封装，用于更方便地编译Android源码或指定模块。
#### 引用[.reference_title]
-  *1* [android平台的三个编译命令----make,mm,mmm](https://blog.csdn.net/xiangyuxiangyu123/article/details/54098153)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down1,239^v3^insert_chatgpt"}} ] [.reference_item]
-  *2* *3* [Android源代码编译命令m/mm/mmm/make分析【转载】](https://blog.csdn.net/weixin_30411997/article/details/95102327)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down1,239^v3^insert_chatgpt"}} ] [.reference_item]
[ .reference_list ]
				mongoexport 导出json 报sasl conversation error: unable to authenticate using mechanism “SCRAM-SHA-1“