Skip to content

[Infra] Match runtime packages to runtime major version #6327

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Oct 9, 2025
+86 −23
Merged

[Infra] Match runtime packages to runtime major version #6327

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
5a900c5
[Infra] Match runtime packages to runtime version
martincostello Oct 1, 2025
357cf1c
[Infra] Fix W3cTraceContext tests for net8.0
martincostello Oct 1, 2025
2506fb7
[Infra] Update CHANGELOGs
martincostello Oct 8, 2025
a6be22f
Merge branch 'main' into gh-5973
rajkumar-rangaraj Oct 8, 2025
716bc70
Merge branch 'main' into gh-5973
rajkumar-rangaraj Oct 8, 2025
4f12fc8
Merge branch 'main' into gh-5973
rajkumar-rangaraj Oct 9, 2025
9d2c97a
Merge branch 'main' into gh-5973
Kielek Oct 9, 2025
afca81a
Merge branch 'main' into gh-5973
martincostello Oct 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 33 additions & 23 deletions Directory.Packages.props
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,46 @@
</PropertyGroup>

<!--
This section covers packages that are directly referenced by the NuGet packages published from this repository.
Any security vulnerability in these packages or their downstream dependencies will be considered as a security
vulnerability in the NuGet packages that are published from this repository.
For modern .NET runtimes, match the major version of packages to the major version of the runtime.
This is to ensure that the NuGet packages that users deploy match the support lifetimes of the .NET version they are using (i.e. LTS vs STS).
See https://github.com/open-telemetry/opentelemetry-dotnet/issues/5973 for more details.
-->
<ItemGroup>
<!--
Typically, for the Microsoft.Extensions.* packages relating to DI Abstractions, Hosting Abstractions, and Logging,
the latest stable version should be used because:
1) Each major version bump will have some new API capabilities (e.g.For Logging, .NET 6 introduced compile-time logging
source generation, .NET 8 introduced automatic event id generation).
2) Each minor version bump is normally security hotfixes or critical bug fixes.
3) Since version 3.1.0, the .NET runtime team is holding a high bar for backward compatibility on
these packages even during major version bumps, so compatibility is not a concern here.
-->
<!-- Default to latest versions for all TFMs -->
<PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="[9.0.0,)" />
<PackageVersion Include="Microsoft.Extensions.Diagnostics.Abstractions" Version="[9.0.0,)" />
<PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="[9.0.0,)" />
<PackageVersion Include="Microsoft.Extensions.Logging.Configuration" Version="[9.0.0,)" />
</ItemGroup>
<!-- Version overrides for specific netX.0 TFMs -->
<ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
<PackageVersion Update="Microsoft.Extensions.DependencyInjection.Abstractions" Version="[8.0.0,)" />
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This result in a breaking change for net8.0. Customers may be using APIs from these libraries via transitive dependencies. We should consider maintaining this separation starting with net9 and avoid making changes to net8.

Copy link
Member Author

@martincostello martincostello Oct 3, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We always knew that was the case with downgrading the versions for net8.0.

It's easy for users affected by that to manually upgrade their packages manually and get back to a working state. Changing this back would undercut the whole point of the change and the already agreed issue text would need rewriting from scratch.

<PackageVersion Update="Microsoft.Extensions.Diagnostics.Abstractions" Version="[8.0.0,)" />
<PackageVersion Update="Microsoft.Extensions.Hosting.Abstractions" Version="[8.0.0,)" />
<PackageVersion Update="Microsoft.Extensions.Logging.Configuration" Version="[8.0.0,)" />
</ItemGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
<PackageVersion Update="Microsoft.Extensions.DependencyInjection.Abstractions" Version="[9.0.0,)" />
<PackageVersion Update="Microsoft.Extensions.Diagnostics.Abstractions" Version="[9.0.0,)" />
<PackageVersion Update="Microsoft.Extensions.Hosting.Abstractions" Version="[9.0.0,)" />
<PackageVersion Update="Microsoft.Extensions.Logging.Configuration" Version="[9.0.0,)" />
</ItemGroup>

