Skip to content

Commit 1411f56

Browse files
committed
Merge branch 'main' into alvinashcraft/main-winappsdk-background-tasks
2 parents ae9d425 + 115557b commit 1411f56

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+948
-36
lines changed

.github/ISSUE_TEMPLATE/1-customer-feedback.yml

+7-1
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,10 @@ body:
6464
validations:
6565
required: true
6666
attributes:
67-
label: Document Id
67+
label: Document Id
68+
- type: input
69+
id: platformId
70+
validations:
71+
required: true
72+
attributes:
73+
label: Platform Id

hub/apps/get-started/make-apps-great-for-windows.md

+26-14
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,25 @@
11
---
22
description: The top 11 things you can do to make your app great on Windows 11.
33
title: Top 11 things you can do to make your app great on Windows 11
4-
ms.topic: article
5-
ms.date: 02/27/2025
4+
ms.topic: concept-article
5+
ms.date: 03/06/2025
66
keywords: windows win32, desktop development
77
ms.localizationpriority: medium
88
ms.collection: windows11
9+
# customer intent: As a Windows developer, I want to know how to make my app great on Windows 11 so that I can provide a better, more secure experience for my users.
910
---
1011

1112
# Top 11 things you can do to make your app great on Windows 11
1213

13-
Windows 11 marks a visual evolution of the Windows operating system. As Windows moves forward, customers continue to set a higher bar for app experiences, too. We see these customer expectations manifest primarily in two areas: *app fundamentals* and *user experience*.
14+
Windows 11 marks a visual evolution of the Windows operating system. As Windows moves forward, customers continue to set a higher bar for app experiences, too. We see these customer expectations manifest primarily in three areas: *app fundamentals*, *user experience*, and *added security*.
1415

1516
- *App fundamentals* - good performance on low-cost, highly mobile device form factors, and hassle-free app lifecycle and state rehydration/roaming.
1617
- *User experience* - the ability to work naturally with a complete range of inputs, design and interaction patterns that look and feel at home on current and future devices, and support for modern windowing workflows and shell integration points.
18+
- *Added security* - deploying apps on a secure platform that protects user data and privacy, and the ability to integrate features like Windows Hello and Passkeys to provide a more secure experience for users.
1719

1820
With entirely new visuals signaling change, [signature experiences](../design/signature-experiences/signature-experiences.md) that showcase the best of Windows and Microsoft together, and a completely new [Store](/windows/uwp/publish) with more apps, Windows 11 is positioned as the Windows for "what's next".
1921

20-
Great apps on Windows meet these customer expectations for app fundamentals and modern user experience, and we are investing in the native Windows platform to make it easier for your apps to achievegreatnessthrough[WinUI](../winui/index.md), [MSIX](/windows/msix), and the [Windows App SDK](../windows-app-sdk/index.md) family of APIs. This document provides an overview what you need to do to make your app look and behave great so that users feel like your app was made for Windows 11.
22+
Great apps on Windows meet these customer expectations for app fundamentals, modern user experience, and added security, and we're investing in the native Windows platform to make it easier for your apps to achieve greatness through [WinUI](../winui/index.md), [MSIX](/windows/msix), and the [Windows App SDK](../windows-app-sdk/index.md) family of APIs. This document provides an overview what you need to do to make your app look and behave great so that users feel like your app was made for Windows 11.
2123

2224
Here are the top ~~10~~ 11 things you can do to make your app shine on Windows 11.
2325

@@ -66,7 +68,8 @@ Windows 11 brings beautiful UI innovations to the Windows operating system that
6668
![An image of common UI controls](images/great-apps/controls.png)
6769

