views 多个文件夹 netcore_.NET Core 分发打包

67e5e8bda17e95da895c59b4760bf4c2.png

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

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

磁盘布局

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

复制

{dotnet_root}                                     (*)├── dotnet                       (1)├── LICENSE.txt                  (8)├── ThirdPartyNotices.txt        (8)├── host                                          (*)│   └── fxr                                       (*)│       └──         (2)├── sdk                                           (*)│   ├──             (3)│   └── NuGetFallbackFolder      (4)              (*)├── packs                                         (*)│   ├── Microsoft.AspNetCore.App.Ref              (*)│   │   └──      (11)│   ├── Microsoft.NETCore.App.Ref                 (*)│   │   └──         (12)│   ├── Microsoft.NETCore.App.Host.          (*)│   │   └──             (13)│   ├── Microsoft.WindowsDesktop.App.Ref          (*)│   │   └──         (14)│   └── NETStandard.Library.Ref                   (*)│       └──         (15)├── shared                                        (*)│   ├── Microsoft.NETCore.App                     (*)│   │   └──      (5)│   ├── Microsoft.AspNetCore.App                  (*)│   │   └──   (6)│   ├── Microsoft.AspNetCore.All                  (*)│   │   └──   (6)│   └── Microsoft.WindowsDesktop.App              (*)│       └──  (7)└── templates                                     (*)│   └──       (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 时。 此文件夹仅在 .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_root} 完整路径的文件 。 该路径可能以换行符结尾。 根路径为 /usr/share/dotnet 时无需添加此文件。
  • (17) templates 包含 SDK 使用的模板。 例如,dotnet new 在此处查找项目模板。

标记为 (*) 的文件夹被多个包使用。 某些包格式(例如,rpm)需要对此类文件夹进行特殊处理。 包维护人员必须处理这个问题。

推荐的包

.NET Core 版本控制基于运行时组件 [major].[minor] 版本号。 SDK 版本采用相同的 [major].[minor],并有一个独立的 [patch],它为 SDK 合并了功能和修补语义。 例如:SDK 版本 2.2.302 是支持 2.2 运行时的 SDK 的第 3 个功能版本的第 2 个补丁版本。 有关版本控制的工作原理的详细信息,请参阅 .NET Core 版本控制概述。

一些包在自己的名称中就包含一部分版本号。 这允许你安装特定版本。 版本名称中不包含版本的剩余部分。 这允许 OS 包管理器更新这些包(例如,自动安装安全修补程序)。 支持的包管理器特定于 Linux。

下面列出了推荐的包:

  • dotnet-sdk-[major].[minor] - 安装特定运行时的最新 SDK版本: 示例: dotnet-sdk-2.1包含: (3),(4)依赖项: dotnet-runtime-[major].[minor]、aspnetcore-runtime-[major].[minor]、dotnet-targeting-pack-[major].[minor]、aspnetcore-targeting-pack-[major].[minor]、netstandard-targeting-pack-[netstandard_major].[netstandard_minor]、dotnet-apphost-pack-[major].[minor]、dotnet-templates-[major].[minor]
  • aspnetcore-runtime-[major].[minor] - 安装特定 ASP.NET Core 运行时版本: 示例: aspnetcore-runtime-2.1包含: (6)依赖项: dotnet-runtime-[major].[minor]
  • dotnet-runtime-deps-[major].[minor] (可选) - 安装运行自包含应用程序的依赖项版本: 示例: dotnet-runtime-deps-2.1依赖项: 特定于分发的依赖项
  • dotnet-runtime-[major].[minor] - 安装特定运行时版本: 示例: dotnet-runtime-2.1包含: (5)依赖项: dotnet-hostfxr-[major].[minor]、dotnet-runtime-deps-[major].[minor]
  • dotnet-hostfxr-[major].[minor] - 依赖项版本: 示例: dotnet-hostfxr-3.0包含: (2)依赖项: dotnet-host
  • dotnet-host - 依赖项版本: 示例: dotnet-host包含: (1),(8),(9),(10),(16)
  • dotnet-apphost-pack-[major].[minor] - 依赖项版本: 包含: (13)
  • dotnet-targeting-pack-[major].[minor] - 允许面向非最新的运行时版本: 包含: (12)
  • aspnetcore-targeting-pack-[major].[minor] - 允许面向非最新的运行时版本: 包含: (11)
  • netstandard-targeting-pack-[netstandard_major].[netstandard_minor] - 允许面向 netstandard 版本版本: 包含: (15)
  • dotnet-templates-[major].[minor]版本: 包含: (15)

dotnet-runtime-deps-[major].[minor] 需要了解发行版特定依赖项 。 因为发行版生成系统可能能够自动派生包,所以包是可选的,如果选择,会将这些依赖项直接添加到 dotnet-runtime-[major].[minor] 包中。

当包内容位于受版本控制的文件夹下时,包名称 [major].[minor] 与受版本控制的文件夹名称匹配。 对于所有包(除 netstandard-targeting-pack-[netstandard_major].[netstandard_minor] 外),这也与 .NET Core 版本匹配。

包间的依赖关系应使用“等于或大于”版本要求 。 例如,dotnet-sdk-2.2:2.2.401 要求 aspnetcore-runtime-2.2 >= 2.2.6。 这使用户可以通过根包(例如 dnf update dotnet-sdk-2.2)升级其安装。

大多数分发都需要从源中构建所有项目。 这对包有一些影响:

  • 不能简单地从源生成 shared/Microsoft.AspNetCore.All 下的第三方库。 因此 aspnetcore-runtime 包中省略了该文件夹。
  • 使用 nuget.org 中的二进制项目填充了 NuGetFallbackFolder。 它应保留为空。

多个 dotnet-sdk 包可能会为 NuGetFallbackFolder 提供同样的文件。 若要避免包管理器出现问题,这些文件应完全相同(包括校验和、修改日期等等)。

生成包

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值