.NET Core 分发打包.NET Core distribution packaging
- 本文内容
磁盘布局Disk layout
推荐的包Recommended packages
生成包Building packages

.NET Core 分发打包.NET Core distribution packaging

本文内容

由于 .NET Core 现已可用于更多平台，因此了解如何为其打包、命名并进行版本控制将很有用。这样，无论用户选择在哪里运行 .NET，包维护人员均可以帮助确保获得一致的体验。本文对以下用户非常有用：

尝试从源生成 .NET Core。
想要更改 .NET Core CLI，但更改可能会影响生成的布局或包。

磁盘布局Disk layout

安装时，.NET Core 包含一些组件，这些组件在文件系统中排列如下：

.
├── dotnet                       (1)
├── LICENSE.txt                  (8)
├── ThirdPartyNotices.txt        (8)
├── host
│   └── fxr
│       └── <fxr version>        (2)
├── sdk
│   ├── <sdk version>            (3)
│   └── NuGetFallbackFolder      (4)
├── packs
│   ├── Microsoft.AspNetCore.App.Ref
│   │   └── <aspnetcore ref version>     (11)
│   ├── Microsoft.NETCore.App.Ref
│   │   └── <netcore ref version>        (12)
│   ├── Microsoft.NETCore.App.Host.<rid>
│   │   └── <apphost version>            (13)
│   ├── Microsoft.WindowsDesktop.App.Ref
│   │   └── <desktop ref version>        (14)
│   └── NETStandard.Library.Ref
│       └── <netstandard version>        (15)
├── shared
│   ├── Microsoft.NETCore.App
│   │   └── <runtime version>     (5)
│   ├── Microsoft.AspNetCore.App
│   │   └── <aspnetcore version>  (6)
│   ├── Microsoft.AspNetCore.All
│   │   └── <aspnetcore version>  (6)
│   └── Microsoft.WindowsDesktop.App
│       └── <desktop app version> (7)
└── templates
│   └── <templates version>      (17)
/
├── etc/dotnet
│       └── install_location     (16)
├── usr/share/man/man1
│       └── dotnet.1.gz          (9)
└── usr/bin
        └── dotnet               (10)

(1) dotnet 主机（也称为“muxer”）有两个不同角色：激活运行时以启动应用程序，及激活 SDK 以向其分派命令。主机是本机可执行文件 (dotnet.exe)。主机只有一个，不过大部分的其他组件都在带有版本的目录中（2、3、5 和 6）。这意味着系统上可存在多个版本，因为它们是并排安装的。
(2) host/fxr/ 包含了主机所使用的框架解析逻辑。主机采用已安装的最新 hostfxr。在执行 .NET Core 应用程序时，hostfxr 负责选择合适的运行时。例如，为 .NET Core 2.0.0 生成的应用程序会使用 2.0.5 运行时（如果可用）。同样，hostfxr 在开发期间也会选择适当的 SDK。
(3) sdk/ SDK（也称为“工具”）是一组托管工具，可用于编写和生成 .NET Core 库和应用程序。SDK 包括 .NET Core 命令行接口 (CLI)、托管的语言编译器、MSBuild 及相关生成任务和目标、NuGet、新项目模板等。
(4) sdk/NuGetFallbackFolder 包含 SDK 在还原操作期间使用的 NuGet 包的缓存，例如在运行 dotnet restore 或 dotnet build /t:Restore 时。此文件夹仅在 .NET Core 3.0 之前使用。不能从源生成它，因为它包含来自 nuget.org 的预构建二进制资产。“共享” 文件夹包含框架。共享框架提供一组位于中心位置的库，从而让不同的应用程序使用。
(5) shared/Microsoft.NETCore.App/ 此框架包含.NET Core 运行时和支持托管库。
(6) shared/Microsoft.AspNetCore.{App,All}/ 包含 ASP.NET Core 库。已开发且支持 Microsoft.AspNetCore.App 下的库（作为 .NET Core 项目的一部分）。Microsoft.AspNetCore.All 下的库是一个超集，其中还包含第三方库。
(7) shared/Microsoft.Desktop.App/ 包含 Windows 桌面库。在非 Windows 平台上不包含此项。
(8) LICENSE.txt,ThirdPartyNotices.txt 分别是 .NET Core 许可证和 .NET Core 中使用的第三方库的许可证。
(9,10) dotnet.1.gz, dotnet dotnet.1.gz 是 dotnet 手册页。dotnet 是指向 dotnet 主机 (1) 的符号链接。这些文件安装在已知位置用于系统集成。
(11,12) Microsoft.NETCore.App.Ref,Microsoft.AspNetCore.App.Ref 分别描述了 x.y 版本 .NET Core 和 ASP.NET Core 的 API。针对这些目标版本进行编译时，将使用这些包。
(13) Microsoft.NETCore.App.Host. 包含平台 rid 的本机二进制文件。将 .NET Core 应用程序编译为适用于该平台的本机二进制文件时，将使用此二进制文件作为模板。
(14) Microsoft.WindowsDesktop.App.Ref 介绍 Windows 桌面应用程序 x.y 版本的 API。在针对该目标进行编译时，将使用这些文件。在非 Windows 平台上不提供此项。
(15) NETStandard.Library.Ref 描述了 netstandard x.y API。在针对该目标进行编译时，将使用这些文件。
(16) /etc/dotnet/install_location 文件包含 dotnet 主机二进制文件所在文件夹的完整路径。可以换行符终止路径。根路径为 /usr/share/dotnet 时无需添加此文件。
(17) templates 包含 SDK 使用的模板。例如，dotnet new 在此处查找项目模板。

生成包Building packages

dotnet/source-build 存储库中说明了如何生成 .NET Core SDK 的源 tarball 及其所有组件。源版本存储库中的输出内容符合本文第一部分中所描述的布局。

.NET Core 分发打包

.NET Core 分发打包.NET Core distribution packaging

本文内容

磁盘布局Disk layout

推荐的包Recommended packages

生成包Building packages