Merge branch 'main' into alvinashcraft/main-move-dotnetmaui-ai-topics-to-ai-repo

alvinashcraft · alvinashcraft · commit 863b66c08b89 · 2024-04-12T08:10:35.000-04:00
diff --git a/hub/apps/develop/feeds/feed-provider-manifest.md b/hub/apps/develop/feeds/feed-provider-manifest.md
@@ -87,6 +87,7 @@ Represents the registration for a single feed.
 | **Description** | string | Yes | A short description of the feed. | N/A |
 | **ContentUri** | string | Yes | The URI from which feed content is retrieved. | N/A |
 | **Icon** | string | Yes | The package-relative path to an icon image file that is displayed in the Widgets Board. | N/A |
+| **WebRequestFilter** | string | No | A web request filter string specifying the set of URLs for which the resource requests will be redirected to the feed provider's implementation of **IFeedResourceProvider**. The pattern is expressed using the format described in [Match Patterns](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns). The filter string in the registration must use [Punycode](https://en.wikipedia.org/wiki/Punycode) where necessary. All content types will be redirected when matched so the filter should only resolve to content intended to be obtained through the **IFeedResourceProvider** in the application. | N/A |
 
 
 You can use localized resources instead of string literals for the UI-facing attribute values. For more information, see [Localize strings in your UI and app package manifest](/windows/uwp/app-resources/localize-strings-ui-manifest).
@@ -103,9 +104,10 @@ The following code example illustrates the usage of the feed package manifest XM
               <CreateInstance ClassId="ECB883FD-3755-4E1C-BECA-D3397A3FF15C" />
           </Activation>
           <Definitions>
-              <Definition Id="Contoso_Feed" DisplayName="ms-resource:FeedDisplayName" Description="ms-resource:FeedDescription"
-                          ContentUri="https://contoso.com/news"
-                          Icon="ms-appx:Images\ContosoFeedIcon.png">
+              <Definition Id="Contoso_Feed" DisplayName="ms-resource:FeedDisplayName"                  Description="ms-resource:FeedDescription"
+                  ContentUri="https://contoso.com/news"
+                  Icon="ms-appx:Images\ContosoFeedIcon.png"
+                  WebRequestFilter="https://contoso.com/*/feed/appResource/*" >
               </Definition>
           </Definitions>
       </FeedProvider>
diff --git a/hub/apps/develop/windows-integration/index.md b/hub/apps/develop/windows-integration/index.md
@@ -0,0 +1,27 @@
+---
+description: This section of the documentation provides developer guidance for integrating with Windows.
+title: Integrate with Windows
+ms.topic: article
+ms.date: 04/01/2024
+ms.localizationpriority: medium
+---
+
+# Integrate with Windows
+
+This section of the documentation provides developer guidance for integrating with Windows.
+
+## Windows system components that support 3rd party integration
+
+The following table lists the Windows system components that support integration for 3rd party developers.
+
+| Feature | Description |
+|--|--|
+| [Feed providers](../feeds/feed-providers.md) | Learn how to integrate into the Windows feeds experience. |
+| [Search providers](../search/search-providers.md) | Learn how to integrate into the Windows Search experience. |
+| [Widget providers](../widgets/widget-providers.md) | Learn how to implement a Windows widget service provider to support your app. |
+
+## Other Windows integration features
+
+| Feature | Description |
+|--|--|
+| [Smart App Control](../smart-app-control/overview.md) | Smart App Control is a new app execution control feature that combines Microsoft’s app intelligence services and Windows' code integrity features to protect users from untrusted or potentially dangerous code. |
diff --git a/hub/apps/toc.yml b/hub/apps/toc.yml
@@ -233,6 +233,7 @@ items:
             - name: WinUI performance optimization
               href: performance/winui-perf.md
         - name: Integrate with Windows
+          href: develop/windows-integration/index.md
           items: 
             - name: Windows feed providers
               items: 
diff --git a/hub/apps/windows-app-sdk/downloads.md b/hub/apps/windows-app-sdk/downloads.md
@@ -12,7 +12,7 @@ ms.localizationpriority: medium
 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 [Older downloads for the Windows App SDK](./older-downloads.md).
 
 > [!div class="button" style="text-align: left;" width="150px;"] 
