Notas de la versión del canal estable para el SDK de Aplicaciones para Windows

Artículo
03/02/2024

El canal estable proporciona versiones del SDK de aplicaciones de Windows compatibles con el uso de aplicaciones en entornos de producción. Las aplicaciones que usan la versión estable del SDK de aplicaciones de Windows también se pueden publicar en Microsoft Store.

Las siguientes versiones del canal estable están disponibles actualmente:

Versión 1.5
Versión 1.4
Versión 1.3
Versión 1.2
Versión 1.1
Versión 1.0
Versión 0.8
Versión 0.5

Si quiere actualizar una aplicación existente de una versión anterior del SDK de aplicaciones de Windows a una versión más reciente, consulte Actualización de proyectos existentes a la versión más reciente del SDK de aplicaciones de Windows.

Descargas del SDK de aplicaciones de Windows

Nota:

Las extensiones Windows App Visual Studio Extensions (VSIX) ya no se distribuyen como descarga independiente. Están disponibles en Visual Studio Marketplace dentro de Visual Studio.

Versión 1.5

Versión 1.5.1 (1.5.240311000)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.5.

Se ha corregido un problema por el que las aplicaciones autocontenidas podían no crearse debido a que no se podía copiar "map.html".
Se ha corregido un problema por el que MapControl no se inicializaba debido a la rechazo de tokens válidos. Para obtener más información, consulte 9324 de GitHub.
Se ha corregido un problema por el que MapControl se cargaba con un fondo azul. Para obtener más información, consulte 9377 de GitHub.
Se ha corregido un problema por el que al hacer clic en el contenido adicional de un NavigationViewItem botón no se expandía ni se contraía correctamente con un solo clic. Esto también hacía que los menús se mostraran en blanco al hacer clic en el botón de contenido adicional en el modo PaneDisplayMode="Top". Para obtener más información, consulte 9423 y 9426 de GitHub.
Se ha corregido un problema por el que al tocar NavigationViewItem con entrada táctil o lápiz impedía que el elemento respondiera a cualquier entrada futura. Para obtener más información, consulte 9429 de GitHub.
Se ha corregido un bloqueo al hacer clic en un elemento del área NavigationView.PaneFooter. Para obtener más información, consulte 9396 de GitHub.
Se ha corregido un problema por el que los iconos de los menús a veces se mostraban en el lugar incorrecto. Para obtener más información, consulte 9409 de GitHub.
Se ha corregido un problema por el que el acrílico no se mostraba en los menús hasta que se salía de la ventana y se volvía a ella. Para obtener más información, consulte 9406 de GitHub.
Se ha corregido un bloqueo que podía producirse durante la inicialización de TextBox/RichEditBox. Para obtener más información, consulte 9216 de GitHub.
Se han corregido algunas excepciones ruidosas que NavigationView lanzaba y capturaba con la destrucción.
Se ha corregido un problema por el que un gesto de "reducir o ampliar" a veces se mostraba como un movimiento panorámico o de toque debido a un desencadenamiento incorrecto del mensaje PointerCaptureLost.

Versión 1.5

En las secciones siguientes se describen las características nuevas y actualizadas y los problemas conocidos de la versión 1.5.

En una aplicación existente del SDK de aplicaciones de Windows 1.4, puede actualizar el paquete NuGet a la versión 1.5.240227000 (consulte la sección Actualización de un paquete en Instalación y administración de paquetes en Visual Studio mediante el Administrador de paquetes NuGet).

Para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de aplicaciones de Windows.

Actualizaciones de apagado y tiempo de ejecución de islas XAML

Hay una diferencia de funcionamiento entre WinAppSDK 1.4 y WinAppSDK 1.5 para aplicaciones basadas en islas XAML cuando se cierra la última ventana XAML en cualquier subproceso.

En WinAppSDK 1.4, el tiempo de ejecución de XAML siempre sale del bucle de eventos del subproceso cuando se cierra la última ventana XAML de un subproceso.
En WinAppSDK 1.5:
- Si la aplicación es una aplicación de escritorio de WinUI, el funcionamiento predeterminado sigue siendo el mismo que en WinAppSDK 1.4.
- Si usa XAML para la API DesktopWindowXamlSource ("Islas XAML"), el funcionamiento predeterminado es ahora que XAML no sale automáticamente del bucle de eventos del subproceso.
- En ambos modos, puede cambiar este funcionamiento configurando la propiedad Application.DispatcherShutdownMode.

Para obtener más información, consulte la documentación de la propiedad Application.DispatcherShutdownMode cuando esté disponible. Esto completa la propuesta de GitHub N.º 8492.

Hay una diferencia de funcionamiento entre WinAppSDK 1.4 y WinAppSDK 1.5 para aplicaciones basadas en islas XAML durante el período de tiempo de ejecución de XAML:

En WinAppSDK 1.4, el tiempo de ejecución de XAML se apaga en un subproceso si todos los objetos WindowsXamlManager y DesktopWindowXamlSource de un subproceso determinado están cerrados o apagados, o si DispatcherQueue se ejecuta en ese subproceso (en este caso, el tiempo de ejecución de XAML se apaga durante la fase DispatcherQueue.FrameworkShutdownStarting).
En WinAppSDK 1.5, el tiempo de ejecución de XAML se apaga en un subproceso solo cuando se apaga DispatcherQueue que se ejecuta en ese subproceso (el tiempo de ejecución de XAML siempre se apaga durante la fase DispatcherQueue.FrameworkShutdownStarting).

Para obtener más información, consulte la documentación de la clase WindowsXamlManager cuando esté disponible.

Hay una diferencia de funcionamiento en WindowsXamlManager.InitializeForCurrentThread():

En WinAppSDK 1.4, WindowsXamlManager.InitializeForCurrentThread() devuelve una instancia única de un objeto WindowsXamlManager con cada llamada.
En WinAppSDK 1.5, WindowsXamlManager.InitializeForCurrentThread() devuelve una instancia existente si ya existe en el subproceso. Close/Dispose() ahora se omite.

Control de Mapas de WinUI

El control WinUI Maps ya está disponible. Este control se basa en WebView2 y Azure Maps, y proporciona las siguientes características:

Movimiento panorámico y zoom con los botones de mapa o la función táctil.
Cambio del estilo del mapa a satélite, terreno o vista de calle.
Adición mediante programación al mapa de chinchetas interactivas con iconos personalizables por los desarrolladores.
Personalización por parte del desarrollador de dónde se centra el mapa en la carga inicial.
Control para desarrolladores sobre la ocultación o visualización de los botones de movimiento panorámico, zoom y estilos de mapa.

WinUI 3 Maps Control

Nota:

Para usar el control Maps, necesitará una clave de Azure Maps. Para crear la clave, consulte la página de documentación de Azure Maps sobre cómo crear una aplicación web.

El control Maps es totalmente nuevo y agradecemos sus comentarios para evaluar su futura dirección.

Nuevo control SelectorBar

En la versión 1.5, hemos agregado un nuevo control SelectorBar para permitir que los usuarios cambien entre varias vistas de datos. Este control se conocía anteriormente como "SegmentedControl" en nuestra hoja de ruta 1.5.

WinUI 3 SelectorBar Control

Etiquetas en los comandos principales CommandBarFlyout

