From 7b797403d27a8036c149a22369a59ebdb65cc812 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 5 Oct 2023 10:16:47 -0700 Subject: [PATCH 1/3] todatetime breaking change --- docs/core/compatibility/8.0.md | 3 +- .../extensions/8.0/dmtf-todatetime.md | 36 +++++++++++++++++++ docs/core/compatibility/toc.yml | 4 +++ 3 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 docs/core/compatibility/extensions/8.0/dmtf-todatetime.md diff --git a/docs/core/compatibility/8.0.md b/docs/core/compatibility/8.0.md index 30cd65de21b27..db556e7a31144 100644 --- a/docs/core/compatibility/8.0.md +++ b/docs/core/compatibility/8.0.md @@ -2,7 +2,7 @@ title: Breaking changes in .NET 8 titleSuffix: "" description: Navigate to the breaking changes in .NET 8. -ms.date: 09/13/2023 +ms.date: 10/05/2023 no-loc: [Blazor, Razor, Kestrel] --- # Breaking changes in .NET 8 @@ -87,6 +87,7 @@ If you're migrating an app to .NET 8, the breaking changes listed here might aff | [DirectoryServices package no longer references System.Security.Permissions](extensions/8.0/configurationmanager-package.md) | Source incompatible | Preview 3 | | [Empty keys added to dictionary by configuration binder](extensions/8.0/dictionary-configuration-binding.md) | Behavioral change | Preview 5 | | [HostApplicationBuilderSettings.Args respected by HostApplicationBuilder ctor](extensions/8.0/hostapplicationbuilder-ctor.md) | Behavioral change | Preview 2 | +| [ManagementDateTimeConverter.ToDateTime returns a local time](extensions/8.0/dmtf-todatetime.md) | Behavioral change | RC 1 | ## Globalization diff --git a/docs/core/compatibility/extensions/8.0/dmtf-todatetime.md b/docs/core/compatibility/extensions/8.0/dmtf-todatetime.md new file mode 100644 index 0000000000000..88f02ffccf55c --- /dev/null +++ b/docs/core/compatibility/extensions/8.0/dmtf-todatetime.md @@ -0,0 +1,36 @@ +--- +title: "Breaking change: ManagementDateTimeConverter.ToDateTime returns a local time" +description: Learn about the .NET 8 breaking change in .NET extensions where the DateTime returned by ManagementDateTimeConverter.ToDateTime is based on local time. +ms.date: 10/05/2023 +--- +# ManagementDateTimeConverter.ToDateTime returns a local time + +The value returned by is now based on the local time zone. + +## Version introduced + +.NET 8 RC 1 + +## Previous behavior + +Previously, returned a value whose value was . + +## New behavior + +Starting in .NET 8, returns a value whose value was . + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change was made so that the code matched what the documentation said it did. + +## Recommended action + +If your code expected the returned value to be based on an unspecified time zone, update it to expect a value that's based on the local time zone. + +## Affected APIs + +- diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index 35292f39741f4..d2495e89d0408 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -100,6 +100,8 @@ items: href: extensions/8.0/dictionary-configuration-binding.md - name: HostApplicationBuilderSettings.Args respected by constructor href: extensions/8.0/hostapplicationbuilder-ctor.md + - name: ManagementDateTimeConverter.ToDateTime returns a local time + href: extensions/8.0/dmtf-todatetime.md - name: Globalization items: - name: Date and time converters honor culture argument @@ -1348,6 +1350,8 @@ items: href: extensions/8.0/dictionary-configuration-binding.md - name: HostApplicationBuilderSettings.Args respected by constructor href: extensions/8.0/hostapplicationbuilder-ctor.md + - name: ManagementDateTimeConverter.ToDateTime returns a local time + href: extensions/8.0/dmtf-todatetime.md - name: .NET 7 items: - name: Binding config to dictionary extends values From a0b52f9be58a3d54409f95c98f5221c836d86d1b Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 5 Oct 2023 13:18:27 -0700 Subject: [PATCH 2/3] --arch option --- docs/core/compatibility/8.0.md | 1 + .../core/compatibility/sdk/8.0/arch-option.md | 36 +++++++++++++++++++ .../sdk/8.0/runtimespecific-app-default.md | 2 +- docs/core/compatibility/toc.yml | 4 +++ 4 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 docs/core/compatibility/sdk/8.0/arch-option.md diff --git a/docs/core/compatibility/8.0.md b/docs/core/compatibility/8.0.md index db556e7a31144..c4530d161c78f 100644 --- a/docs/core/compatibility/8.0.md +++ b/docs/core/compatibility/8.0.md @@ -123,6 +123,7 @@ If you're migrating an app to .NET 8, the breaking changes listed here might aff | [MSBuild custom derived build events deprecated](sdk/8.0/custombuildeventargs.md) | Behavioral change | RC 1 | | [MSBuild respects DOTNET_CLI_UI_LANGUAGE](sdk/8.0/msbuild-language.md) | Behavioral change | Preview 5 | | [Runtime-specific apps not self-contained](sdk/8.0/runtimespecific-app-default.md) | Source/binary incompatible | Preview 5 | +| [--arch option doesn't imply self-contained](sdk/8.0/arch-option.md) | Behavioral change | RC 2 | | ['dotnet restore' produces security vulnerability warnings](sdk/8.0/dotnet-restore-audit.md) | Behavioral change | Preview 4 | | [SDK uses a smaller RID graph](sdk/8.0/rid-graph.md) | Behavioral change/Source incompatible | RC 1 | | [Trimming may not be used with .NET Standard or .NET Framework](sdk/8.0/trimming-unsupported-targetframework.md) | Behavioral change | RC 1 | diff --git a/docs/core/compatibility/sdk/8.0/arch-option.md b/docs/core/compatibility/sdk/8.0/arch-option.md new file mode 100644 index 0000000000000..227b4d0b533d2 --- /dev/null +++ b/docs/core/compatibility/sdk/8.0/arch-option.md @@ -0,0 +1,36 @@ +--- +title: "Breaking change: Architecture option doesn't imply self-contained" +description: Learn about a breaking change in the .NET 8 SDK where the `--arch` option no longer implies that an app is self-contained. +ms.date: 10/05/2023 +--- +# --arch option doesn't imply self-contained + +Up until now, the `--arch` option for `dotnet` CLI commands such as [dotnet publish](../../../tools/dotnet-publish.md) implied that the app was [self-contained](../../../deploying/index.md#publish-self-contained). The behavior of the `--arch` option has now been changed to match that of the `--runtime option`, and it no longer implies that an app is self-contained. + +## Previous behavior + +`--arch` implied `--self-contained`. + +## New behavior + +`--arch` doesn't imply anything about `--self-contained`. + +## Version introduced + +.NET 8 RC 2 + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change was made to unify the behavior of `--arch` with that of `--runtime`, which it's an alias for. The [behavior for `--runtime` was changed](runtimespecific-app-default.md) in an earlier preview version of .NET 8. + +## Recommended action + +If your application needs to be self contained, set `--self-contained` on your CLI calls, or set MSBuild properties such as `true` or `true`. + +## See also + +- [Runtime-specific apps no longer self-contained](runtimespecific-app-default.md) diff --git a/docs/core/compatibility/sdk/8.0/runtimespecific-app-default.md b/docs/core/compatibility/sdk/8.0/runtimespecific-app-default.md index 4daefe356f157..79b922d93f5cc 100644 --- a/docs/core/compatibility/sdk/8.0/runtimespecific-app-default.md +++ b/docs/core/compatibility/sdk/8.0/runtimespecific-app-default.md @@ -34,7 +34,7 @@ In addition: - The `PublishReadyToRun` property no longer implies `SelfContained` if the project targets .NET 8 or later. > [!NOTE] ->If you publish using `msbuild /t:Publish`, you must explicitly specify `SelfContained` if you want your app to be self-contained, even if your project has one of the listed publish properties. +> If you publish using `msbuild /t:Publish` and you want your app to be self-contained, you must explicitly specify `SelfContained`, even if your project has one of the listed publish properties. ## Version introduced diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index d2495e89d0408..48ce60e6cf94a 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -142,6 +142,8 @@ items: href: sdk/8.0/msbuild-language.md - name: Runtime-specific apps not self-contained href: sdk/8.0/runtimespecific-app-default.md + - name: --arch option doesn't imply self-contained + href: sdk/8.0/arch-option.md - name: SDK uses a smaller RID graph href: sdk/8.0/rid-graph.md - name: Trimming may not be used with .NET Standard or .NET Framework @@ -1504,6 +1506,8 @@ items: href: sdk/8.0/msbuild-language.md - name: Runtime-specific apps not self-contained href: sdk/8.0/runtimespecific-app-default.md + - name: --arch option doesn't imply self-contained + href: sdk/8.0/arch-option.md - name: SDK uses a smaller RID graph href: sdk/8.0/rid-graph.md - name: Trimming may not be usedwith .NET Standard or .NET Framework From 1933d59adc3ef1514408a922a3b2251a5cf7cda6 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 5 Oct 2023 16:34:32 -0700 Subject: [PATCH 3/3] Update docs/core/compatibility/sdk/8.0/arch-option.md --- docs/core/compatibility/sdk/8.0/arch-option.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/compatibility/sdk/8.0/arch-option.md b/docs/core/compatibility/sdk/8.0/arch-option.md index 227b4d0b533d2..25eb161780766 100644 --- a/docs/core/compatibility/sdk/8.0/arch-option.md +++ b/docs/core/compatibility/sdk/8.0/arch-option.md @@ -5,7 +5,7 @@ ms.date: 10/05/2023 --- # --arch option doesn't imply self-contained -Up until now, the `--arch` option for `dotnet` CLI commands such as [dotnet publish](../../../tools/dotnet-publish.md) implied that the app was [self-contained](../../../deploying/index.md#publish-self-contained). The behavior of the `--arch` option has now been changed to match that of the `--runtime option`, and it no longer implies that an app is self-contained. +Up until now, the `--arch` option for `dotnet` CLI commands such as [dotnet publish](../../../tools/dotnet-publish.md) implied that the app was [self-contained](../../../deploying/index.md#publish-self-contained). The behavior of the `--arch` option has now been changed to match that of the `--runtime` option, and it no longer implies that an app is self-contained. ## Previous behavior