-> [Download the latest x64 stable installer (1.5.1)](https://aka.ms/windowsappsdk/1.5/latest/windowsappruntimeinstall-x64.exe)
+> [Download the latest x64 stable installer (1.5.2)](https://aka.ms/windowsappsdk/1.5/latest/windowsappruntimeinstall-x64.exe)
 
 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.
 
@@ -22,6 +22,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo
 
 | Version | Runtime downloads |
 |---|---|
+| [1.5.2 (1.5.240404000)](stable-channel.md#version-152-15240404000) <br/> 04/09/2024 <br/> [Release notes](stable-channel.md#version-152-15240404000) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.5.2) | [Installer (x64)](https://aka.ms/windowsappsdk/1.5/1.5.240404000/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.5/1.5.240404000/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.5/1.5.240404000/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.5/1.5.240404000/Microsoft.WindowsAppRuntime.Redist.1.5.zip) |
 | [1.5.1 (1.5.240311000)](stable-channel.md#version-151-15240311000) <br/> 03/12/2024 <br/> [Release notes](stable-channel.md#version-151-15240311000) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.5.1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.5/1.5.240311000/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.5/1.5.240311000/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.5/1.5.240311000/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.5/1.5.240311000/Microsoft.WindowsAppRuntime.Redist.1.5.zip) |
 | [1.5.0 (1.5.240227000)](stable-channel.md#version-15) <br/> 02/29/2024 <br/> [Release notes](stable-channel.md#version-15) <br/> [Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.5.0) | [Installer (x64)](https://aka.ms/windowsappsdk/1.5/1.5.240227000/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.5/1.5.240227000/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.5/1.5.240227000/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.5/1.5.240227000/Microsoft.WindowsAppRuntime.Redist.1.5.zip) |
 
diff --git a/hub/apps/windows-app-sdk/release-channels.md b/hub/apps/windows-app-sdk/release-channels.md
@@ -15,7 +15,7 @@ The following table provides an overview of the different release channels. For
 
 |         | Channel                                                 | Description                                                                                                                                                                | Release cadence                                                                    | Supported? | Latest release                                                                                      |
 |---------|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|------------|-----------------------------------------------------------------------------------------------------|
-| **✅**   | 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.5.1 (1.5.240311000)](stable-channel.md#version-151-15240311000) (03/12/2024)                                                 |
+| **✅**   | 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.5.2 (1.5.240404000)](stable-channel.md#version-152-15240404000) (04/09/2024)                                                 |
 | **❇️**  | 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.5.0-preview1](preview-channel.md#version-15-preview-1-150-preview1) (02/06/2024)                 |
 | **🔄️** | 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.5.0-experimental2](experimental-channel.md#version-15-experimental-150-experimental2) (01/25/2024) |
 
@@ -48,7 +48,7 @@ The Windows App SDK has a lifecycle. A lifecycle begins when a version or servic
 
 | Windows App SDK version | Original release date | Latest patch version | Patch release date | Support level | End of servicing |
 |-------------------------|-----------------------|----------------------|--------------------|---------------|----------------  |
-| 1.5                     | 02/29/2024            | 1.5.240311000        | 03/12/2024         | Current       | 02/28/2025       |
+| 1.5                     | 02/29/2024            | 1.5.240404000        | 04/09/2024         | Current       | 02/28/2025       |
 | 1.4                     | 08/29/2023            | 1.4.240211001        | 02/13/2024         | Maintenance   | 08/29/2024       |
 | 1.3                     | 04/12/2023            | 1.3.230724000        | 07/25/2023         | Maintenance   | 04/12/2024       |
 | 1.2                     | 11/10/2022            | 1.2.230313.1         | 03/15/2023         | Out of Support| 11/10/2023       |
diff --git a/hub/apps/windows-app-sdk/stable-channel.md b/hub/apps/windows-app-sdk/stable-channel.md
@@ -31,19 +31,72 @@ If you'd like to upgrade an existing app from an older version of the Windows Ap
 
 ## Version 1.5
 
+### Version 1.5.2 (1.5.240404000)
+
+This is a servicing release of the Windows App SDK that includes critical bug fixes for the 1.5 release and a new feature for Widget feed providers.
+
+#### Widget feed provider updates
+
+- Feed providers are now able to show announcements in the Widgets Dashboard:
+  - The new `FeedManager.TryShowAnnouncement` API allows a Feed Provider to request that the Widget Dashboard show their announcements. To show your announcement, create a `FeedAnnouncement` object and call the `FeedManager.TryShowAnnouncement` API.
+  - Feed announcements will have their own badges displayed in the taskbar that can be customized using the `FeedAnnouncement` API.
+- Feed providers can now opt in to receive Analytics and Error Reports information about their provider as a user interacts with it. To opt in, implement the `IFeedProviderAnalytics` and/or `IFeedProviderErrors` interfaces by your provider.
+
+The feed provider updates includes the following new APIs:
+
+```C#
+Microsoft.Windows.Widgets.Feeds.Providers
+ 
+    FeedAnalyticsInfoReportedArgs
+    FeedErrorInfoReportedArgs
+    FeedManager
+        SendMessageToContent
+        TryShowAnnouncement
+ 
+    FeedMessageReceivedArgs
+    FeedResourceRequest
+    FeedResourceRequestedArgs
+    FeedResourceResponse
+    IFeedAnnouncementInvokedTarget
+    IFeedManager2
+    IFeedProviderAnalytics
+    IFeedProviderErrors
+    IFeedProviderMessage
+    IFeedResourceProvider
+```
+
+```C#
+Microsoft.Windows.Widgets.Notifications
+ 
+    AnnouncementActionKind
+    AnnouncementTextColor
+    FeedAnnouncement
+    FeedAnnouncementInvokedArgs
+```
+
+### Bug fixes
+
+- Fixed an issue where `DispatcherTimer` would not fire at the correct time if the primary display wasn't running at 60 Hz.
+- Fixed an issue where a textbox input method editor (IME) window would be incorrectly positioned when running at a scale factor other than 100%. For more info, see GitHub issue [#9382](https://github.com/microsoft/microsoft-ui-xaml/issues/9382).
+- Fixed an issue where a drag-and-drop operation started from another app might not allow the correct Copy/Move/Link drop operations.
+- Fixed a potential crash when a ListView's `ItemsSource` is reset and given focus right away.
+- Fixed a problem where `ShouldConstrainToRootBounds="false"` popups/flyouts don't apply any inherited scale transform. For more info, see GitHub issues [#9118](https://github.com/microsoft/microsoft-ui-xaml/issues/9118) and [#9433](https://github.com/microsoft/microsoft-ui-xaml/issues/9433).
+- Fixed a potential crash when a Composition object is destroyed with an animation still running.
+- Fixed a potential crash on shutdown in `NavigationView::RevokeNavigationViewItemRevokers`.
+
 ### Version 1.5.1 (1.5.240311000)
 
 This is a servicing release of the Windows App SDK that includes critical bug fixes for the 1.5 release.
 
 - Fixed an issue where self-contained apps may fail to build due to not being able to copy "map.html".
-- Fixed an issue where `MapControl` would fail to initialize due to rejecting valid tokens. For more info, see GitHub [#9324](https://github.com/microsoft/microsoft-ui-xaml/issues/9324).
-- Fixed an issue where `MapControl` loaded with a blue background. For more info, see GitHub [#9377](https://github.com/microsoft/microsoft-ui-xaml/issues/9377).
-- Fixed an issue where clicking on the chevron of a `NavigationViewItem` did not correctly expand or collapse on a single click. This also caused menus to show as blank when clicking the chevron in `PaneDisplayMode="Top"` mode. For more info, see GitHub [#9423](https://github.com/microsoft/microsoft-ui-xaml/issues/9423) and [#9426](https://github.com/microsoft/microsoft-ui-xaml/issues/9426).
-- Fixed an issue where tapping on a `NavigationViewItem` with touch or pen would prevent the item from responding to any future input. For more info, see GitHub [#9429](https://github.com/microsoft/microsoft-ui-xaml/issues/9429).
-- Fixed a crash when clicking on an item in the `NavigationView.PaneFooter` area. For more info, see GitHub [#9396](https://github.com/microsoft/microsoft-ui-xaml/issues/9396).
-- Fixed an issue where icons in menus were sometimes showing in the wrong place. For more info, see GitHub [#9409](https://github.com/microsoft/microsoft-ui-xaml/issues/9409).
-- Fixed an issue where acrylic does not show on menus until switching away from the window and back. For more info, see GitHub [#9406](https://github.com/microsoft/microsoft-ui-xaml/issues/9406).
-- Fixed a crash which could occur during `TextBox`/`RichEditBox` initialization. For more info, see GitHub [#9216](https://github.com/microsoft/microsoft-ui-xaml/issues/9216).
+- Fixed an issue where `MapControl` would fail to initialize due to rejecting valid tokens. For more info, see GitHub issue [#9324](https://github.com/microsoft/microsoft-ui-xaml/issues/9324).
+- Fixed an issue where `MapControl` loaded with a blue background. For more info, see GitHub issue [#9377](https://github.com/microsoft/microsoft-ui-xaml/issues/9377).
+- Fixed an issue where clicking on the chevron of a `NavigationViewItem` did not correctly expand or collapse on a single click. This also caused menus to show as blank when clicking the chevron in `PaneDisplayMode="Top"` mode. For more info, see GitHub issues [#9423](https://github.com/microsoft/microsoft-ui-xaml/issues/9423) and [#9426](https://github.com/microsoft/microsoft-ui-xaml/issues/9426).
+- Fixed an issue where tapping on a `NavigationViewItem` with touch or pen would prevent the item from responding to any future input. For more info, see GitHub issue [#9429](https://github.com/microsoft/microsoft-ui-xaml/issues/9429).
+- Fixed a crash when clicking on an item in the `NavigationView.PaneFooter` area. For more info, see GitHub issue [#9396](https://github.com/microsoft/microsoft-ui-xaml/issues/9396).
+- Fixed an issue where icons in menus were sometimes showing in the wrong place. For more info, see GitHub issue [#9409](https://github.com/microsoft/microsoft-ui-xaml/issues/9409).
+- Fixed an issue where acrylic does not show on menus until switching away from the window and back. For more info, see GitHub issue [#9406](https://github.com/microsoft/microsoft-ui-xaml/issues/9406).
+- Fixed a crash which could occur during `TextBox`/`RichEditBox` initialization. For more info, see GitHub issue [#9216](https://github.com/microsoft/microsoft-ui-xaml/issues/9216).
 - Fixed some noisy exceptions which `NavigationView` threw and caught on destruction.
 - Fixed an issue where a "pinch to zoom" gesture would sometimes show up as a pan or tap due to an incorrect `PointerCaptureLost` message firing.
 