Los elementos visuales del CommandBarFlyout se han actualizado para que se vean una etiqueta de texto de los elementos del área de comandos principal si la propiedad Label ha cambiado a AppBarButton. Anteriormente, en los comandos principales del área CommandBarFlyout solo aparecía un icono, pero ahora pueden salir un icono y una etiqueta para mejorar la facilidad de uso.

WinUI 3 CommandBarFlyout Labels

Compatibilidad de WebView2 con el entorno o las opciones personalizados

El control WinUI WebView2 ahora presenta la opción de personalizar el objeto subyacente CoreWebView2 con un CoreWebView2Environment y CoreWebView2ControllerOptions personalizado. Esto permite al creador de la aplicación indicar una ruta alternativa desde la que cargar WebView2Runtime, elegir usar un userDataFolder diferente UserDataFolder o configurar opciones como IsPrivateModeEnabled y ScriptLocale.

Soporte para .NET 8

Se ha añadido más soporte a .NET 8 en una versión de mantenimiento reciente de la versión 1.4, pero que sigue manteniendo la advertencia sobre el uso de RID específicos de la plataforma. En la versión 1.5, hemos completado ese trabajo para que la advertencia ya no aparezca.

Depuración mejorada y disponibilidad de origen

Ahora insertamos información del servidor de origen de Github para el código en el repositorio microsoft-ui-xaml en nuestros símbolos públicos, lo que permite a los depuradores descargar automáticamente el código fuente. También hemos realizado otras correcciones y mejoras en nuestros símbolos en todo winAppSDK para mejorar el sistema de depuración.

Funcionalidad mejorada para depurar ciclos de diseño

Los ciclos de diseño de depuración en una aplicación WinUI pueden ser un desafío, por lo que en la versión 1.5 el objeto DebugSettings ahora presenta opciones para permitir un registro mejorado y puntos de interrupción para el proceso de diseño y así facilitar la depuración y corrección de ciclos de diseño en la aplicación.

Otras características nuevas de WinAppSDK

Se ha agregado compatibilidad con el modelo de implementación PublishSingleFile. Para obtener más información sobre PublishSingleFile, consulte la documentación de implementación de un solo archivo.
Se han agregado mejoras a la compatibilidad del lector de pantalla, la compatibilidad con el escalado de texto y otras características de accesibilidad.
Diferentes mejoras de estabilidad y rendimiento a partir de las incidencias de error pendientes de GitHub con prioridad.

Las nuevas características se publican de forma separada

Las nuevas versiones de las plantillas de Visual Studio de WinAppSDK para C# y C++ se publican a través de Visual Studio Marketplace y aparecerán unas semanas después de la versión 1.5. Con la nueva versión, las plantillas ahora se pueden publicar independientemente de las versiones de WinAppSDK, lo que nos aporta mucha más flexibilidad a la hora de distribuir actualizaciones a los clientes.

Otras características previstas anteriormente

En la versión 1.5, hemos progresado en las siguientes características que anunciamos en nuestra hoja de ruta, pero no las completamos. Seguirán implementándose en el calendario de la hoja de ruta 1.6.

Ventanas con pestañas
Inclusión de la acción arrastrar y soltar para WebView2
Investigaciones sobre la vista de tabla y los controles de entrada de lápiz

La iluminación dinámica se ha quitado de la hoja de ruta por el momento.

Problemas conocidos

Al usar bibliotecas que contienen recursos como archivos .xaml, puede que se genere un mensaje de error en tiempo de ejecución que indique que no se pueden encontrar esos recursos. En este caso, podría ser necesario insertar <ShouldComputeInputPris>true</ShouldComputeInputPris> en el archivo del proyecto para asegurarse de que esos recursos se incluyen.
Al hacer clic en el contenido adicional de un NavigationViewItem, ya no se expande o se oculta correctamente con un solo clic. Al hacer doble clic, sigue funcionando, al igual que al hacer clic en otra parte del NavigationViewItem.

Corrección de errores

Se ha corregido un problema por el que StackPanel se aplicaba el espaciado en los elementos ocultos. Para más información, consulte el problema 916 de GitHub.
Se han corregido problemas con los controles de desplazamiento que dejaban de funcionar después de cerrar otra ventana de la aplicación. Para obtener más información, consulte las incidencias de GitHub N.º 9292 y N.º 9355.
Se ha subsanado un bloqueo al cambiar DebugSettings.EnableFrameRateCounter a true antes de representar el primer fotograma. Para más información, consulte la incidencia n.º 2835 de GitHub.
Se ha corregido un posible error de compilación en C++ en el que algunos encabezados no incluían las dependencias necesarias. Tenga en cuenta que el cambio del orden #include podría afectar a algunas aplicaciones, como que posiblemente provocaría un error de compilación de IInspectable si la aplicación usa una versión de C++/WinRT anterior a 2023. Para más información, consulte el problema 9014 de GitHub.
Se ha corregido un problema por el que los vínculos de ElementName no funcionaban dentro de ItemsRepeaterDataTemplate. Para más información, consulte el problema 560 de GitHub.
Se han subsanado bloqueos al ejecutar una aplicación en Visual Studio con la barra de herramientas con la aplicación habilitada. Se necesita Visual Studio 17.8 Preview 2 o posterior para recibir todas las correcciones. Para más información, consulte el problema 8806 de GitHub.
Se ha corregido un problema por el que AnnotatedScrollbar podía bloquearse a veces al desplazarse rápidamente.
Se ha corregido un problema por el que el texto del menú a veces se truncaba.
Se ha corregido un problema por el que los consejos didácticos no se enfocaban correctamente. Para más información, consulte el problema 3257 de GitHub.
Se ha corregido un problema que bloqueaba la aplicación al establecer TailVisibility de TeachingTip en Contraído al iniciarse. Para más información, consulte el problema 8731 de GitHub.
Se ha corregido un problema con el modo en que se administraban los archivos PRI al usar bibliotecas. Para más información, consulte el problema 8857 de GitHub.
Se ha corregido un problema de la versión 1.5-experimental2 en la que no se generaba el archivo DLL de proyección. Para más información, consulte el problema 4152 de GitHub.
Se ha corregido un problema por el que el botón de puntos suspensivos en el elemento emergente de formato de texto de RichEditBox no mostraba correctamente la lista de acciones. Para más información, consulte el problema 9140 de GitHub.
Se ha corregido un problema por el que ListView no administraba correctamente las teclas de método abreviado del teclado. Para más información, consulte el problema 8063 de GitHub.
Se ha corregido un problema de infracción de acceso con el uso de AccessKey para cerrar una ventana. Para más información, consulte el problema 8648 de GitHub.
Se ha subsanado un bloqueo al usar una AccessKey para cerrar una ventana. Para más información, consulte el problema 9002 de GitHub.
Se ha corregido un problema que afectaba a la alineación del texto en un MenuFlyoutItem dentro de MenuBar. Para más información, consulte el problema 8755 de GitHub.
Se ha corregido un problema por el que el texto resaltado no permanecería resaltado al hacer clic con el botón derecho. Para más información, consulte el problema 1801 de GitHub.
Se ha corregido un problema que provocaba que las ventanas inactivas bloquearan la aplicación al cerrarse. Para más información, consulte el problema 8913 de GitHub.
Se ha corregido un problema que podía bloquear las aplicaciones al desplazarse con el botón central del mouse y hacer clic con el botón izquierdo inmediatamente después. Para más información, consulte el problema 9233 de GitHub.
Se ha corregido un problema que provocaba que las aplicaciones se bloquearan al iniciarse al usar un NavigationViewItem personalizado. Para más información, consulte el problema 8814 de GitHub.
Se ha corregido un problema de NavigationView por el que el botón de puntos suspensivos generaba un error incorrectamente. Para más información, consulte el problema 8380 de GitHub.
Se ha corregido un problema por el que SystemBackdrop no se representaba correctamente en una aplicación de varias ventanas. Para más información, consulte el problema 8423 de GitHub.
Se ha corregido un problema de duplicación al insertar en el principio de ObservableCollection Para más información, consulte el problema 8370 de GitHub.

