NuGet.Packaging 6.14.0

Nuget.Packaging

NuGet.Packaging is a NuGet client SDK library that provides a set of APIs to interact with .nupkg and .nuspec files from a stream. It provides a way for developers to create and read packages and work with the package metadata.

Usage

It is strongly recommended that NuGet packages are created using the official NuGet tooling and instead of this low-level API. There are a variety of characteristics important for a well-formed package and the latest version of tooling helps incorporate these best practices.

For more information about creating NuGet packages, see the overview of the package creation workflow and the documentation for official pack tooling (for example, using the dotnet CLI).

Examples

Create a package

Create a package, set metadata, and add dependencies.

PackageBuilder builder = new PackageBuilder();
builder.Id = "MyPackage";
builder.Version = new NuGetVersion("1.0.0-beta");
builder.Description = "My package created from the API.";
builder.Authors.Add("Sample author");
builder.DependencyGroups.Add(new PackageDependencyGroup(
    targetFramework: NuGetFramework.Parse("netstandard1.4"),
    packages: new[]
    {
        new PackageDependency("Newtonsoft.Json", VersionRange.Parse("10.0.1"))
    }));

using FileStream outputStream = new FileStream("MyPackage.nupkg", FileMode.Create);
builder.Save(outputStream);
Console.WriteLine($"Saved a package to {outputStream.Name}");

Read a package

Read a package from a file.

using FileStream inputStream = new FileStream("MyPackage.nupkg", FileMode.Open);
using PackageArchiveReader reader = new PackageArchiveReader(inputStream);
NuspecReader nuspec = reader.NuspecReader;
Console.WriteLine($"ID: {nuspec.GetId()}");
Console.WriteLine($"Version: {nuspec.GetVersion()}");
Console.WriteLine($"Description: {nuspec.GetDescription()}");
Console.WriteLine($"Authors: {nuspec.GetAuthors()}");

Console.WriteLine("Dependencies:");
foreach (PackageDependencyGroup dependencyGroup in nuspec.GetDependencyGroups())
{
    Console.WriteLine($" - {dependencyGroup.TargetFramework.GetShortFolderName()}");
    foreach (var dependency in dependencyGroup.Packages)
    {
        Console.WriteLine($"   > {dependency.Id} {dependency.VersionRange}");
    }
}

Additional documentation

More information about the NuGet.Packaging library can be found on the official Microsoft documentation page and NuGet API docs.

Showing the top 20 packages that depend on NuGet.Packaging.

