opentelemetry-cpp/tools/nuget/README.md

2.0 KiB

NuGet package creation process

This directory contains NuGet specification files (.nuspec).

Creating nuget packages:

  1. Set PackageVersion environment variable that defines the package version.
set PackageVersion=0.2.0

If environment variable is not set, then the version is automatically obtained from git tag:

git describe --tags
  1. Run tools/build-nuget.cmd script to create the package(s). Packages are copied to .\packages directory.

  2. Push selected package to nuget feed.

Learn more about native code NuGet packages here.

Proposed NuGet package flavors

This section is a DRAFT - Work-in-Progress. The following packages MAY be created and published at nuget.org :

Package Name Desription Notes
OpenTelemetry.Cpp.Source Complete recursive source code snapshot with dependencies.
OpenTelemetry.Cpp.Dev Source code snapshot excluding 3rd party dependencies.
OpenTelemetry.Cpp.Api API headers package.
OpenTelemetry.Cpp.Sdk SDK headers and source package.
OpenTelemetry.Cpp.Ext Extended functionality.
OpenTelemetry.Cpp.Exporters Exporters.

Prebuilt libraries MAY be provided in future in OpenTelemetry.Cpp.${CompilerABI} package for each compiler.

Refer to Boost library nuget packages for example how to create a nuget package for a given compiler and runtime, using Fuget Package Explorer that allows to see the original nuget spec for each package.