Versión 1.4

Versión 1.4.5 (1.4.240211001)

Se trata de una versión de mantenimiento del SDK de Aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.4.

Se ha corregido un problema que podía bloquear aplicaciones al hacer clic en un botón del mouse mientras se desplazaba con la rueda del mouse. Para más información, consulte el problema 9233 de GitHub.
Se ha corregido un problema con activos duplicados al hacer referencia a una cadena de paquetes NuGet. Para más información, consulte el problema 8857 de GitHub.
Se han corregido varios problemas de BreadcrumbBar incluida una pérdida de memoria, un bloqueo cuando el menú de tres puntos estaba vacío y el menú de tres puntos estaba incorrectamente limitado dentro de la ventana.
Se ha corregido un posible bloqueo durante el apagado al liberar recursos gráficos.

Versión 1.4.4 (1.4.231219000)

Se trata de una versión de mantenimiento del SDK de Aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.4.

Se ha corregido un problema de seguridad de diagnóstico de WinUI 3.
Se ha corregido un problema de entrada por el que el cuadro de contraseña no mostraba el teclado en pantalla cuando se activaba a través de la función táctil. Para obtener más información, consulte el problema 8946 de GitHub.
Se ha corregido un problema que provocaba que el tamaño del archivo Microsoft.UI.Xaml.Controls.dll aumentase inesperadamente.
Se ha corregido un problema CommandBarFlyout que podía provocar bloqueos al establecer el foco.
Se ha actualizado la compatibilidad del SDK de Aplicaciones para Windows con el control de recursos específico de RID de .NET 8.
Se ha corregido un problema por el que algunas cadenas de intercambio se colocaban o se estiraban incorrectamente.

Versión 1.4.3 (1.4.231115000)

Se trata de una versión de mantenimiento del SDK de Aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.4.

Se ha corregido un problema por el que un menú podía aparecer sin un fondo durante un breve período de tiempo.
Se ha corregido un bloqueo que puede producirse en escenarios específicos de varios monitores.
Se ha corregido un problema por el que un menú contextual podía aparecer fuera de la pantalla.
Se ha corregido un problema con los estilos de ventana y la acción de maximización. Para más información, consulte la incidencia n.º 8996 de GitHub.
Se ha corregido un problema con islas por el que el Asistente de concentración se podía agarrar inesperadamente de otro control.
Se ha corregido un problema con el orden de tabulación en NavigationView.
Se ha corregido un problema de representación por el que podía aparecer una barra blanca en la parte superior de la barra de título. Para más información, consulte la incidencia n.º 8947 de GitHub.
Varias correcciones de rendimiento.

Versión 1.4.2 (1.4.231008000)

Se trata de una versión de mantenimiento del SDK de Aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.4.

Se ha corregido un problema de bloqueo en explorer.exe causado por una asignación excesiva de memoria y objetos.
Se ha corregido un problema de interacción de la barra de título que impedía que el botón Atrás funcionara correctamente.
Se ha corregido un problema que provocaba la generación de una advertencia en caso de que un archivo de origen se incluyera varias veces.
Se ha corregido un problema que afectaba al rendimiento del menú contextual.
Se ha corregido un problema de acceso directo .lnk que hacía que el .exe de destino apuntase siempre a la misma ubicación para los paquetes de la carpeta WindowsApps.
Se ha corregido un problema de DWriteCore que afectaba a la representación adecuada del texto Indic en determinadas fuentes.
Se ha corregido un problema en una vista de lista que impedía la navegación con el teclado adecuada hacia y desde elementos seleccionados anidados con Tab/Mayús + Tab.
Se ha corregido un problema que interrumpía el desplazamiento de los elementos ComboBox al tocar después de expandir ComboBox una segunda vez. Para más información, consulte la incidencia n.º 8831 de GitHub.
Se ha corregido un problema por el que los paquetes WinAppSDK no incluían los recursos localizados de WinUI para algunos idiomas.
Se ha corregido una incoherencia entre la forma en que el Explorador de archivos y XAML muestran el idioma preferido de un usuario.
Se ha corregido un problema de diseño en el Explorador de archivos que provocaba que una línea delgada se mostrara debajo de la pestaña activa.
Se ha corregido un problema por el que algunos aceleradores de teclado proporcionados por el marco no se localizaban correctamente. Para más información, consulte la incidencia n.º 2023 de GitHub.
Se ha corregido un problema con los controles RepeatButton que se desplazaban repetidamente al pulsarlos.
Se ha corregido el .exe del instalador de WinAppSDK para que tenga la información correcta sobre la versión de los recursos.

Versión 1.4.1 (1.4.230913002)

Se trata de una versión de mantenimiento del SDK de Aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.4.

Se han corregido problemas de rendimiento para mejorar el tiempo hasta el primer fotograma.
Se ha corregido un problema por el que los menús no respetaba RequestedTheme. Por ejemplo, era posible que este problema provocara la aparición de texto blanco en un fondo blanco. Para más información, consulte el problema 8756 de GitHub.
Se ha corregido un problema que provocaba que los fondos acrílicos a veces se vuelvan totalmente transparentes en algunos menús.
Se ha corregido un problema por el que XAML a veces provocaba que Windows repintara innecesariamente el fondo de pantalla de escritorio.
Se ha corregido la compatibilidad con TabNavigation = Local y TabNavigation = Cycle para ListView y GridView, que ahora permite navegar entre encabezados y elementos con e l tabulador, además de las teclas de dirección.
Se han corregido algunas excepciones ruidosas al descartar una información sobre herramientas. Para más información, consulte el problema 8699 de GitHub.

Versión 1.4

En las secciones siguientes se describen las características nuevas y actualizadas y los problemas conocidos de la versión 1.4.

En una aplicación existente del SDK de Aplicaciones de Windows 1.3, puede actualizar el paquete NuGet a la versión 1.4.230822000 (consulte la sección Actualización de un paquete en Instalación y administración de paquetes en Visual Studio mediante el Administrador de paquetes NuGet).

Para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de aplicaciones de Windows.

Barra de título personalizada + Fusión de la barra de título de AppWindow

La barra de título personalizada de WinUI 3 usa la implementación de la barra de título de AppWindow, junto con las API NonClientInputPointerSource, en segundo plano en la SDK 1.4 de Aplicaciones de Windows. Como resultado, ambas implementaciones de la barra de título ahora se comportan del mismo modo con las mismas características y limitaciones. Esto es totalmente compatible con versiones anteriores en todos los casos admitidos: cualquier aplicación con una barra de título definida de forma personalizada se comportará como antes. Pero ahora es más fácil para los desarrolladores de WinUI 3 que no estén familiarizados con las barras de título personalizadas entenderlas y utilizarlas aprovechando estas nuevas características:

