Skip to content

Commit b1eb021

Browse files
Karl-Bridge-Microsoftfloh96mdanish-khalvinashcraftCopilot
authored
main to live (MicrosoftDocs#5496)
* fix Repair-WinGetPackageManager command fails without -AllUsers * Updates for the WinGet configuration sample * WinGet configuration file can be launched via double-clicking * Update AppService UWP topic from feedback * Update uwp/launch-resume/how-to-create-and-consume-an-app-service.md Co-authored-by: Copilot <[email protected]> * Add link to full sample on Learn samples * Update command-results.md * WinAppSDK 1.6.9 Release Notes (MicrosoftDocs#5491) * WinAppSDK 1.6.9 Release Notes * Update downloads-archive.md * WinAppSDK 1.7.3 Release Notes (MicrosoftDocs#5480) * WinAppSDK Release Notes * Update stable-channel.md absolute link to learn --------- Co-authored-by: KB <[email protected]> --------- Co-authored-by: Florian Heberl <[email protected]> Co-authored-by: Muhammad Danish <[email protected]> Co-authored-by: Alvin Ashcraft <[email protected]> Co-authored-by: Alvin Ashcraft <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: PesBandi <[email protected]> Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com> Co-authored-by: Roy <[email protected]> Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]> Co-authored-by: Matt Wojciakowski <[email protected]>
1 parent 0da0392 commit b1eb021

File tree

7 files changed

+170
-111
lines changed

7 files changed

+170
-111
lines changed

hub/apps/windows-app-sdk/downloads.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.localizationpriority: medium
1212
This page provides download links to the *latest* releases of the [Windows App SDK](index.md) in the three release channels (stable, preview, and experimental). To get started quickly, download the latest x64 installer below. Or, for older releases, see [Archive of Windows App SDK downloads](downloads-archive.md).
1313

1414
> [!div class="button" style="text-align: left;" width="150px;"]
15-
> [Download the latest x64 stable installer (1.7.2)](https://aka.ms/windowsappsdk/1.7/latest/windowsappruntimeinstall-x64.exe)
15+
> [Download the latest x64 stable installer (1.7.3)](https://aka.ms/windowsappsdk/1.7/latest/windowsappruntimeinstall-x64.exe)
1616
1717
For all the latest Windows App SDK downloads, refer to the tables and links below. To learn more, see [Windows App SDK release channels](release-channels.md) and the release notes provided below for each version.
1818

@@ -22,6 +22,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo
2222

2323
| Version | Runtime downloads |
2424
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
25+
| [1.7.3 (1.7.250606001)](stable-channel.md#version-17) <br/> 06/10/2025 <br/> [Release notes](stable-channel.md#version-17) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7.3) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250606001/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250606001/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250606001/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250606001/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
2526
| [1.7.2 (1.7.250513003)](stable-channel.md#version-17) <br/> 05/19/2025 <br/> [Release notes](stable-channel.md#version-17) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7.2) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250513003/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250513003/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250513003/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250513003/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
2627
| [1.7.1 (1.7.250401001)](stable-channel.md#version-17) <br/> 04/08/2025 <br/> [Release notes](stable-channel.md#version-17) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7.1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250401001/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250401001/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250401001/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250401001/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |
2728
| [1.7.0 (1.7.250310001)](stable-channel.md#version-17) <br/> 03/18/2025 <br/> [Release notes](stable-channel.md#version-17) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.7.0) | [Installer (x64)](https://aka.ms/windowsappsdk/1.7/1.7.250310001/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.7/1.7.250310001/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.7/1.7.250310001/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.7/1.7.250310001/Microsoft.WindowsAppRuntime.Redist.1.7.zip) |

hub/apps/windows-app-sdk/release-channels.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
1616
1717
| | Channel | Description | Release cadence | Supported? | Latest release |
1818
| --------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------- |
19-
| **** | Stable ([release notes](stable-channel.md)) | This channel is supported for use by apps in production environments. It includes only stable APIs. | No more frequent than every six months<br>(+ servicing) | Yes | [1.7.2 (1.7.250513003)](stable-channel.md#version-172-17250513003) (05/19/2025) |
19+
| **** | Stable ([release notes](stable-channel.md)) | This channel is supported for use by apps in production environments. It includes only stable APIs. | No more frequent than every six months<br>(+ servicing) | Yes | [1.7.3 (1.7.250606001)](stable-channel.md#version-173-17250606001) (06/10/2025) |
2020
| **❇️** | Preview ([release notes](preview-channel.md)) | This channel provides a preview of the next stable release. There may be breaking API changes between a given preview channel release and the next stable release. | At least one preview per stable version | No | [1.7.0-preview1](preview-channel.md#version-17-preview-1-17-preview1) (02/11/2025) |
2121
| **🔄️** | Experimental ([release notes](experimental-channel.md)) | This channel includes experimental features that are in early stages of development. Experimental features may be removed from the next release, or may never be released. | As needed when requiring feedback for features in early design or prototype stages | No | [1.8.0-experimental2](experimental-channel.md#version-18-experimental-180-experimental2) (05/19/2025) |
2222

@@ -51,7 +51,7 @@ The Windows App SDK has a lifecycle. A lifecycle begins when a version or servic
5151

5252
| Windows App SDK version | Original release date | Latest patch version | Patch release date | Support level | End of servicing |
5353
| ----------------------- | --------------------- | -------------------- | ------------------ | -------------- | ---------------- |
54-
| 1.7 | 03/18/2025 | 1.7.250513003 | 05/19/2025 | Current | 03/18/2026 |
54+
| 1.7 | 03/18/2025 | 1.7.250606001 | 06/10/2025 | Current | 03/18/2026 |
5555
| 1.6 | 09/04/2024 | 1.6.250602001 | 06/10/2025 | Maintenance | 09/04/2025 |
5656
| 1.5 | 02/29/2024 | 1.5.250108004 | 01/15/2025 | Out of Support | 02/28/2025 |
5757
| 1.4 | 08/29/2023 | 1.4.240802001 | 08/13/2024 | Out of Support | 08/29/2024 |

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

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,43 @@ In an existing Windows App SDK app, you can update your Nuget package to 1.7.250
3838

3939
For the updated runtime and MSIX, see [Downloads for the Windows App SDK](./downloads.md).
4040

41+
### Version 1.7.3 (1.7.250606001)
42+
43+
#### Windows AI APIs
44+
45+
> [!IMPORTANT]
46+
> The underlying ML models required for these APIs currently require your device to be running the latest Windows 11 Insider Preview Build on the Dev Channel. Additionally, these APIs require your device to be a Copilot+ PC. See [Copilot+ PCs Developer Guide](/windows/ai/npu-devices) to learn more about these devices. APIs will throw an exception when called on devices lacking the necessary support.
47+
48+
The Windows App SDK now includes a suite of artificial intelligence (AI) APIs that can be used with a local language model to perform a variety of tasks on Copilot+ PCs. Your apps can now intelligently respond to prompts, recognize text within images, describe the content of images, remove objects from images, and more.
49+
50+
For information on responsible development practices utilized during the creation of the Windows AI APIs, which can also be applied when creating AI-assisted features, consult the [Developing Responsible Generative AI Applications and Features on Windows](/windows/ai/rai) guidance.
51+
52+
53+
#### New Rank property for Widgets
54+
55+
Added a new `Rank` property to Widgets. Rank may be used by the platform's recommendation engine to sort Widgets from a same application package identity. Should multiple widgets from the same provider be recommended for a UI surface, the Rank property will determine the order in which they appear. The Rank property does not change how a Widget is placed compared to other provider's Widgets, nor does it affect the chance a Widget will be recommended.
56+
57+
#### Bug Fixes
58+
59+
- Added the following sentence to section 1a of the .nupkg license: When building Generative AI applications follow the guidelines in [Developing Responsible Generative AI Applications and Features on Windows](/windows/ai/rai).
60+
- Fixed a potential crash in ApplicationDataProvider::GetStateFolderUris caused by reentrancy. For more info, see GitHub issue [#10513](https://github.com/microsoft/microsoft-ui-xaml/issues/10513). ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): ApplicationDataProvider_ReentrancyProtection)
61+
- Fixed a potential crash in WindowChrome::SetTitleBar when closing a window. For more info, see GitHub issue [#9203](https://github.com/microsoft/microsoft-ui-xaml/issues/9203). ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): WindowChrome_SetTitleBarCrash)
62+
- Fixed a potential crash in PointerInputObserverWinRT::FlushCoalescedInput_Callback when there is reentrancy while processing input. ([RuntimeCompatibilityChange](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.runtimecompatibilityoptions.disabledchanges): InputPointerSource_FlushReentrancyCrash)
63+
64+
#### New APIs for 1.7.3
65+
66+
This release includes the following new APIs compared to the previous 1.7 release:
67+
68+
```
69+
Microsoft.Windows.Widgets.Providers
70+
71+
WidgetInfo
72+
Rank
73+
74+
WidgetUpdateRequestOptions
75+
Rank
76+
```
77+
4178
### Version 1.7.2 (1.7.250513003)
4279

4380
#### Windows AI APIs

hub/package-manager/configuration/create.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,16 +62,18 @@ properties:
6262
settings:
6363
MinVersion: '10.0.22000'
6464
resources:
65-
- resource: Microsoft.Windows.Developer/DeveloperMode
65+
- resource: Microsoft.Windows.Settings/WindowsSettings
6666
directives:
6767
description: Enable Developer Mode
6868
allowPrerelease: true
69+
securityContext: elevated
6970
settings:
70-
Ensure: Present
71+
DeveloperMode: true
7172
- resource: Microsoft.WinGet.DSC/WinGetPackage
7273
id: vsPackage
7374
directives:
7475
description: Install Visual Studio 2022 Community
76+
securityContext: elevated
7577
settings:
7678
id: Microsoft.VisualStudio.2022.Community
7779
source: winget
@@ -81,6 +83,7 @@ properties:
8183
directives:
8284
description: Install required VS workloads from vsconfig file
8385
allowPrerelease: true
86+
securityContext: elevated
8487
settings:
8588
productId: Microsoft.VisualStudio.Product.Community
8689
channelId: VisualStudio.17.Release
@@ -99,7 +102,7 @@ The components of this file consist of:
99102

100103
4. **Resources**: Both the `assertions` and `resources` list sections consist of individual `resource` nodes to represent the set up task. The `resource` should be given the name of the PowerShell module followed by the name of the module's DSC resource that will be invoked to apply your desired state: `{ModuleName}/{DscResource}`. Each resource must include `directives` and `settings`. Optionally, it can also include an `id` value. When applying a configuration, WinGet will know to install the module from the [PowerShell Gallery](https://www.powershellgallery.com/packages) and invoke the specified [DSC resource](/powershell/dsc/concepts/resources).
101104

102-
5. **Directives**: The `directives` section provides information about the module and the resource. This section should include a `description` value to describe the configuration task being accomplished by the module. The `allowPrerelease` value enables you to choose whether or not the configuration will be allowed (`true`) to use "Prerelease" modules from the [PowerShell Gallery](https://www.powershellgallery.com/packages).
105+
5. **Directives**: The `directives` section provides information about the module and the resource. This section should include a `description` value to describe the configuration task being accomplished by the module. The `allowPrerelease` value enables you to choose whether or not the configuration will be allowed (`true`) to use "Prerelease" modules from the [PowerShell Gallery](https://www.powershellgallery.com/packages). Some DSC resources may need to run with administrator privileges. The `securityContext: elevated` field under the directives section of a resource indicates this requirement. When set to `elevated`, WinGet will prompt for one UAC approval at the start of the configuration. WinGet will then launch two processes: one that runs resources with elevated privileges and another that runs resources with the current user's privileges.
103106

104107
6. **Settings**: The `settings` value of a resource represents the collection of name-value pairs being passed to the PowerShell DSC Resource. Settings could represent anything from whether Developer Mode is enabled, to applying a reg key, or to establishing a particular network setting.
105108

hub/package-manager/configuration/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The benefits of using a WinGet Configuration file include:
2626
2727
## Use a WinGet Configuration file to configure your machine
2828

29-
To set up your machine using a WinGet Configuration file, use [winget configure](../winget/configure.md) in the command line. To use the `winget configure` command, you must be running WinGet version [v1.6.2631 or later](https://github.com/microsoft/winget-cli/releases).
29+
To set up your machine using a WinGet Configuration file, download the configuration file and double-click to invoke the configuration. Alternatively, use [winget configure](../winget/configure.md) in the command line. To use the `winget configure` command, you must be running WinGet version [v1.6.2631 or later](https://github.com/microsoft/winget-cli/releases).
3030

3131
## WinGet Configuration FAQs
3232

@@ -61,7 +61,7 @@ A benefit to the declarative (non-sequential) nature of WinGet configuration fil
6161

6262
### How do I use a WinGet Configuration file?
6363

64-
To run a WinGet Configuration file, use the [`winget configure` command](../winget/configure.md).
64+
To run a WinGet Configuration file, you can simply double-click to run the file in file explorer. Alternatively, you can use the [`winget configure` command](../winget/configure.md).
6565

6666
### How do I author a WinGet Configuration?
6767

hub/package-manager/winget/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Write-Host "Installing WinGet PowerShell module from PSGallery..."
3939
Install-PackageProvider -Name NuGet -Force | Out-Null
4040
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
4141
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
42-
Repair-WinGetPackageManager
42+
Repair-WinGetPackageManager -AllUsers
4343
Write-Host "Done."
4444
```
4545

0 commit comments

Comments
 (0)