NuGet.Packaging 6.12.1

Prefix Reserved
dotnet add package NuGet.Packaging --version 6.12.1                
NuGet\Install-Package NuGet.Packaging -Version 6.12.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NuGet.Packaging" Version="6.12.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NuGet.Packaging --version 6.12.1                
#r "nuget: NuGet.Packaging, 6.12.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NuGet.Packaging as a Cake Addin
#addin nuget:?package=NuGet.Packaging&version=6.12.1

// Install NuGet.Packaging as a Cake Tool
#tool nuget:?package=NuGet.Packaging&version=6.12.1                

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.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (117)

Showing the top 5 NuGet packages that depend on NuGet.Packaging:

Package Downloads
Microsoft.VisualStudio.Web.CodeGenerators.Mvc

Code Generators for ASP.NET Core MVC. Contains code generators for MVC Controllers and Views.

Microsoft.VisualStudio.Web.CodeGeneration.Design

Code Generation tool for ASP.NET Core. Contains the dotnet-aspnet-codegenerator command used for generating controllers and views.

Microsoft.VisualStudio.Web.CodeGeneration

Contains the CodeGenCommand that finds the appropriate code generator and invokes it from project dependencies.

Microsoft.VisualStudio.Web.CodeGeneration.EntityFrameworkCore

Contains Entity Framework Core Services used by ASP.NET Core Code Generators.

Microsoft.VisualStudio.Web.CodeGeneration.Core

Contains the core infrastructure used by ASP.NET Core Code Generators.

GitHub repositories (62)

Showing the top 5 popular GitHub repositories that depend on NuGet.Packaging:

Repository Stars
dotnet/aspnetcore
ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
DevToys-app/DevToys
A Swiss Army knife for developers.
dotnet/runtime
.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.
MonoGame/MonoGame
One framework for creating powerful cross-platform games.
unoplatform/uno
Open-source platform for building cross-platform native Mobile, Web, Desktop and Embedded apps quickly. Create rich, C#/XAML, single-codebase apps from any IDE. Hot Reload included! 90m+ NuGet Downloads!!
Version Downloads Last updated
6.12.1 90,462 11/12/2024
6.12.0 851 11/12/2024
6.11.1 388,179 10/1/2024
6.11.0 1,799,000 8/13/2024
6.11.0-preview.2 2,888 6/5/2024
6.10.2 12,505 8/12/2024
6.10.1 531,632 6/27/2024
6.10.0 404,766 5/21/2024
6.9.1 6,933,784 2/13/2024
6.8.1 114,039 2/13/2024
6.8.0 1,211,281 11/17/2023 6.8.0 has at least one vulnerability with critical severity.
6.7.1 152,453 2/14/2024
6.7.0 2,818,451 8/9/2023 6.7.0 has at least one vulnerability with critical severity.
6.6.2 111,815 2/13/2024
6.6.1 6,689,966 6/13/2023 6.6.1 has at least one vulnerability with critical severity.
6.6.0 124,085 5/17/2023 6.6.0 has at least one vulnerability with critical severity.
6.6.0-preview.3 914 5/17/2023
6.5.1 142,721 6/13/2023
6.5.0 431,667 2/22/2023
6.4.3 32,811 2/13/2024
6.4.2 156,175 6/13/2023 6.4.2 has at least one vulnerability with critical severity.
6.4.0 998,697 11/9/2022 6.4.0 has at least one vulnerability with critical severity.
6.3.4 436,308 2/13/2024
6.3.3 197,350 6/14/2023 6.3.3 has at least one vulnerability with critical severity.
6.3.1 16,118,540 10/11/2022 6.3.1 has at least one vulnerability with critical severity.
6.2.4 64,033 6/14/2023
6.2.2 60,824 10/11/2022
6.1.0 672,627 2/16/2022
6.0.6 15,502 2/13/2024
6.0.5 101,174 6/13/2023 6.0.5 has at least one vulnerability with critical severity.
6.0.3-rc.1 910 10/11/2022 6.0.3-rc.1 has at least one vulnerability with critical severity.
6.0.2 16,239 6/14/2022 6.0.2 has at least one vulnerability with critical severity.
5.11.6 256,031 2/13/2024
5.11.5 3,049,527 6/15/2023 5.11.5 has at least one vulnerability with critical severity.
5.11.3 315,260 10/11/2022 5.11.3 has at least one vulnerability with critical severity.
5.10.0 3,896,638 6/15/2021 5.10.0 is deprecated because it is no longer maintained; 5.10.0 has at least one vulnerability with critical severity.
5.9.3 126,169 10/11/2022 5.9.3 is deprecated because it is no longer maintained; 5.9.3 has at least one vulnerability with critical severity.
5.8.1 226,171 1/16/2021 5.8.1 is deprecated because it is no longer maintained; 5.8.1 has at least one vulnerability with critical severity.
5.7.3-rtm.5 646 10/11/2022 5.7.3-rtm.5 is deprecated because it is no longer maintained; 5.7.3-rtm.5 has at least one vulnerability with critical severity.
5.7.2 9,924 6/14/2022 5.7.2 is deprecated because it is no longer maintained; 5.7.2 has at least one vulnerability with critical severity.
5.6.0 4,690,598 5/20/2020 5.6.0 is deprecated because it is no longer maintained; 5.6.0 has at least one vulnerability with critical severity.
5.5.1 1,424,844 4/3/2020 5.5.1 is deprecated because it is no longer maintained; 5.5.1 has at least one vulnerability with critical severity.
5.4.0 617,099 12/3/2019 5.4.0 is deprecated because it is no longer maintained; 5.4.0 has at least one vulnerability with critical severity.
5.3.1 6,775,128 10/25/2019 5.3.1 is deprecated because it is no longer maintained; 5.3.1 has at least one vulnerability with critical severity.
5.2.1 716 6/14/2022 5.2.1 is deprecated because it is no longer maintained; 5.2.1 has at least one vulnerability with critical severity.
5.1.0 258,369 5/21/2019 5.1.0 is deprecated because it is no longer maintained; 5.1.0 has at least one vulnerability with critical severity.
5.0.2 35,085 5/14/2019 5.0.2 is deprecated because it is no longer maintained; 5.0.2 has at least one vulnerability with critical severity.
4.9.6 8,295 10/11/2022 4.9.6 is deprecated because it is no longer maintained; 4.9.6 has at least one vulnerability with critical severity.
4.8.2 38,007 3/12/2019 4.8.2 is deprecated because it is no longer maintained; 4.8.2 has at least one vulnerability with critical severity.
4.7.3 1,227 3/15/2019 4.7.3 is deprecated because it is no longer maintained; 4.7.3 has at least one vulnerability with critical severity.
4.6.4 17,534 3/15/2019 4.6.4 is deprecated because it is no longer maintained; 4.6.4 has at least one vulnerability with critical severity.
4.5.3 22,912 3/15/2019 4.5.3 is deprecated because it is no longer maintained.
4.4.3 1,073 3/15/2019 4.4.3 is deprecated because it is no longer maintained.
4.3.1 18,244 3/12/2019 4.3.1 is deprecated because it is no longer maintained.
4.2.0 806,056 7/14/2017 4.2.0 is deprecated because it is no longer maintained.
4.1.0 11,545 7/14/2017 4.1.0 is deprecated because it is no longer maintained.
4.0.0 221,747 3/7/2017 4.0.0 is deprecated because it is no longer maintained.
3.5.0 501,314 12/14/2016 3.5.0 is deprecated because it is no longer maintained.
3.4.4-rtm-final 4,193 6/3/2016 3.4.4-rtm-final is deprecated because it is no longer maintained.
3.4.3 18,538 4/22/2016 3.4.3 is deprecated because it is no longer maintained.
3.3.0 142,907 12/1/2015 3.3.0 is deprecated because it is no longer maintained.
3.2.0 27,683 9/16/2015 3.2.0 is deprecated because it is no longer maintained.