Un mejor escenario predeterminado en el que el desarrollador no define específicamente un elemento de barra de título (que reemplaza la barra de título de reserva de WinUI 2)
Distintas regiones de arrastre en la barra de título, que permiten crear varias regiones de arrastre y colocar controles sobre los que se puede hacer clic en cualquier parte del área no cliente (área de la barra de título).
Regiones arrastrables en toda la aplicación que pueden colocarse en cualquier lugar de la aplicación o hacer que toda la aplicación sea arrastrable.
Mejor soporte temático que sustituye a la tematización basada en recursos
- Dado que las regiones de arrastre son transparentes, siguen el tema de la aplicación cada vez.
Más personalización: oculte los botones mín., máx. y cerrar; coloque iconos del sistema en la barra de título; o haga que diferentes regiones actúen como botones de subtítulo que reciben respuestas NCHITTEST.
Más libertad para el desarrollador que le permite combinar y coincidir con las API de la barra de título de AppWindow, como el uso de las API WinUI 3 de nivel superior para la mayoría de los escenarios, pero con las API de AppWindow mezcladas para el control de nivel inferior.

Actualizaciones de widgets

Se han añadido tres nuevas interfaces para que las implementen los proveedores de widgets: IWidgetProvider2, IWidgetProviderAnalytics y IWidgetProviderErrors. IWidgetProvider2 permite a los proveedores responder a la acción Personalizar invocada por el usuario, que es idéntica a la disponible para los widgets de 1ª parte. Los proveedores usan las IWidgetProviderAnalytics interfaces y IWidgetProviderErrors para recopilar datos de telemetría para sus widgets; los análisis y los eventos de error sobre los widgets se comunican a los respectivos proveedores de widgets. Las clases WidgetCustomizationRequestedArgs, WidgetAnalyticsInfoReportedArgs y WidgetErrorInfoReportedArgs se utilizan para comunicar información pertinente para admitir nuevas funcionalidades.

Islas XAML ya no es experimental.

Las islas XAML y la plataforma ContentIslands subyacente ya no son experimentales.

Actualmente, las islas XAML solo se prueban para su uso en aplicaciones de C++. Esta versión no incluye ningún elemento contenedor conveniente para su uso en WPF o WinForms.
DesktopWindowXamlSource y los tipos relacionados se han agregado en el espacio de nombres Microsoft.UI.Xaml.Hosting para islas XAML. XamlRoot.ContentIslandEnvironment se agregó para ayudar a acceder a la información subyacente de la isla para un elemento.
Se han introducido muchos tipos nuevos en el espacio de nombres Microsoft.UI.Content y en el espacio de nombres Microsoft.UI.Input como compatibilidad subyacente para islas XAML o para utilizar esta funcionalidad ContentIslands sin XAML.
Se ha agregado un nuevo DragDropManager (más tipos relacionados) en el espacio de nombres Microsoft.UI.Input.DragDrop para escenarios de isla.

ItemsView

Vamos a introducir un nuevo control de lista denominado y ItemsView una clase concreta ItemContainer correspondiente. ItemContainer es un contenedor ligero con estados de selección y objetos visuales integrados, que pueden ajustar fácilmente el contenido deseado y usarse con ItemsView para un escenario de control de colección.

El nuevo control ItemsView muestra una colección de datos. ItemsView es similar a los controles ListView y GridView, pero se compila utilizando los componentes ItemsRepeater, ScrollView, ItemContainer y ItemCollectionTransitionProvider. Ofrece la capacidad única de conectar implementaciones Layout o ItemCollectionTransitionProvider personalizadas. Otra ventaja clave es la capacidad de cambiar el diseño sobre la marcha mientras se conserva la selección de elementos. El control interno ScrollView también ofrece características no disponibles en el control ScrollViewerde ListView/GridView, como la capacidad de controlar la animación durante los desplazamientos mediante programación.
- Una nueva propiedad ItemTransitionProvider en ItemsRepeater (y el nuevo control ItemsView) permite especificar un objeto ItemCollectionTransitionProvider para controlar las animaciones de transición en ese control. También se ha agregado un método CreateDefaultItemTransitionProvider a Layout, que permite que un objeto de diseño proporcione una transición de reserva que lo acompañe si no se proporciona una explícitamente en el control ItemsView.
- Una nueva propiedad IndexBasedLayoutOrientation sobre Layout en la que la orientación del diseño, si existe, de los elementos se basa en su índice en la colección de origen. El valor predeterminado es IndexBasedLayoutOrientation.None. Los diseños personalizados establecen esta propiedad llamando al nuevo método SetIndexBasedLayoutOrientation (protegido).
- Una nueva VisibleRect propiedad en VirtualizingLayoutContext obtiene el rectángulo de ventanilla visible dentro del FrameworkElement asociado a Layout. El método virtual VirtualizingLayoutContext.VisibleRectCore protegido se puede invalidar para proporcionar el valor que se devolverá de la propiedad VisibleRect.
La nueva clase LinedFlowLayout se usa normalmente para diseñar los elementos del control de colección ItemsView. Es especialmente útil para mostrar la colección de imágenes. Para ello, los coloca de izquierda a derecha y arriba abajo, en líneas de igual altura. Las imágenes llenan una línea horizontal y pasan a la siguiente. Las imágenes pueden recortarse por los bordes izquierdo y derecho para que quepan en una línea. También pueden expandirse horizontalmente y recortarse en los bordes superior e inferior para rellenar una línea cuando se emplea el modo de extensión.

Nuevas características de WinAppSDK

Una nueva clase ThemeSettings que permite a las aplicaciones Win32 WinRT detectar cuándo ha cambiado la configuración de alto contraste del sistema, similar a la clase AccessibilitySettings de UWP. Consulte la especificación de la API ThemeSettings en GitHub para obtener más información.
AccessKeyManager.EnterDisplayMode es un nuevo método para mostrar claves de acceso para el elemento enfocado actual de una raíz proporcionada. Las teclas de acceso están en "modo de visualización" al mostrar una sugerencia de teclas para invocar un comando, como presionar la tecla Alt en Paint para mostrar qué teclas corresponden a qué controles. Este método permite entrar mediante programación en el modo de visualización.
Application.ResourceManagerRequested proporciona un mecanismo para proporcionar un valor diferente IResourceManager para resolver los URI de recursos en escenarios en los que el valor predeterminado ResourceManager no funcionará. Para obtener más información, consulte la especificación de la API Application.ResourceManagerRequested en GitHub.
La versión del SDK de WebView2 se actualizó de 1661.34 a 1823.32.
Popup/FlyoutBase.IsConstrainedToRootBounds = false ahora se admite, lo que permite que un elemento emergente o control flotante se extienda fuera de los límites de la ventana primaria. Se ha agregado una propiedad SystemBackdrop a estos tipos para poder tener acrílicos en estas ventanas emergentes sin restricciones. Los menús usan esto de forma predeterminada para tener acrílico.
Closed, FrameworkClosed, y IsClosed se han agregado a DesktopAcrylicController y MicaController para mejorar el control durante el apagado de objetos o subprocesos.
DesktopAcrylicController.Kind ahora se puede establecer para elegir entre algunas apariencias acrílicas estándar.
DispatcherQueue tiene algunos nuevos eventos y asistentes para facilitar un cierre mejor organizado y para que las aplicaciones que utilizan Islas puedan ejecutar fácilmente un bucle de eventos estándar compatible.
InputNonClientPointerSource en el espacio de nombres Microsoft.UI.Input se puede utilizar para escenarios personalizados de barra de título para definir regiones de área que no sean cliente. El código puede registrarse para los eventos correspondientes, como los eventos "mantener el puntero y hacer clic" en eventos en estas regiones.
AppWindow tiene algunos nuevos asistentes para conseguir y asociar con un DispatcherQueue.
El nuevo evento TreeView.SelectionChanged permite a los desarrolladores responder cuando el usuario o el código subyacente cambian el conjunto de nodos seleccionados en el control TreeView.
El nuevo ScrollViewcontrol proporciona una nueva alternativa a ScrollViewer. Este nuevo control está muy alineado en cuanto al funcionamiento y la API con el control existente ScrollViewer, pero se basa en InteractionTracker, tiene nuevas características, como cambios de vista controladas por animaciones, y también está diseñado para garantizar la funcionalidad completa de ItemsRepeater. Vea Un ScrollViewer más flexible; incidencia n.º 108 microsoft/microsoft-ui-xaml (github.com) para obtener más detalles. Varios tipos nuevos, incluidos ScrollPresenter, forman parte del modelo general ScrollView.
El nuevo control AnnotatedScrollBar amplía la funcionalidad de una barra de desplazamiento normal proporcionando una manera fácil de navegar por una gran colección de elementos. Esto se logra a través de un raíl en el que se puede hacer clic con etiquetas que actúan como marcadores. También permite una comprensión más detallada del contenido desplazable mostrando información sobre herramientas al mantener el puntero sobre el raíl en el que se puede hacer clic.

