Merge pull request #5581 from MicrosoftDocs/main

Auto Publish – main to live - 2025-07-10 20:30 UTC

Author: learn-build-service-prod[bot]

hub/apps/develop/windows-integration/copilot-key-state.md

@@ -101,7 +101,7 @@ The following example shows the **uap:Extension** registering the URI scheme "my
 
 An app must be packaged in order to register as a Microsoft Copilot hardware key provider. For information on app packaging, see [An overview of Package Identity in Windows app](/windows/apps/desktop/modernize/package-identity-overview). Microsoft Copilot hardware key providers declare their registration information within the [uap3:AppExtension](/uwp/schemas/appxpackage/uapmanifestschema/element-uap3-appextension-manual). The **Name** attribute of the extension must be set to "com.microsoft.windows.copilotkeyprovider". To support the key state changes, apps must provide some additional entries to their **uap3:AppExtension** declaration.
 
-Inside of the **uap3:AppExtension** element, add a [uap3:Properties](/uwp/schemas/appxpackage/uapmanifestschema/element-uap3-properties-manual) element with child elements **PressAndHoldStart** and **PressAndHoldStop**. The contents of these elements should be the URI of the protocol scheme registered in the manifest in the previous step. The query string arguments specify whether the URI is being launched because the user pressed and held the hot key or because the user released the hot key. The app uses these query string values during app activation to determine the correct action to take.
+Inside of the **uap3:AppExtension** element, add a [uap3:Properties](/uwp/schemas/appxpackage/uapmanifestschema/element-uap3-properties-manual) element with child elements **PressAndHoldStart** and **PressAndHoldStop**. The contents of these elements should be the URI of the protocol scheme registered in the manifest in the previous step. The query string arguments specify whether the URI is being launched because the user pressed and held the hot key or because the user released the hot key. The app uses these query string values during app activation to determine the correct action to take. Specifying the **SingleTap** element is optional but can be useful to determine if the app was launched from the Copilot hardware key.
 
 ```xml
 <!-- Package.appxmanifest -->
@@ -115,8 +115,9 @@ Inside of the **uap3:AppExtension** element, add a [uap3:Properties](/uwp/schema
       Description="App description" 
       PublicFolder="Public"> 
       <uap3:Properties> 
-        <PressAndHoldStart>myapp-copilothotkey:?state=Down</PressAndHoldStart> 
-        <PressAndHoldStop>myapp-copilothotkey:?state=Up</PressAndHoldStop> 
+        <SingleTap>myapp-copilothotkey://?state=Tap</SingleTap>
+        <PressAndHoldStart>myapp-copilothotkey://?state=Down</PressAndHoldStart> 
+        <PressAndHoldStop>myapp-copilothotkey:?//state=Up</PressAndHoldStop> 
       </uap3:Properties> 
     </ uap3:AppExtension> 
   </uap3:Extension> 
@@ -168,7 +169,7 @@ To add support for fast path invocation, update the "com.microsoft.windows.copil
     Description="App description"
     PublicFolder="Public">
     <uap3:Properties>
-      <SingleTap MessageWParam="0"/>
+      <SingleTap MessageWParam="0">myapp-copilothotkey://?state=Tap</SingleTap>
       <PressAndHoldStart MessageWParam="1">myapp-copilothotkey://?state=Down</PressAndHoldStart>
       <PressAndHoldStop MessageWParam="2">myapp-copilothotkey://?state=Up</PressAndHoldStop>
     </uap3:Properties>

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

@@ -19,17 +19,6 @@ The experimental channel includes releases of the Windows App SDK with [experime
 - If you'd like to upgrade an existing app from an older version of the Windows App SDK to a newer version, see [Update existing projects to the latest release of the Windows App SDK](update-existing-projects-to-the-latest-release.md).
 - For documentation on experimental releases, see [Install tools for preview and experimental channels of the Windows App SDK](preview-experimental-install.md).
 
-**Experimental channel release note archive:**
-
-- [Experimental channel release notes for the Windows App SDK 1.7](release-notes-archive/experimental-channel-1.7.md)
-- [Experimental channel release notes for the Windows App SDK 1.6](release-notes-archive/experimental-channel-1.6.md)
-- [Experimental channel release notes for the Windows App SDK 1.5](release-notes-archive/experimental-channel-1.5.md)
-- [Experimental channel release notes for the Windows App SDK 1.4](release-notes-archive/experimental-channel-1.4.md)
-- [Experimental channel release notes for the Windows App SDK 1.3](release-notes-archive/experimental-channel-1.3.md)
-- [Experimental channel release notes for the Windows App SDK 1.2](release-notes-archive/experimental-channel-1.2.md)
-- [Experimental channel release notes for the Windows App SDK 1.0](release-notes-archive/experimental-channel-1.0.md)
-- [Experimental channel release notes for the Windows App SDK 0.8](release-notes-archive/experimental-channel-0.8.md)
-
 ## Version 1.8 Experimental (1.8.0-Experimental4)
 
 ### Use on-device AI with Windows AI APIs
@@ -467,6 +456,10 @@ Microsoft.Windows.Widgets.Feeds.Providers
 
 ## Version 1.8 Experimental (1.8.0-experimental3)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.8 Experimental (1.8.0-experimental3) release</summary>
+
 ### Use on-device AI with Windows AI APIs
 
 > [!IMPORTANT]
@@ -821,8 +814,14 @@ Microsoft.Windows.Widgets.Feeds.Providers
     IFeedManager3
 ```
 