<!--
System.Diagnostics.DiagnosticSource is exempted from the requirement to match the major version of
the runtime so that new APIs and/or semantic conventions are available to all versions of .NET.
See https://github.com/open-telemetry/opentelemetry-dotnet/issues/5973 for more details.
-->
<ItemGroup>
<PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="[9.0.0,)" />
</ItemGroup>

<!--
This section covers packages that are directly referenced by the NuGet packages published from this repository.
Any security vulnerability in these packages or their downstream dependencies will be considered as a security
vulnerability in the NuGet packages that are published from this repository.
-->
<ItemGroup>
<!--
OTel packages always point to latest stable release.
-->
Expand All @@ -35,17 +56,6 @@
<PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="[$(OTelLatestStableVer),2.0)" />
<PackageVersion Include="OpenTelemetry.Extensions.Propagators" Version="[$(OTelLatestStableVer),2.0)" />
<PackageVersion Include="OpenTracing" Version="[0.12.1,0.13)" />

<!--
Typically, the latest stable version of System.Diagnostics.DiagnosticSource should be used here because:
1) Each major version bump will likely have some new OpenTelemetry capabilities (e.g. .NET 6 introduced Meter
API, .NET 7 added UpDownCounter, .NET 8 added Meter/Instrument level attributes support, .NET 9 added
Advice/Hint API, etc.).
2) Each minor version bump is normally security hotfixes or critical bug fixes.
3) The .NET runtime team provides extra backward compatibility guarantee to System.Diagnostics.DiagnosticSource
even during major version bumps, so compatibility is not a concern here.
-->
<PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="[9.0.0,)" />
</ItemGroup>

<ItemGroup>
Expand Down
4 changes: 4 additions & 0 deletions src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions` NuGet package.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry.Exporter.Console/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
5 changes: 5 additions & 0 deletions ...emetry.Exporter.OpenTelemetryProtocol/OpenTelemetry.Exporter.OpenTelemetryProtocol.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,11 @@
<AllowUnsafeBlocks Condition="'$(TargetFramework)' == 'netstandard2.0' OR '$(TargetFramework)' == '$(NetFrameworkMinimumSupportedVersion)'">true</AllowUnsafeBlocks>
</PropertyGroup>

<!-- This package is explicitly upgraded for .NET 8 to fix native AoT compatibility issues -->
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.Configuration.Binder" VersionOverride="8.0.2" Condition="'$(TargetFramework)' == 'net8.0'" />
</ItemGroup>

<ItemGroup>
<ProjectReference Include="$(RepoRoot)\src\OpenTelemetry\OpenTelemetry.csproj" />
</ItemGroup>
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry.Exporter.Prometheus.AspNetCore/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.0-beta.1

Released 2025-Oct-01
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry.Exporter.Prometheus.HttpListener/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.0-beta.1

Released 2025-Oct-01
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
7 changes: 7 additions & 0 deletions src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions`,
`Microsoft.Extensions.Hosting.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
6 changes: 6 additions & 0 deletions src/OpenTelemetry/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ Notes](../../RELEASENOTES.md).

## Unreleased

* **Breaking Change** When targeting `net8.0`, the package now depends on version
`8.0.0` of the `Microsoft.Extensions.DependencyInjection.Abstractions`,
`Microsoft.Extensions.Diagnostics.Abstractions` and
`Microsoft.Extensions.Logging.Configuration` NuGet packages.
([#6327](https://github.com/open-telemetry/opentelemetry-dotnet/pull/6327))

## 1.13.1

Released 2025-Oct-09
Expand Down
1 change: 1 addition & 0 deletions ...entation.W3cTraceContext.Tests/OpenTelemetry.Instrumentation.W3cTraceContext.Tests.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" VersionOverride="9.0.9" />
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://github.com/open-telemetry/opentelemetry-dotnet-contrib/pull/3152/files#r2393955038

<PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" />
</ItemGroup>

Expand Down
Loading