Problemas conocidos

Cuando se usa ExtendsContentIntoTitleBar = true, los clics en la esquina superior izquierda de la ventana siempre muestran, de manera predeterminada, el menú de la ventana del sistema (Minimizar/Cerrar/etc.) en lugar de permitir que el puntero entre en el contenido de la ventana. Esto, por ejemplo, significa que un botón Atrás de esa área de la barra de título no funcionará. Una solución alternativa para este problema es establecer AppWindow.TitleBar.IconShowOptions = Microsoft.UI.Windowing.IconShowOptions.HideIconAndSystemMenu en el elemento AppWindow de la ventana.
Hay algunas nuevas excepciones continuas al ocultar elementos emergentes o controles flotantes de ShouldConstrainToRootBounds="False". Esto incluye ocultar información sobre herramientas, como se indica aquí: Descarte de información sobre herramientas produce 4 excepciones nativas; incidencia n.º 8699 · microsoft/microsoft-ui-xaml (github.com)
Enç1.4, los botones de subtítulo mín/máx/cerrar para ExtendsContentIntoTitleBar = true ahora se dibujan mediante AppWindow en lugar de XAML. Esto es por diseño, pero puede afectar a las aplicaciones que reemplazaban los estilos internos de XAML para ocultar o realizar una personalización adicional de estos botones, como en este informe: No se puede ocultar botón de subtítulo en la barra de título; incidencia n.º 8705 · microsoft/microsoft-ui-xaml (github.com)
En .NET 8 se ha producido un cambio importante en la forma de controlar el gráfico de identificadores en tiempo de ejecución: [Cambio importante]: Los proyectos orientados a .NET 8 y posteriores utilizarán de manera predeterminada un gráfico RID más pequeño y portátil; incidencia nº. 36527 - dotnet/docs (github.com). Debido a este problema y a que .NET 8 aún no se ha publicado oficialmente, el SDK 1.4 de Aplicaciones de Windows no es compatible oficialmente con .NET 8. Sin embargo, si desea seguir teniendo como destino la versión preliminar de .NET 8 con esta versión del SDK de aplicaciones, se recomiendan los pasos siguientes:
- Se recomienda establecer UseRidGraph en true. También deberá actualizar la propiedad <RuntimeIdentifiers> del archivo .csproj a <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>, así como actualizar cada archivo Propeties\*pubxml para cambiar de win10 a win en la propiedad <RuntimeIdentifier> (por ejemplo, <RuntimeIdentifier>win-x86</RuntimeIdentifier>).
Con el SDK 1.4 de Aplicaciones de Windows, el destino GenerateDeploymentManagerCS de Microsoft.WindowsAppSDK.DeploymentManager.CS.targets se cambió a GenerateBootstrapCS.
El fondo MenuFlyout no utiliza el tema solicitado de la aplicación:
- El texto menuFlyoutItem no se sincroniza con el tema del sistema. · Incidencia n.º 8678 · microsoft/microsoft-ui-xaml (github.com)
- Versión preliminar 1.4: el tema de fondo flotante se deriva del tema del sistema y no de su elemento asociado; incidencia n.º 8756 microsoft/microsoft-ui-xaml (github.com)

Correcciones de errores

Se ha corregido un problema por el que la llamada a la API Microsoft.Windows.AppLifecycle.AppInstance.Restart("") provocaba el bloqueo de las aplicaciones no empaquetadas. Para más información, consulte la incidencia 2792 de GitHub.
Se ha corregido un problema de bloqueo del instalador que se introdujo en la versión 1.4-experimental1. Para más información, consulte la incidencia n.º 3760 de GitHub.
Se ha corregido un problema por el que el texto tachado no se eliminaba correctamente en un TextBlock. Para más información, consulte la incidencia n.º 1093 de GitHub.
Se ha corregido un problema que provocaba una navegación incorrecta de Mayús + Tab en un Panel con TabFocusNavigation establecido en "Una vez". Para más información, consulte la incidencia n.º 1363 de GitHub.
Se ha corregido un problema en C++/WinRT que impedía que {x:Bind} funcionara correctamente con una propiedad de un control XAML con nombre. Para más información, consulte la incidencia n.º 2721 de GitHub.
Se ha solucionado un problema de AccessViolation en el entorno de ejecución en aplicaciones de escritorio WinUI causado por la configuración de DebugSettings.EnableFrameRateCounter = true. Para más información, consulte la incidencia n.º 2835 de GitHub.
Se ha corregido un problema por el que XamlTypeInfo.g.cpp no incluía los encabezados necesarios. Para más información, consulte la incidencia n.º 4907 de GitHub.
Se ha corregido un problema de bloqueo causado por la entrada simultánea multitáctil y mouse. Para más información, consulte la incidencia n.º 7622 de GitHub.
Se ha corregido un problema que impedía que una ventana de aplicación de WinUI 3 activa se desplazase cuando estaba activa la configuración del sistema para deshabilitar el desplazamiento de ventanas inactivas al pasar el mouse por encima. Para más información, consulte la incidencia n.º 8764 de GitHub.
Se ha corregido un bloqueo al probar la subclase MediaPlayerElement.
Se han corregido algunos problemas de pérdida de memoria y bloqueo en TreeView.
Se ha corregido un problema de bloqueo de la aplicación que podía producirse al usar el teclado para navegar por RadioButtons.
Se ha corregido un bloqueo al usar el teclado para navegar por PipsPager.
Se ha corregido el contenido de WebView2 para que se ajuste a la configuración de accesibilidad "Tamaño del texto" de la aplicación Configuración.
Se ha corregido un bloqueo que podía producirse cuando se ejecutaban animaciones con la pantalla apagada.
Se ha corregido un problema de rendimiento introducido en la versión 1.3 que agregaba una sobrecarga de ~10 % al primer diseño o representación.

