diff --git a/docs/core/distribution-packaging.md b/docs/core/distribution-packaging.md index f2c71c4297db0..60b948e98dc8a 100644 --- a/docs/core/distribution-packaging.md +++ b/docs/core/distribution-packaging.md @@ -2,7 +2,7 @@ title: .NET distribution packaging description: Learn how to package, name, and version .NET for distribution. author: tmds -ms.date: 10/09/2019 +ms.date: 12/01/2021 --- # .NET distribution packaging @@ -24,8 +24,14 @@ When installed, .NET consists of several components that are laid out as follows │ └── fxr (*) │ └── (2) ├── sdk (*) -│ ├── (3) -│ └── NuGetFallbackFolder (4) (*) +│ └── (3) +├── sdk-manifests (4) (*) +│ └── +├── library-packs (4) (*) +├── metadata (4) (*) +│ └── workloads +│ └── +├── template-packs (4) (*) ├── packs (*) │ ├── Microsoft.AspNetCore.App.Ref (*) │ │ └── (11) @@ -65,7 +71,7 @@ While there's a single host, most of the other components are in versioned direc - (3) **sdk/\** The SDK (also known as "the tooling") is a set of managed tools that are used to write and build .NET libraries and applications. The SDK includes the .NET CLI, the managed languages compilers, MSBuild, and associated build tasks and targets, NuGet, new project templates, and so on. -- (4) **sdk/NuGetFallbackFolder** contains a cache of NuGet packages used by an SDK during the restore operation, such as when running `dotnet restore` or `dotnet build`. This folder is only used prior to .NET Core 3.0. It can't be built from source, because it contains prebuilt binary assets from `nuget.org`. +- (4) **sdk-manifests/\** The names and versions of the assets that an optional workload installation requires are maintained in workload manifests stored in this folder. The folder name is the feature band version of the SDK. So for an SDK version such as 6.0.102, this folder would still be named 6.0.100. When a workload is installed, the following folders are created as needed for the workload's assets: *library-packs*, *metadata*, and *template-packs*. A distribution can create an empty */metadata/workloads/\/userlocal* file if workloads should be installed under a user path rather than in the *dotnet* folder. For more information, see GitHub issue [dotnet/installer#12104](https://github.com/dotnet/installer/issues/12104). The **shared** folder contains frameworks. A shared framework provides a set of libraries at a central location so they can be used by different applications.