Compartir a través de

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

  • Artículo

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.

Vínculos importantes:

Versión del canal estable más reciente:

Descargas para el SDK de Aplicaciones para Windows

Nota:

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

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

Características nuevas y actualizadas y problemas conocidos de la 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 más reciente.

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

Al reemplazar 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

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.