6870
### Desktop apps (Win32)
69-
- Use [WinUI 3](../winui/winui3/index.md) in [Windows App SDK](../windows-app-sdk/index.md) 1.1 or greater to create a Win32 application that can leverage the modern common controls.
71+
72+
- Use [WinUI 3](../winui/winui3/index.md) in [Windows App SDK](../windows-app-sdk/index.md) 1.1 or greater to create a Win32 application that can leverage the modern common controls.
7073
- To evaluate the controls, check out the [WinUI 3 Gallery](https://github.com/Microsoft/WinUI-Gallery) (*main branch*).
7174
- Win32 controls that use [UXTheme](/windows/win32/api/uxtheme/) will automatically get a "repaint" of the Light theme for select rejuvenated control visuals. Be sure to test for any issues. For those surfaces that do not get updated automatically, manually update the visuals so that they look coherent with the rest of the update, if possible.
7275

@@ -106,9 +109,9 @@ Snap layouts are a new Windows 11 feature to help introduce users to the power o
106109

107110
- Most apps will automatically receive rounded corners and support for the menu with snap layouts, but in some cases you might need to do a little work to get them:
108111
- Allow the system to draw your border and shadow.
109-
- If you need to draw your own border and shadow:
110-
- Call our rounding API to opt in. See [Apply rounded corners in desktop apps for Windows 11](../desktop/modernize/ui/apply-rounded-corners.md).
111-
- Use our APIs to have the platform draw and implement the caption buttons. See [Support snap layouts for desktop apps on Windows 11](../desktop/modernize/ui/apply-snap-layout-menu.md).
112+
- If you need to draw your own border and shadow:
113+
- Call our rounding API to opt in. See [Apply rounded corners in desktop apps for Windows 11](../desktop/modernize/ui/apply-rounded-corners.md).
114+
- Use our APIs to have the platform draw and implement the caption buttons. See [Support snap layouts for desktop apps on Windows 11](../desktop/modernize/ui/apply-snap-layout-menu.md).
112115
- You will get these features automatically if you use UWP or you adopt Windows App SDK windowing to:
113116
- Configure the style of your window using the pre-defined templates.
114117
- Customize the title bar of your windows.
@@ -126,7 +129,7 @@ We support Light and Dark themes, which is a great way to let the user express t
126129

127130
Windows 11 refines the behavior of the contextual file operations in the right-click context menu of File Explorer and the Share dialog. If your app creates context menus or defines share targets, you may need to make some changes to ensure that these work well with Windows 11.
128131

129-
#### Context menus
132+
### Context menus
130133

131134
For Windows 11, we improved the behavior of the context menu in File Explorer in several ways:
132135

@@ -143,7 +146,7 @@ If your app defines a context menu extension, the following requirements must be
143146
- Your context menu extension must be implemented by using the [**IExplorerCommand**](/windows/win32/api/shobjidl_core/nn-shobjidl_core-iexplorercommand) interface. Context menu extensions that implement [**IContextMenu**](/windows/win32/api/shobjidl_core/nn-shobjidl_core-icontextmenu) will appear in the older context menu instead.
144147
- Your app must be a *packaged app* so that it has package identity at runtime. See [Features that require package identity](../desktop/modernize/modernize-packaged-apps.md) for some options for packaging your app.
145148

146-
#### Share dialog
149+
### Share dialog
147150

148151
For Windows 11, we improved the behavior of the Share dialog in several ways.
149152

@@ -169,13 +172,22 @@ We have updated icons and a new UI font called "Segoe UI Variable". We recommend
169172
> [!NOTE]
170173
> When an app that uses the new font runs in Windows 10 or down-level, it will fallback to use the old font and degrade gracefully.
171174
172-
## 10. Make use of the innovative features available in Windows
175+
## 10. Make use of the innovative, secure features available in Windows
173176

174-
People run Windows across conventional devices as well as an increasingly diverse, modern range of devices. Devices today come not only with x86/x64-based, but also Arm-based, architectures; not only with mouse and keyboard but also touch screens, touchpads, and pens; with cameras, GPS, and sensors like gyroscopes; and with graphics chipsets that enable not only amazing visuals but also hardware-accelerated artificial intelligence (AI). Customers expect apps to take advantage of the hardware (that they have paid for!) and be cognizant of the device form factor to give them an appropriately optimized experience.
177+
People run Windows across conventional devices as well as an increasingly diverse, modern range of devices. Devices today come not only with x86/x64-based, but also Arm-based, architectures; not only with mouse and keyboard but also touch screens, touchpads, and pens; with cameras, GPS, and sensors like gyroscopes; and with graphics and neural processing chipsets that enable not only amazing visuals but also hardware-accelerated artificial intelligence (AI). Customers expect apps to take advantage of the hardware (that they have paid for!) and be cognizant of the device form factor to give them an appropriately optimized experience.
175178

176179
- Achieve AI powered productivity with Win ML - [Introduction to Windows Machine Learning](/windows/ai/windows-ml/).
180+
- Use AI models that power Windows Copilot Runtime on Copilot+ PCs and run locally - [Windows Copilot Runtime overview](/windows/ai/apis/).
177181
- Utilize best practices for Notifications and content sharing - [Notifications (Design basics)](/windows/win32/uxguide/mess-notif).
178182

183+
### Enhanced security features in Windows
184+
185+
Windows is built on a foundation of security and privacy, and Windows 11 is designed to be the most secure version of Windows yet, and we're committed to helping you build secure apps that take advantage of the latest security features in Windows.
186+
187+
- Protect your Windows apps and backend services with Windows Hello biometric sign-in - [Windows Hello overview](/windows/apps/develop/security/windows-hello).
188+
- Implement passkey sign-ins across online, enterprise, and government applications, and for payments - [Intro to passkeys](/windows/apps/develop/security/intro).
189+
- Sign your apps with a digital certificate to ensure that [Smart App Control](https://support.microsoft.com/windows/app-browser-control-in-the-windows-security-app-8f68fb65-ebb4-3cfb-4bd7-ef0f376f3dc3#bkmk_smart-app-control) can verify the integrity of your app - [Introduction to code signing](/windows/win32/seccrypto/cryptography-tools#introduction-to-code-signing) and [Microsoft Trusted Root Program requirements](/security/trusted-root/program-requirements).
190+
179191
## 11. Utilize the power of MSIX and Windows Store to package and distribute your application
180192

181193
Distribute your app wherever it makes sense for your business. Windows lets you distribute from your existing website, app management system, or the Windows Store.
@@ -190,7 +202,7 @@ Distribute your app wherever it makes sense for your business. Windows lets you
190202

191203
[What is MSIX?](/windows/msix/overview)
192204

193-
## Related articles
205+
## Related content
194206

195207
- [Windows Dev Center](https://developer.microsoft.com/windows/)
196-
- [What's cool in Windows 11](https://developer.microsoft.com/windows/windows-for-developers/)
208+
- [What's cool in Windows 11](https://developer.microsoft.com/windows/windows-for-developers/)

hub/apps/publish/product-page-experiments.md

-3
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,6 @@ ms.localizationpriority: medium
88
---
99
# Product page experiments
1010

11-
> [!IMPORTANT]
12-
> Product page experiments will be coming soon to developers and customers of Microsoft Store on Windows.
13-
1411
Icons and screenshots occupy up to 50% of the surface area on a Microsoft Store product page, making them the first things customers notice. To maximize your impact, consider conducting A/B testing with different product page variations and then choosing the version that performs best to showcase on Microsoft Store.
1512

1613
To conduct a product page experiment, start by signing in to Partner Center and selecting your app. This new overview page in Partner Center consolidates all app actions and information in one place. The console also contextually prioritizes information cards based on your app's status.

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

+1
Original file line numberDiff line numberDiff line change
@@ -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.6.6 (1.6.250228001)](stable-channel.md#version-166-16250228001) <br/> 03/11/2025 <br/> [Release notes](stable-channel.md#version-166-16250228001) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6.6) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.250228001/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.250228001/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.250228001/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.250228001/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |
2526
| [1.6.5 (1.6.250205002)](stable-channel.md#version-165-16250205002) <br/> 02/11/2025 <br/> [Release notes](stable-channel.md#version-165-16250205002) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6.5) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.250205002/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.250205002/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.250205002/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.250205002/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |
2627
| [1.6.4 (1.6.250108002)](stable-channel.md#version-164-16250108002) <br/> 01/15/2025 <br/> [Release notes](stable-channel.md#version-164-16250108002) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6.4) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.250108002/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.250108002/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.250108002/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.250108002/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |
2728
| [1.6.3 (1.6.241114003)](stable-channel.md#version-163-16241114003) <br/> 11/18/2024 <br/> [Release notes](stable-channel.md#version-163-16241114003) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6.3) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.241114003/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.241114003/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.241114003/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.241114003/Microsoft.WindowsAppRuntime.Redist.1.6.zip) |

hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,7 @@ As a further step in assisting you to migrate your UWP apps to the Windows App S
3333

3434
## Containerization benefits
3535

36-
When transitioning to the Windows App SDK, UWP applications might lose the inherent containerization benefits of their original platform. However, those benefits can be restored by using Win32 App Isolation&mdash;a new security feature that enhances protection by isolating applications within a sandbox environment. This approach offers additional security against potential threats with minimal changes to your existing code. For more info, and to begin using Win32 App Isolation, visit [Welcome to the Win32 app isolation repo](https://github.com/microsoft/win32-app-isolation) on GitHub.
37-
36+
When transitioning to the Windows App SDK, UWP applications might lose the inherent containerization benefits of their original platform. However, those benefits can be restored by using Win32 App Isolation&mdash;a new security feature that enhances protection by isolating applications within a sandbox environment. This approach offers additional security against potential threats with minimal changes to your existing code. For more info, and to begin using Win32 App Isolation, see [Win32 app isolation overview](/windows/win32/secauthz/app-isolation-overview).
3837
## Topics in this section
3938

4039
| Topic | Description |

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

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe
1717
| | Channel | Description | Release cadence | Supported? | Latest release |
1818
|---------|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|------------|-----------------------------------------------------------------------------------------------------|
1919
| **❇️** | 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) |
20-
| **** | 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.6.5 (1.6.250205002)](stable-channel.md#version-165-16250205002) (02/11/2025) |
20+
| **** | 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.6.6 (1.6.250228001)](stable-channel.md#version-166-16250228001) (03/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.7.0-experimental3](experimental-channel.md#version-17-experimental-170-experimental3) (02/06/2025) |
2222

2323
For a comprehensive list of all current and previous releases of the Windows App SDK, including download locations, see [Downloads for the Windows App SDK](downloads.md).

0 commit comments

Comments
 (0)