Versión 1.3

Versión 1.3.3 (1.3.230724000)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.3.

Se ha corregido un problema por el que, en ocasiones, el mouse dejaba de funcionar al cerrar un cuadro de diálogo.
Se ha corregido un problema de implementación que impedía que las aplicaciones se instalaran debido a la falta de coincidencia de las versiones de los paquetes en el sistema. Para más información, consulte la incidencia n.º 3740 de GitHub.
Se ha corregido un problema que afectaba al posicionamiento del menú contextual en el SDK 1.3 de Aplicaciones de Windows.
Se ha corregido un problema que provocaba que algunas aplicaciones WinUI3, en algunas situaciones, se bloquearan al cerrar la aplicación porque XAML se cerraba demasiado pronto.
Se ha corregido un problema por el que los iconos de fuente no se reflejaban correctamente en los idiomas de derecha a izquierda. Para más información, consulte la incidencia n.º 7661 de GitHub.
Se ha corregido un problema que provocaba que una aplicación se bloqueara al cerrarse cuando los recursos se descomponían en un orden incorrecto. Para más información, consulte la incidencia n.º 7924 de GitHub.

Versión 1.3.2 (1.3.230602002)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.3.

Se ha corregido un bloqueo al establecer un cursor protegido.
Se ha corregido un problema de rendimiento en XamlMetadataProvider durante el inicio de la aplicación. Para más información, consulte el problema 8281 de GitHub.
Se ha corregido un problema con los hipervínculos y la entrada táctil en un RichTextBlock. Para más información, consulte el problema 6513 de GitHub.
Se ha corregido un problema con el desplazamiento y los paneles táctiles en WebView2. Para más información, consulte el problema 7772 de GitHub.
Se ha corregido un problema por el que una actualización de SDK de Aplicaciones para Windows a veces requería un reinicio de Visual Studio. Para más información, consulte el problema 3554 de GitHub.
Se ha corregido una excepción ruidosa al apagarse cuando se ejecutaba en un depurador.

Versión 1.3.1 (1.3.230502000)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.3.

Se ha corregido un problema que hacía que las aplicaciones se bloquearan al establecer SystemBackdrop si el contenido era nulo. Para más información, consulte el problema 8416 de GitHub.
Se ha corregido un problema que hacía que las aplicaciones se bloquearan al establecer el título de la ventana en XAML, una nueva funcionalidad agregada en la versión 1.3.0. Para más información, consulte el problema 3689 de GitHub.
Se ha corregido un problema donde una ventana se centraba incorrectamente cuando cambiaba su contenido.
Se ha corregido un problema con la creación de proyectos de C++ con las plantillas de proyecto de WinAppSDK 1.3.
Plantillas actualizadas en Visual Studio Marketplace

Versión 1.3

En las secciones siguientes se describen las características nuevas y actualizadas y los problemas conocidos de la versión 1.3.

En una aplicación existente del SDK de aplicaciones de Windows 1.2, puede actualizar el paquete NuGet a la versión 1.3.230331000 (consulte la sección Actualización de un paquete en Instalación y administración de paquetes en Visual Studio mediante el Administrador de paquetes NuGet).

Para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de aplicaciones de Windows.

API de fondo de XAML

Con las propiedades integradas en la ventana XAML, los fondos de acrílico en el fondo y Mica son ahora más fáciles de usar en su aplicación WinUI 3. Consulte los documentos de API Fondo del sistema y Fondo de Mica para más información sobre las propiedades de fondo XAML.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Reemplazando varias líneas de código reutilizable, ahora puede usar las API de AppWindow directamente desde una ventana mediante Window.AppWindow.

Nuevas características de WinAppSDK

ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId que reemplaza el valor MddGetGenerationId en desuso.
Administrador de entornos: EnvironmentManager.AreChangesTracked para informarle de si los cambios realizados en el administrador de entornos se pueden realizar en la aplicación.
Ahora se genera un nuevo evento, DebugSettings.XamlResourceReferenceFailed, cuando no se puede resolver una búsqueda Static/ThemeResource a la que se hace referencia. Este evento proporciona acceso a un seguimiento que detalla dónde se busca esa clave en el marco para poder depurar mejor los errores de búsqueda estáticos y de ThemeResource. Para más información, consulte la especificación de API Seguimiento de errores de búsqueda de referencia de recursos XAML en GitHub.

Otras actualizaciones

Consulte nuestro hito de WinAppSDK 1.3 en GitHub de WinAppSDK para ver otros problemas corregidos en esta versión.
Consulte nuestro hito de WinUI 3 en WinAppSDK 1.3 en microsoft-ui-xaml en GitHub para ver otros problemas corregidos en esta versión.
Con el VSIX experimental más reciente, ahora puede convertir la aplicación de sin empaquetar a empaquetada y viceversa mediante el menú de Visual Studio en lugar de usar el archivo de proyecto.

Problema conocido

Debido a un cambio reciente en el compilador de XAML, un proyecto existente que se actualiza a la versión 1.3 puede experimentar un error de compilación como el siguiente en Visual Studio:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Esto se debe a que Visual Studio usa un archivo DLL de tareas del compilador de XAML almacenado en caché de la versión 1.2, pero lo controla con lógica de MSBuild incompatible de la versión 1.3, como se muestra en el texto de error anterior. La solución alternativa consiste en apagar Visual Studio, reiniciarlo y volver a cargar la solución.

Versión 1.2

Versión 1.2.5 (1.2.230313.1)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.2.

Se ha corregido un problema que hacía que las aplicaciones se bloquearan durante el apagado de Composition.
Se ha corregido un problema que hacía que las aplicaciones continuaran ejecutando animaciones incluso cuando la pantalla estaba desactivada.
Se ha corregido un problema que provocaba un error en la entrada táctil y del mouse en WebView2 cuando la entrada del mouse y el teclado se producían simultáneamente. Para más información, consulte el problema 3266 de GitHub.

Versión 1.2.4 (1.2.230217.4)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.2.

Se ha corregido un problema que hacía que las aplicaciones independientes no pudieran establecer la configuración de UAC. Para más información, consulte el problema 3376 de GitHub.
Se ha corregido un problema que hacía que las notificaciones push devolvieran una hora de expiración inexacta con PushNotificationChannel::ExpirationTime. Para más información, consulte el problema 3300 de GitHub.
Se ha corregido un problema que hacía que los números negativos se consideraran "no válidos" al pasar un valor doble como parámetro a una función x:Bind.
Varias correcciones para actualizar VSIX de WinUI. Estas actualizaciones incluían la simplificación de la plantilla de proyecto dipAwareness en app.manifest, la eliminación de las plantillas para UWP, la actualización de archivos de recursos localizados, la adición del identificador de teléfono para desbloquear el envío de Store y la eliminación del aviso de copyright y la licencia. Para más información, consulte los problemas 5659, 3205, 3323, 3322 y 3143 de GitHub.

Versión 1.2.3 (1.2.230118.102)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.2.

Se ha corregido un problema que hacía que las aplicaciones WinUI 3 se bloquearan cuando se cerraban varias ventanas.
Se ha corregido un problema que provocaba un bloqueo al cerrar la aplicación cuando se llamaba a dos o más referencias a la interfaz ThreadPoolTimer. Para más información, consulte los problemas 7260 y 7239 de GitHub.
Se ha corregido un problema que hacía que todas las aplicaciones MSIX de un solo proyecto se ejecutaran como de plena confianza. Para más información, consulte el problema 7766 de GitHub.