Packages Downloads
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
94
Microsoft.DotNet.Cli.Utils
Package Description
86
Microsoft.DotNet.Cli.Utils
Package Description
85
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
81
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
77
Microsoft.DotNet.Cli.Utils
Package Description
76
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
76
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
75
Microsoft.DotNet.Cli.Utils
Package Description
75
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
73
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
73
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
72
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
70
NuGet.Protocol.Core.Types
NuGet's protocol-level base types used for connecting to API v2 and API v3 repositories.
70
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
70
Microsoft.DotNet.Cli.Utils
Package Description
70
Microsoft.DotNet.Cli.Utils
Package Description
69
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
69
NuGet.Protocol
NuGet client library.
69

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
6.14.0 8 5/15/2025
6.13.2 25 2/28/2025
6.13.1 34 2/14/2025
6.12.4 10 5/9/2025
6.12.1 30 11/17/2024
6.12.0 22 11/19/2024
6.11.1 32 10/6/2024
6.11.0 30 8/15/2024
6.11.0-preview.2 31 6/5/2024
6.10.2 29 8/15/2024
6.10.1 34 6/28/2024
6.10.0 28 6/5/2024
6.9.1 38 2/23/2024
6.8.1 37 2/21/2024
6.8.0 39 11/18/2023
6.7.1 39 2/23/2024
6.7.0 67 8/18/2023
6.6.2 35 2/23/2024
6.6.1 69 7/30/2023
6.6.0 42 5/20/2023
6.6.0-preview.3 41 5/20/2023
6.5.1 43 7/21/2023
6.5.0 42 2/24/2023
6.4.3 34 2/21/2024
6.4.2 70 8/4/2023
6.4.0 50 12/6/2022
6.3.4 38 2/23/2024
6.3.3 44 8/4/2023
6.3.1 51 11/14/2022
6.3.0 56 9/17/2022
6.2.4 44 8/4/2023
6.2.2 42 11/16/2022
6.2.1 52 6/30/2022
6.2.0 49 6/30/2022
6.1.0 49 6/30/2022
6.0.6 38 2/23/2024
6.0.5 43 8/4/2023
6.0.3-rc.1 48 11/25/2022
6.0.2 70 6/30/2022
6.0.0 50 6/30/2022
6.0.0-preview.4.243 59 6/30/2022
6.0.0-preview.3 47 6/30/2022
5.11.6 39 2/23/2024
5.11.5 40 8/1/2023
5.11.3 72 10/13/2022
5.11.2 63 6/30/2022
5.11.0 50 6/30/2022
5.10.0 70 6/30/2022
5.10.0-preview.2.7185 44 6/30/2022
5.9.3 57 11/25/2022
5.9.2 61 6/30/2022
5.9.1 65 6/30/2022
5.9.0 57 6/30/2022
5.9.0-preview.2 46 6/30/2022
5.8.1 47 6/30/2022
5.8.0 65 6/30/2022
5.8.0-preview.3.6823 45 6/30/2022
5.8.0-preview.2.6776 43 6/30/2022
5.8.0-preview.1 81 6/30/2022
5.7.3-rtm.5 51 12/7/2022
5.7.2 51 6/30/2022
5.7.1 44 6/30/2022
5.7.0 44 6/30/2022
5.7.0-rtm.6702 52 6/30/2022
5.7.0-preview.3.6653 66 6/30/2022
5.7.0-preview.2.6618 50 6/30/2022
5.7.0-preview.1.6592 51 6/30/2022
5.6.0 57 6/30/2022
5.6.0-preview.3.6558 62 6/30/2022
5.6.0-preview.2.6489 61 6/30/2022
5.6.0-preview.1.6483 51 6/30/2022
5.5.1 42 6/30/2022
5.5.0 51 6/30/2022
5.5.0-preview.2.6382 69 6/30/2022
5.5.0-preview.1.6319 51 6/30/2022
5.4.0 47 6/30/2022
5.3.1 66 6/30/2022
5.3.0 47 6/30/2022
5.3.0-rtm.6192 61 6/30/2022
5.2.1 51 6/30/2022
5.2.0 63 6/30/2022
5.1.0 67 6/30/2022
5.1.0-preview2.5965 48 6/30/2022
5.0.2 73 6/30/2022
5.0.0 55 6/30/2022
5.0.0-rtm.5867 48 6/30/2022
5.0.0-rtm.5856 47 6/30/2022
5.0.0-preview3.5800 55 6/30/2022
5.0.0-preview2.5782 47 6/30/2022
4.9.6 90 10/13/2022
4.9.5 47 6/30/2022
4.9.4 67 6/30/2022
4.9.3 69 6/30/2022
4.9.2 51 6/30/2022
4.9.2-rtm.5706 55 6/30/2022
4.9.1 44 6/30/2022
4.9.0-rtm.5658 49 6/30/2022
4.8.2 51 6/30/2022
4.8.0 76 6/30/2022
4.8.0-rtm.5362 53 6/30/2022
4.8.0-preview3.5278 59 6/30/2022
4.8.0-preview1.5156 47 6/30/2022
4.7.3 60 6/30/2022
4.7.2 47 6/30/2022
4.7.0 68 6/30/2022
4.7.0-rtm.5148 43 6/30/2022
4.7.0-rtm.5104 57 6/30/2022
4.7.0-preview4.5065 49 6/30/2022
4.7.0-preview1-4986 45 6/30/2022
4.6.4 55 6/30/2022
4.6.3 45 6/30/2022
4.6.2 44 6/30/2022
4.6.1 77 6/30/2022
4.6.0 60 6/30/2022
4.6.0-rtm-4918 39 6/30/2022
4.6.0-rtm-4825 46 6/30/2022
4.6.0-rtm-4791 56 6/30/2022
4.5.3 72 6/30/2022
4.5.2 38 6/30/2022
4.5.0 73 6/30/2022
4.5.0-rtm-4651 41 6/30/2022
4.4.3 45 6/30/2022
4.4.2 49 6/30/2022
4.4.0 49 6/30/2022
4.4.0-preview3-4475 86 6/30/2022
4.3.1 87 6/30/2022
4.3.0 83 6/30/2022
4.3.0-rtm-4324 48 6/30/2022
4.3.0-preview4 44 6/30/2022
4.3.0-preview3-4168 44 6/30/2022
4.3.0-beta1-2418 79 6/30/2022
4.2.0 41 6/30/2022
4.1.0 43 6/30/2022
4.0.0 40 6/30/2022
4.0.0-rtm-2283 52 6/30/2022
4.0.0-rtm-2265 51 6/30/2022
4.0.0-rc3 60 6/30/2022
4.0.0-rc2 70 6/30/2022
4.0.0-rc-2048 50 6/30/2022
3.5.0 45 6/30/2022
3.5.0-rc1-final 47 6/30/2022
3.5.0-beta2-1484 48 6/30/2022
3.5.0-beta-final 57 6/30/2022
3.4.4-rtm-final 51 6/30/2022
3.4.4-rc 59 6/30/2022
3.4.3 48 6/29/2022
3.3.0 59 6/29/2022
3.2.0 44 6/29/2022
1.0.0-pre-20150220044603 66 6/29/2022
1.0.0-pre-20150128082032 47 6/29/2022
1.0.0-pre-20150128071326 47 6/29/2022
1.0.0-pre-20150127085617 58 6/29/2022
1.0.0-pre-20150127072405 50 6/29/2022
1.0.0-pre-20150120213149 68 6/29/2022
1.0.0-pre-20150120004808 48 6/29/2022
1.0.0-pre-20150115030027 69 6/29/2022
1.0.0-pre-20150109221036 81 6/29/2022
1.0.0-pre-20150108074227 48 6/29/2022
1.0.0-pre-20150108073125 63 6/29/2022
1.0.0-pre-20150108010629 53 6/29/2022
1.0.0-master-50072333 52 6/29/2022
1.0.0-master-50060114 44 6/29/2022
1.0.0-master-50050213 55 6/29/2022
1.0.0-master-43652058 44 6/29/2022
1.0.0-master-43642026 53 6/29/2022
1.0.0-master-43522145 50 6/29/2022
1.0.0-master-43500148 49 6/29/2022
1.0.0-master-43450313 45 6/29/2022
1.0.0-master-43440912 46 6/29/2022
1.0.0-master-43422320 48 6/29/2022
1.0.0-master-43421050 69 6/29/2022
1.0.0-master-43421019 49 6/29/2022
1.0.0-master-43402220 53 6/29/2022
1.0.0-master-43362332 52 6/29/2022
1.0.0-master-43362323 52 6/29/2022
1.0.0-master-43250244 51 6/29/2022
1.0.0-master-43250241 64 6/29/2022
1.0.0-master-43250237 48 6/29/2022
1.0.0-master-43250218 76 6/29/2022
1.0.0-juste-43290204 70 6/29/2022