Skip to content

Commit d0c4fb5

Browse files
Further tweaking .NET 8 support wording (#3775)
* Updating release notes and downloads for 1.4 experimental * Minor wording revisions * Release notes for 1.3.2 * Adding first release notes for 1.4-preview1 * Release notes for 1.3.3 * Fixing broken bookmark links * Updating 1.4-preview1 rel notes * Removing en-us from link * Adding release notes and downloads for 1.4-preview2 * Fixing bookmark * Tweaking wording for XAML Islands section * Minor wording tweaks * Clarifying wording for custom titlebar scenarios * Update preview-channel.md (#3728) minor revs * Adding release notes and downloads for WASDK 1.4.0 stable * Updating wording for ItemsView section * Removing comment referring to preview release * Removing duplicate reference to Popup/FlyoutBase.ShouldConstrainToRootBounds * Adding further detail to the .NET8 RID breaking change note * Fixing punctuation in formatting * Updating wording for .NET 8 recommended steps --------- Co-authored-by: KB <[email protected]>
1 parent 1e3afe6 commit d0c4fb5

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

hub/apps/windows-app-sdk/stable-channel.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,8 @@ We're introducing a new list control called the `ItemsView` and a corresponding
8282
- When using `ExtendsContentIntoTitleBar = true`, clicks at the top-left corner of the window by default always show the system window menu (Minimize/Close/etc.) rather than letting the pointer input through to the content of the window. This, for example, means that a Back button in that area of the titlebar will not work. A workaround for this issue is to set `AppWindow.TitleBar.IconShowOptions = Microsoft.UI.Windowing.IconShowOptions.HideIconAndSystemMenu` on the Window's AppWindow.
8383
- There are some new continuable exceptions when hiding `ShouldConstrainToRootBounds="False"` popups/flyouts. That includes hiding tooltips, as reported here: [Dismissing a tooltip throws 4 native exceptions · Issue #8699 · microsoft/microsoft-ui-xaml (github.com)](https://github.com/microsoft/microsoft-ui-xaml/issues/8699)
8484
- In 1.4, the min/max/close caption buttons for `ExtendsContentIntoTitleBar = true` are now drawn by AppWindow rather than XAML. This is by design, but it can impact apps that were overriding XAML's internal styles to hide or do extra customization of these buttons, such as in this report: [Cannot hide caption button on titlebar · Issue #8705 · microsoft/microsoft-ui-xaml (github.com)](https://github.com/microsoft/microsoft-ui-xaml/issues/8705)
85-
- There was a breaking change in .NET8 to how it handles the runtime identifier graph: [[Breaking change]: Projects targeting .NET 8 and higher will by default use a smaller, portable RID graph. · Issue #36527 · dotnet/docs (github.com)](https://github.com/dotnet/docs/issues/36527). To use .NET8 with the Windows App SDK, [setting UseRidGraph to true](/dotnet/core/compatibility/deployment/8.0/rid-asset-list#recommended-action) is recommended. You'll also need to update the `<RuntimeIdentifiers>` property in the `.csproj` file to `<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>`, as well as update each `Propeties\*pubxml` file to switch from `win10` to `win` in the `<RuntimeIdentifier>` property (for example, `<RuntimeIdentifier>win-x86</RuntimeIdentifier>`).
85+
- There was a breaking change in .NET 8 to how it handles the runtime identifier graph: [[Breaking change]: Projects targeting .NET 8 and higher will by default use a smaller, portable RID graph. · Issue #36527 · dotnet/docs (github.com)](https://github.com/dotnet/docs/issues/36527). Because of this issue and because .NET 8 has not officially released yet, the Windows App SDK 1.4 does not officially support .NET 8. However, if you would still like to target the pre-release version of .NET 8 with this version of the App SDK, we recommend the following steps:
86+
- [Setting UseRidGraph to true](/dotnet/core/compatibility/deployment/8.0/rid-asset-list#recommended-action) is recommended. You'll also need to update the `<RuntimeIdentifiers>` property in the `.csproj` file to `<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>`, as well as update each `Propeties\*pubxml` file to switch from `win10` to `win` in the `<RuntimeIdentifier>` property (for example, `<RuntimeIdentifier>win-x86</RuntimeIdentifier>`).
8687
- With Windows App SDK 1.4, the target `GenerateDeploymentManagerCS` in `Microsoft.WindowsAppSDK.DeploymentManager.CS.targets` was renamed to `GenerateBootstrapCS`.
8788
- `MenuFlyout` background doesn't use the application's requested theme:
8889
- [MenuFlyoutItem text doesn't sync with system theme. · Issue #8678 · microsoft/microsoft-ui-xaml (github.com)](https://github.com/microsoft/microsoft-ui-xaml/issues/8678)

0 commit comments

Comments
 (0)