Versión 1.2.2 (1.2.221209.1)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye correcciones de errores críticos de la versión 1.2.

Se ha corregido un problema que hacía que los paquetes de instalación previa y de Store (por ejemplo, del instalador, NuGet y el programa previo) no se instalaran si el otro ya estaba instalado. Para más información, consulte el problema 3168 de GitHub.
Se ha corregido un problema que provocaba la falta de efectos de elasticidad y curvas de animación al desplazarse con un panel táctil. Para más información, consulte el problema 7874 de GitHub.
Se ha corregido un problema en ListView que provocaba pérdidas de memoria.
Se ha corregido un problema que hacía que la plantilla Button no respetase la propiedad Foreground después de situar el puntero del mouse. Para más información, consulte el problema 7208 de GitHub.
Se ha corregido un problema que provocaba una excepción innecesaria cuando no había ningún objeto MediaPlaybackItem en un objeto MediaElement.
Se ha corregido un problema que hacía que apareciera un marco blanco en MediaPlayerElement en las transiciones de contenido.
Se han corregido problemas adicionales que hacían que App.UnhandledException no detectara excepciones de otros subprocesos. Para más información, consulte los problemas 1259 y 5221 de GitHub.

Versión 1.2.1 (1.2.221116.1)

Se trata de una versión de mantenimiento del SDK de aplicaciones de Windows que incluye una corrección de errores críticos de la versión 1.2.

Se ha corregido un problema que provocaba un bloqueo al iniciarse en aplicaciones WinUI 3 de C++ al agregar un control WebView2 o TextBox. Para obtener más información, consulte los problemas 7911 y 3117 de GitHub.

Versión 1.2

En las secciones siguientes se describen las características nuevas y actualizadas, las limitaciones y los problemas conocidos de la versión 1.2.

Nota

Visual Studio 2019 y .NET 5 ya no se admiten para la creación de aplicaciones de C# (consulte El SDK de aplicaciones de Windows 1.2 se ha pasado a WinRT 2.0 en C#). Necesitará Visual Studio 2022 y una de las siguientes versiones del SDK de .NET: 6.0.401 (o posterior), 6.0.304, 6.0.109. Cuando se lance, WinAppSDK 1.2 también admitirá .NET 7.

Para actualizar la versión del SDK de .NET, instale la versión más reciente de Visual Studio 2022 o vaya a Descargas de .NET. Al actualizar el paquete NuGet sin la versión necesaria del SDK de .NET, verá un error parecido a este: "Esta versión de WindowsAppSDK requiere .NET 6+ y la versión 2.0 o posterior de WinRT.Runtime.dll". Para actualizar el proyecto de .NET 5.0 a .NET 6.0, abra el archivo de proyecto y cambie "TargetFramework" a net6.0 y "Target OS version" al valor que corresponda (por ejemplo, net6.0-windows10.0.19041.0).

Widgets de terceros en Windows

El panel de widgets se introdujo por primera vez en Windows 11 y estaba limitado a mostrar los widgets integrados. Los widgets son pequeños contenedores de interfaz de usuario que muestran texto y gráficos en el panel de widgets, y están asociados a una aplicación instalada en el dispositivo. Con el SDK de Aplicaciones para Windows, como desarrollador de terceros, ahora puede crear widgets para aplicaciones Win32 empaquetadas y probarlos localmente en el panel de widgets de Windows 11.

Para obtener más información sobre los widgets, consulte Introducción a los widgets.

Para empezar a desarrollar widgets para una aplicación, consulte la documentación sobre desarrollo para proveedores de widgets y los Aspectos básicos del diseño de widgets para conocer los requisitos previos y obtener instrucciones y procedimientos recomendados.

Los requisitos previos para esta versión son los siguientes:

Modo de desarrollador habilitado en la máquina de desarrollo.
La máquina de desarrollo debe ejecutar una versión de Windows del Canal de desarrolladores de Windows Insider Preview (WIP) que sea igual o posterior a la versión 25217, con la versión 521.20060.1205.0 o posterior del panel de widgets.

Limitaciones conocidas del desarrollo de widgets

Los widgets de terceros solo se pueden probar localmente en dispositivos inscritos en WIP para esta versión preliminar.
Solo se pueden crear widgets para aplicaciones Win32 empaquetadas. Está previsto admitir widgets para aplicaciones web progresivas en Microsoft Edge 108.

DisplayInformation

Ahora las aplicaciones de escritorio de Windows pueden admitir Alto rango dinámico (HDR) y Administración automática de colores (ACM) a través de la clase DisplayInformation del SDK de Aplicaciones para Windows. La clase DisplayInformation permite supervisar la información relacionada con la pantalla para la vista de una aplicación. Esto incluye eventos para permitir que los clientes supervisen los cambios en la vista de la aplicación que afectan a las pantallas en las que reside la vista, así como los cambios en las pantallas que pueden afectar a la vista de la aplicación.

WinUI 3

Las aplicaciones de WinUI 3 pueden reproducir audio y vídeo con los controles de reproducción multimedia MediaPlayerElement y MediaTransportControls. Para obtener más información sobre cómo y cuándo usar controles multimedia, consulte Instancias de Media Player.

WinUI 3 se ha actualizado con los controles, estilos y acciones más recientes de WinUI 2.8. Estas actualizaciones incluyen la adición del control InfoBadge, mejoras de accesibilidad y del modo de contraste alto, así como correcciones de errores en los controles. Para obtener más información, consulte las notas de la versión de WinUI 2.7 y WinUI 2.8.

Problemas corregidos:

Ya se admite el material de fondo Acrylic con DesktopAcrylicController en aplicaciones de Windows 10. Para obtener más información, consulte el problema 7112 en GitHub.
Se han corregido varios problemas que provocaban un error en el enrutamiento de App.UnhandledException. Para obtener más información, consulte el problema 5221 en GitHub. Con respecto a los problemas restantes, se han documentado soluciones alternativas en los siguientes problemas de GitHub y se resolverán en una futura versión 1.2:
- La excepción UnhandledExceptionEventArgs.Exception de App_UnhandledException solo se puede capturar una vez; debe almacenarse en caché
- Los controladores de eventos o de devolución de llamadas Do_Abi_* deben encapsular las invocaciones con RoReportUnhandledError
Se ha corregido un problema que hacía que los estilos de ListView retrocedieran y cambiaran a partir de WinAppSDK 1.1. Para obtener más información, consulte el problema 7666 en GitHub.
Se ha corregido un problema por el que aparecía el color de fondo alternativo Mica incorrecto cuando la aplicación estaba inactiva. Para obtener más información, consulte el problema 7801 en GitHub.

Restricciones conocidas

Al crear un nuevo proyecto de WinUI 3 con Visual Studio 2022 17.4.0, hará referencia a una versión preliminar del SDK de Aplicaciones para Windows. Use el Administrador de paquetes NuGet para actualizar la referencia a esta versión.
Se produce un error al establecer MediaPlayerElement.Source en el URI relativo (ms-appx/ms-resource) en aplicaciones no empaquetadas. La solución alternativa recomendada es convertir el URI relativo ms-appx:/// en un URI de tipo file:/// totalmente resuelto.