+</details>
+
 ## Version 1.8 Experimental (1.8.0-experimental2)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.8 Experimental (1.8.0-experimental2) release</summary>
+
 ### Use on-device AI with Windows AI APIs
 
 > [!IMPORTANT]
@@ -1197,8 +1196,14 @@ Microsoft.Windows.Widgets.Providers
 * If you're using the Microsoft.WindowsAppSDK.WinUI component package in its default self-contained mode, make sure to set the WebView2EnableCsWinRTProjection property to true when utilizing WebView2 APIs. This helps prevent version conflicts and avoids related warnings.
 * When using the WindowsAppSDK component packages, you may notice a warning `NU1603` indicating the specified version of a dependent component package was not found, but another was resolved instead.  This is expected with the experimental2 build and NuGet will correctly resolve a newer version of the package which will allow your project to build.  If you treat warnings as errors, you can temporarily treat this specific warning as not an error by specifying the property `<WarningsNotAsErrors>NU1603</WarningsNotAsErrors>`.
 
+</details>
+
 ## Version 1.8 Experimental (1.8.0-experimental1)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.8 Experimental (1.8.0-experimental1) release</summary>
+
 ### Use on-device AI with Windows AI APIs
 
 > [!IMPORTANT]
@@ -1568,8 +1573,24 @@ This release includes the following bug fixes:
 
 - Fixed an issue where mouse wheel input is ignored if the "Scroll inactive windows when hovering over them" option in Windows Settings is disabled. For more info, see GitHub issue [#10091](https://github.com/microsoft/microsoft-ui-xaml/issues/10091).
 
+</details>
+
+## Archive of experimental channel release notes
 
+<details>
+
+<summary>Expand for links to archived experimental channel release notes</summary>
+
+- [Experimental channel release notes for the Windows App SDK 1.7](release-notes-archive/experimental-channel-1.7.md)
+- [Experimental channel release notes for the Windows App SDK 1.6](release-notes-archive/experimental-channel-1.6.md)
+- [Experimental channel release notes for the Windows App SDK 1.5](release-notes-archive/experimental-channel-1.5.md)
+- [Experimental channel release notes for the Windows App SDK 1.4](release-notes-archive/experimental-channel-1.4.md)
+- [Experimental channel release notes for the Windows App SDK 1.3](release-notes-archive/experimental-channel-1.3.md)
+- [Experimental channel release notes for the Windows App SDK 1.2](release-notes-archive/experimental-channel-1.2.md)
+- [Experimental channel release notes for the Windows App SDK 1.0](release-notes-archive/experimental-channel-1.0.md)
+- [Experimental channel release notes for the Windows App SDK 0.8](release-notes-archive/experimental-channel-0.8.md)
 
+</details>
 
 ## Related topics
 

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

@@ -19,19 +19,6 @@ The preview channel includes releases of the Windows App SDK with [preview chann
 - If you'd like to upgrade an existing app from an older version of the Windows App SDK to a newer version, see [Update existing projects to the latest release of the Windows App SDK](update-existing-projects-to-the-latest-release.md).
 - For documentation on preview releases, see [Install tools for preview and experimental channels of the Windows App SDK](preview-experimental-install.md).
 
-**Preview channel release note archive:**
-
-- [Preview channel release notes for the Windows App SDK 1.6](release-notes-archive/preview-channel-1.6.md)
-- [Preview channel release notes for the Windows App SDK 1.5](release-notes-archive/preview-channel-1.5.md)
-- [Preview channel release notes for the Windows App SDK 1.4](release-notes-archive/preview-channel-1.4.md)
-- [Preview channel release notes for the Windows App SDK 1.3](release-notes-archive/preview-channel-1.3.md)
-- [Preview channel release notes for the Windows App SDK 1.2](release-notes-archive/preview-channel-1.2.md)
-- [Preview channel release notes for the Windows App SDK 1.1](release-notes-archive/preview-channel-1.1.md)
-- [Preview channel release notes for the Windows App SDK 1.0](release-notes-archive/preview-channel-1.0.md)
-
-
-
-
 ## Version 1.7 Preview 1 (1.7-preview1)
 
 This is the latest release of the preview channel for version 1.7.
@@ -181,6 +168,22 @@ This release includes the following bug fixes:
 - Fixed a potential layout cycle crash in `StackLayout`. For more info, see GitHub issue [#9852](https://github.com/microsoft/microsoft-ui-xaml/issues/9852).
 - Fixed a potential crash in `ItemsView` when removing items. For more info, see GitHub issue [#9868](https://github.com/microsoft/microsoft-ui-xaml/issues/9868).
 
+## Archive of preview channel release notes
+
+<details>
+
+<summary>Expand for links to archived preview channel release notes</summary>
+
+- [Preview channel release notes for the Windows App SDK 1.6](release-notes-archive/preview-channel-1.6.md)
+- [Preview channel release notes for the Windows App SDK 1.5](release-notes-archive/preview-channel-1.5.md)
+- [Preview channel release notes for the Windows App SDK 1.4](release-notes-archive/preview-channel-1.4.md)
+- [Preview channel release notes for the Windows App SDK 1.3](release-notes-archive/preview-channel-1.3.md)
+- [Preview channel release notes for the Windows App SDK 1.2](release-notes-archive/preview-channel-1.2.md)
+- [Preview channel release notes for the Windows App SDK 1.1](release-notes-archive/preview-channel-1.1.md)
+- [Preview channel release notes for the Windows App SDK 1.0](release-notes-archive/preview-channel-1.0.md)
+
+</details>
+
 ## Related topics
 
 - [Stable channel](stable-channel.md)

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

@@ -15,18 +15,6 @@ The stable channel provides releases of the Windows App SDK that are supported f
 
 - If you'd like to upgrade an existing app from an older version of the Windows App SDK to a newer version, see [Update existing projects to the latest release of the Windows App SDK](update-existing-projects-to-the-latest-release.md).
 
-**Stable channel release note archive:**
-
-- [Stable channel release notes for the Windows App SDK 1.6](release-notes-archive/stable-channel-1.6.md)
-- [Stable channel release notes for the Windows App SDK 1.5](release-notes-archive/stable-channel-1.5.md)
-- [Stable channel release notes for the Windows App SDK 1.4](release-notes-archive/stable-channel-1.4.md)
-- [Stable channel release notes for the Windows App SDK 1.3](release-notes-archive/stable-channel-1.3.md)
-- [Stable channel release notes for the Windows App SDK 1.2](release-notes-archive/stable-channel-1.2.md)
-- [Stable channel release notes for the Windows App SDK 1.1](release-notes-archive/stable-channel-1.1.md)
-- [Stable channel release notes for the Windows App SDK 1.0](release-notes-archive/stable-channel-1.0.md)
-- [Stable channel release notes for the Windows App SDK 0.8](release-notes-archive/stable-channel-0.8.md)
-- [Stable channel release notes for the Windows App SDK 0.5](release-notes-archive/stable-channel-0.5.md)
-
 ## Downloads for the Windows App SDK
 
 > [!NOTE]
@@ -40,6 +28,8 @@ For the updated runtime and MSIX, see [Downloads for the Windows App SDK](./down
 
 ### Version 1.7.3 (1.7.250606001)
 
+This is the latest service release for Version 1.7 of the Windows App SDK.
+
 #### Windows AI APIs
 
 > [!IMPORTANT]
@@ -77,6 +67,10 @@ Microsoft.Windows.Widgets.Providers
 
 ### Version 1.7.2 (1.7.250513003)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.7.2 (1.7.250513003) release</summary>
+
 #### Windows AI APIs
 
 > [!IMPORTANT]
@@ -200,8 +194,14 @@ Microsoft.Windows.Workloads
     WorkloadsContract
 ```
 
+</details>
+
 ### Version 1.7.1 (1.7.250401001)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.7.1 (1.7.250401001) release</summary>
+
 This is a servicing release of the Windows App SDK that includes critical bug fixes for the 1.7 release.
 
 - Improved the telemetry for failure scenarios in WindowsAppRuntimeInstall-&lt;arch&gt;.exe. For more info, see GitHub issue [#5289](https://github.com/microsoft/WindowsAppSDK/pull/5289). ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): N/A, installer change)
@@ -216,8 +216,14 @@ This is a servicing release of the Windows App SDK that includes critical bug fi
 - Fixed a potential crash caused by WebView2::UpdateCoreWebViewVisibility sometimes triggering reentrancy. For more info, see GitHub issue [#10305](https://github.com/microsoft/microsoft-ui-xaml/issues/10305). ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): FixWebViewVisibilityReentrancyCrash)
 - Fixed an issue where app UI sometimes permanently freezes and can stop rendering due to the DispatcherQueue getting stuck. ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): FixRandomUIFreezeInDispatcher)
 
+</details>
+
 ### Version 1.7.0 (1.7.250310001)
 
+<details>
+
+<summary>Expand to see details for the Windows App SDK 1.7.0 (1.7.250310001) release</summary>
+
 The following sections describe new and updated features and known issues for version 1.7.
 
 #### New Badge Notifications Feature
@@ -479,6 +485,26 @@ This release includes the following bug fixes:
 - Fixed an issue in 1.7-preview1 where popups no longer correctly moved with their parent window. For more info, see GitHub issue [#10386](https://github.com/microsoft/microsoft-ui-xaml/issues/10386).
 - Based on feedback from 1.7-preview1, renamed some properties on the new `TitleBar` control.
 
+</details>
+
+## Archive of stable channel release notes
+
+<details>
+
+<summary>Expand for links to archived experimental channel release notes</summary>
+
+- [Stable channel release notes for the Windows App SDK 1.6](release-notes-archive/stable-channel-1.6.md)
+- [Stable channel release notes for the Windows App SDK 1.5](release-notes-archive/stable-channel-1.5.md)
+- [Stable channel release notes for the Windows App SDK 1.4](release-notes-archive/stable-channel-1.4.md)
+- [Stable channel release notes for the Windows App SDK 1.3](release-notes-archive/stable-channel-1.3.md)
+- [Stable channel release notes for the Windows App SDK 1.2](release-notes-archive/stable-channel-1.2.md)
+- [Stable channel release notes for the Windows App SDK 1.1](release-notes-archive/stable-channel-1.1.md)
+- [Stable channel release notes for the Windows App SDK 1.0](release-notes-archive/stable-channel-1.0.md)
+- [Stable channel release notes for the Windows App SDK 0.8](release-notes-archive/stable-channel-0.8.md)
+- [Stable channel release notes for the Windows App SDK 0.5](release-notes-archive/stable-channel-0.5.md)
+
+</details>
+
 ## Related topics
 
 - [Preview channel](preview-channel.md)