Recorte de aplicaciones desarrolladas con .NET

Los desarrolladores de .NET ahora pueden publicar aplicaciones de WinAppSDK recortadas. Con CsWinRT 2.0, las proyecciones de C#/WinRT distribuidas en WinAppSDK ahora se pueden recortar. La publicación de una aplicación recortada puede reducir la superficie de disco de la aplicación al quitar cualquier código sin usar de los archivos binarios recortables. Las aplicaciones también pueden experimentar una mejora del rendimiento en el inicio. Con una aplicación Hola mundo básica, hemos visto una mejora en la superficie de disco de aproximadamente el 80 % y una mejora del rendimiento en el inicio de aproximadamente el 7 % al publicarla recortada. Con la galería de WinUI, hemos visto una mejora aproximada del 45 % en la superficie de disco.

Para obtener más información sobre cómo habilitar el recorte, las limitaciones de recorte (como la reflexión con tipos recortables) y las advertencias de recorte, consulte Recorte de implementaciones autocontenidas y ejecutables. Los desarrolladores deben probar exhaustivamente las aplicaciones después de recortarlas para asegurarse de que todo funciona según lo previsto. Para obtener más información, consulte el problema 2478 en GitHub.

Compatibilidad con Visual Studio Arm64

Ya en Project Reunion (ahora WinAppSDK) 0.5, las aplicaciones desarrolladas con WinAppSDK podían ejecutarse en Arm64. A partir de Visual Studio 17.3 Preview 2, se pueden desarrollar aplicaciones nativas con WinAppSDK en dispositivos Arm64.

Para empezar a desarrollar aplicaciones en un dispositivo Arm64, consulte Windows en Arm y Visual Studio Arm64.

Notificaciones

Se ha introducido AppNotificationBuilder como alternativa a la carga XML para crear y definir notificaciones de aplicación.

Para obtener información de uso, consulte la especificación AppNotificationBuilder en GitHub.

Consulte también Inicio rápido: Notificaciones de aplicación en el SDK de Aplicaciones para Windows para ver un ejemplo de cómo crear una aplicación de escritorio de Windows que envía y recibe notificaciones de una aplicación local.

Cambio importante

En el caso de las notificaciones push, al realizar una llamada de solicitud de canal, las aplicaciones deberán usar el identificador de objeto de Azure en lugar del identificador de aplicación de Azure. Consulte Inicio rápido: Notificaciones push en el SDK de Aplicaciones para Windows para obtener más información sobre cómo buscar el identificador de objeto de Azure.

Problema corregido

PushNotificationManager.IsSupported comprobará si la aplicación está en modo elevado. Devolverá false si la aplicación está en modo elevado.

Limitaciones conocidas (notificaciones)

En AppNotificationScenario, Urgent se admite solamente a partir de la compilación 19041 de Windows. Puede usar AppNotificationBuilder.IsUrgentScenarioSupported para comprobar si la característica está disponible en tiempo de ejecución.
En AppNotificationButton, hint-toolTip y hint-buttonStyle se admiten solamente a partir de la compilación 19041. Puede usar IsButtonStyleSupported e IsToolTipSupported para comprobar si la característica está disponible en tiempo de ejecución.
En MediaPlayerElement, cuando se usa en el marcado XAML para una aplicación sin empaquetar, la propiedad Source no se puede establecer con un URI ms-appx o ms-resource. Como alternativa, establezca el origen con un URI de archivo o en el código.

Basado en ventanas

La personalización completa de la barra de título ya está disponible en Windows 10, a partir de la versión 1809, a través de la clase AppWindowTitleBar. Puede establecer AppWindowTitleBar.ExtendsContentIntoTitleBar en true para extender el contenido al área de la barra de título y SetDragRectangles para definir regiones de arrastre (además de otras opciones de personalización).

Si ha estado usando la propiedad AppWindowTitleBar.IsCustomizationSupported para comprobar si puede llamar a las API AppWindowTitleBar, ahora devuelve true en las versiones admitidas de Windows 10 (a partir de la versión 1809) para el SDK de Aplicaciones para Windows.

Limitaciones conocidas (ventanas)

Las personalizaciones básicas de la barra de título no se admiten en Windows 10, a saber: BackgroundColor, InactiveBackgroundColor, ForegroundColor, InactiveForegroundColor y IconShowOptions. Si llama a estas propiedades, se omitirán de forma silenciosa. Todas las demás API AppWindowTitleBar funcionan en Windows 10, a partir de la versión 1809. Para las API de color de los botones de la barra de título (entre otras) y Height, ExtendsContentIntoTitleBar debe establecerse en true. De lo contrario, también se omitirán de forma silenciosa.

Control de acceso

Se ha introducido security.accesscontrol.h con la función GetSecurityDescriptorForAppContainerNames para facilitar y simplificar el uso compartido de objetos con nombre entre los procesos empaquetados y las API generales de Win32. Este método toma una lista de nombres de familia de paquete (PFN) y máscaras de acceso, y devuelve un descriptor de seguridad. Para obtener más información, consulte la especificación GetSecurityDescriptorForAppContainerNames en GitHub.

Otros problemas conocidos y limitaciones

Importante

Al hacer referencia a WinAppSDK 1.2 en un proyecto, es posible que vea un error parecido a este: "Se detectó la degradación del paquete: Microsoft.Windows.SDK.BuildTools de 10.0.22621.1 a 10.0.22000.194"., que se debe a referencias al paquete incompatibles en el proyecto de aplicación y el paquete WinAppSDK. Para resolverlo, puede actualizar la referencia del proyecto a una versión más reciente y compatible de Microsoft.Windows.SDK.BuildTools.

Las pruebas unitarias pueden producir un error REGDB_E_CLASSNOTREG en el panel de salida Pruebas de Visual Studio. Como solución alternativa, agregue <WindowsAppContainer>true</WindowsAppContainer> al archivo del proyecto.
No se admite PublishSingleFile de .NET.
Los valores predeterminados de inicializador automático Bootstrapper y Undocked RegFree WinRT ahora solo se establecen para proyectos que generan un archivo ejecutable (OutputType=Exe o WinExe). Esto evita que se agreguen inicializadores automáticos en archivos DLL de biblioteca de clases y otros no ejecutables de forma predeterminada.
- Si necesita un inicializador automático en un archivo no ejecutable (por ejemplo, un archivo DLL de prueba cargado por un ejecutable genérico que no inicialice el programa previo) puede habilitar explícitamente un inicializador automático en el proyecto a través de <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize> o <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
Microsoft.WindowsAppRuntime.Release.Net.dll es siempre un archivo binario Arm64 y no funciona para aplicaciones x86 y x64. Cuando llame explícitamente a la API de arranque, no use el ensamblado Microsoft.WindowsAppRuntime.Release.Net.dll. Como solución alternativa, puede incluir constantes de versión en este archivo de código fuente que se distribuye con el paquete NuGet: “..\include\WindowsAppSDK-VersionInfo.cs”, o bien utilice el inicializador automático.

Versión 1.1

La versión más reciente disponible del linaje 1.1.x del canal estable del SDK de Aplicaciones para Windows es la versión 1.1.5. El linaje 1.1.x ofrece todas las características del canal de versión estable (consulte la sección Características disponibles por canal de versión en Canales de versión del SDK de Aplicaciones para Windows).