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

  • Artículo

Importante

El canal de versión preliminar no es compatible para el uso en entornos de producción, y las aplicaciones que utilizan las versiones preliminares no se pueden publicar en Microsoft Store.

El canal de versión preliminar incluye versiones del SDK de Aplicaciones para Windows con características del canal de versión preliminar en fases tardías de desarrollo. Las versiones preliminares no incluyen características experimentales y API, pero pueden estar sujetas a cambios importantes antes de la próxima versión estable.

Vínculos importantes:

Versión del canal de versión preliminar más reciente:

Versión del canal estable más reciente:

Versión 1.1, Preview 3 (1.1.0-preview3)

Esta es la versión más reciente del canal de versión preliminar para la versión 1.1. Admite todas las características del canal en versión preliminar (consulte Características disponibles por canal de versión).

En una aplicación existente que utilice el SDK de Aplicaciones para Windows 1.0, puede actualizar el paquete NuGet a la versión 1.1.0-preview3 (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). Además, para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de Aplicaciones para Windows más reciente.

Nota:

Para los desarrolladores de C#, se requiere como mínimo una de las siguientes versiones del SDK de .NET: 6.0.202, 6.0.104, 5.0.407, 5.0.213. Para actualizar la versión del SDK de .NET, vaya a Descargas de .NET o actualice a la versión más reciente de Visual Studio. Sin la versión necesaria del SDK de .NET, al actualizar el paquete NuGet obtendrá un error parecido a este: "Esta versión de WindowsAppSDK requiere la versión 1.6 o posterior de WinRT.Runtime.dll".

Además de todas las características de Preview 2, en las siguientes secciones se describen las características nuevas y actualizadas, las limitaciones y los problemas conocidos para esta versión.

WinUI 3 (1.1.0-preview3)

Mica y Acrylic (fondo) ya están disponibles para las aplicaciones de WinUI 3.

Para obtener más información sobre estos materiales, consulte Materiales en Windows 11. Consulte nuestro código de ejemplo para aplicar Mica en aplicaciones de C++ en Aplicación de materiales de mica o acrílico en aplicaciones de escritorio para Windows 11 y en aplicaciones de C# en GitHub como parte de la Galería de controles de WinUI.

Notificaciones (1.1.0-preview3)

Problemas corregidos:

  • En 1.1.0-preview1 y 1.1.0-preview2, los iconos de algunas aplicaciones sin empaquetar se habrá copiado incorrectamente en AppData\LocalMicrosoftWindowsAppSDK. Para esta versión, en su lugar se copiarán en AppData\Local\Microsoft\WindowsAppSDK. Para evitar la pérdida de iconos, debe eliminar manualmente el icono de la aplicación en la ruta de acceso incorrecta después de actualizar a 1.1.0-preview3.
  • Ahora se admiten el icono de aplicación y la recuperación del nombre para mostrar de la aplicación para las notificaciones de aplicación a través de accesos directos. Este icono de aplicación tendrá prioridad sobre cualquier icono que se especifique en los archivos de recursos.
  • Se ha restaurado la compatibilidad con las notificaciones push para aplicaciones sin empaquetar (consulte Limitaciones para la excepción indicada). Hemos introducido la API PushNotificationManager::IsSupported para comprobar si la aplicación admite notificaciones push.

Limitaciones:

  • No se admiten notificaciones para una aplicación sin empaquetar con privilegios elevados. PushNotificationManager::IsSupported no comprobará si la aplicación está en modo de privilegios elevados. Sin embargo, estamos trabajando para admitir esto en una versión futura.

Empaquetado MSIX

Hemos mejorado MSIX al agregar nuevas funcionalidades y ampliando las existentes a través de las categorías de extensión:

  • windows.appExecutionAlias
  • windows.customDesktopEventLog
  • windows.dataShortcuts
  • windows.fileTypeAssociation
  • windows.fileTypeAssociation.iconHandler
  • windows.folder
  • windows.shortcut

Es necesario instalar el paquete de marco del SDK de aplicaciones de Windows. Consulte Descargas del SDK de aplicaciones de Windows más reciente para instalar el entorno de ejecución.

Administrador de entornos (1.1.0-preview3)

Conjunto de API que permite a los desarrolladores agregar, quitar y modificar variables de entorno sin tener que utilizar directamente la API de registro.

Aclaración de la versión 1.1, Preview 1: La eliminación automática de cambios de cualquier variable de entorno cuando se desinstala una aplicación que utiliza el administrador de entornos solo está disponible para las aplicaciones empaquetadas. Además, la reversión de los cambios en las variables de entorno requiere la instalación del paquete de marco del SDK de Aplicaciones para Windows, consulte Descargas del SDK de Aplicaciones para Windows más reciente para el entorno de ejecución.

Otras limitaciones conocidas

Regresiones de la versión 1.1, Preview 2:

  • En el caso de las aplicaciones .NET que usan las API de MRT Core y las aplicaciones winUI que no se implementan con MSIX de un solo proyecto:
    • los archivos RESW y de imagen que se agregaron al proyecto como elementos existentes y que anteriormente se incluían automáticamente en PRIResource y Content ItemGroups, respectivamente, no se incluirán en esos ItemGroups. Como consecuencia, estos recursos no se indexarán durante la generación de PRI, por lo que no estarán disponibles durante el tiempo de ejecución.
      • Solución alternativa: Incluya manualmente los recursos en el archivo del proyecto y quítelos del elemento None ItemGroup.
      • Solución alternativa secundaria: Cuando esté disponible, actualice el SDK de .NET de las aplicaciones a la versión 6.0.300. Consulte Requisitos de versión para el SDK de .NET para obtener información adicional.
  • Para las aplicaciones de .NET que no se implementan con MSIX de un solo proyecto:
    • Si se agrega un archivo Content ItemGroup dos veces o más, se producirá un error de compilación.
      • Solución alternativa: Elimine las inclusiones duplicadas o establezca EnableDefaultContentItems en false en el archivo del proyecto.

Ambas regresiones se restaurarán en la próxima versión estable.

Versión 1.1, Preview 2 (1.1.0-preview2)

Esta es la segunda versión del canal de versión preliminar para la versión 1.1. Admite todas las características del canal en versión preliminar (consulte Características disponibles por canal de versión).

En una aplicación existente que utilice el SDK de Aplicaciones para Windows 1.0, puede actualizar el paquete NuGet a la versión 1.1.0-preview2 (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). Además, para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de Aplicaciones para Windows más reciente.

Nota:

Para los desarrolladores de C#, se requiere como mínimo una de las siguientes versiones del SDK de .NET: 6.0.202, 6.0.104, 5.0.407, 5.0.213. Para actualizar la versión del SDK de .NET, vaya a Descargas de .NET o actualice a la versión más reciente de Visual Studio. Sin la versión necesaria del SDK de .NET, al actualizar el paquete NuGet obtendrá un error parecido a este: "Esta versión de WindowsAppSDK requiere la versión 1.6 o posterior de WinRT.Runtime.dll".

Además de todas las características de Preview 1, en las siguientes secciones se describen las características nuevas y actualizadas, las limitaciones y los problemas conocidos para esta versión.

Notificaciones (1.1.0-preview2)

Problemas corregidos:

  • Una aplicación sin notificaciones de envío de identidades de paquete verá ahora su icono de aplicación en la notificación si el icono forma parte del recurso de la aplicación. Si el recurso de la aplicación no tiene ningún icono, se usa el icono de aplicación predeterminado de Windows.
  • Una aplicación WinUI 3 que no esté en ejecución ahora puede activarse en segundo plano a través de una notificación.

Regresión de la versión 1.1, Preview 1: Compatibilidad con notificaciones push para aplicaciones sin empaquetar. Se espera que se restaure en la próxima versión.

Limitaciones conocidas:

  • Hemos introducido la API PushNotificationManager::IsSupported para comprobar si las aplicaciones independientes admiten notificaciones push. Sin embargo, esta API aún no funciona según lo previsto, así que manténgase atento a la próxima versión preliminar para obtener compatibilidad completa con la API IsSupported.
  • Los iconos de algunas aplicaciones sin empaquetar se copiarán incorrectamente en AppData\LocalMicrosoftWindowsAppSDK. Para la próxima versión, en su lugar se copiarán en AppData\Local\Microsoft\WindowsAppSDK. Para evitar la pérdida de iconos, el desarrollador debe eliminar manualmente el icono de la aplicación en la ruta de acceso incorrecta después de actualizar a la próxima versión.
  • No se admiten el icono de aplicación y la recuperación del nombre para mostrar de la aplicación para las notificaciones a través de accesos directos. Sin embargo, estamos trabajando para su compatibilidad en una versión futura.

Implementación

Nuevas características:

Limitaciones conocidas:

  • La implementación independiente solo se admite en Windows 10, versión 1903 y posterior.

Basado en ventanas

Para facilitar el acceso mediante programación a la funcionalidad que se implementa en USER32.dll (consulte Windows y mensajes), esta versión muestra más de esa funcionalidad en la clase AppWindow propiamente dicha.

Nuevas características:

  • Las aplicaciones con ventanas existentes tienen más control sobre cómo se muestra una ventana, mediante una llamada a AppWindow.ShowOnceWithRequestedStartupState, el equivalente de ShowWindow(SW_SHOWDEFAULT).
  • Las aplicaciones pueden mostrar, minimizar o restaurar una ventana y especificar si la ventana se debe activar o no en el momento en que se realiza la llamada.
  • Las aplicaciones ahora pueden establecer el tamaño del área cliente de una ventana en coordenadas Win32.
  • Hemos agregado API para admitir la administración de orden z de las ventanas.
  • Las aplicaciones que dibujan barras de título personalizadas con AppWindowTitleBar.ExtendsContentIntoTitleBar pueden establecer una opción PreferredTitleBarHeight. Tiene una opción entre una barra de título de alto estándar o una barra de título alta que proporciona más espacio para el contenido interactivo. Consulte Barra de título en la guía de diseño de Fluent para obtener consejos sobre cuándo usar una barra de título alta.

Limitaciones conocidas:

  • La compatibilidad con la barra de título alta solo está disponible en Windows 11. Estamos trabajando para hacerlo compatible con versiones anteriores, junto con otras API de barra de título personalizadas.

WinUI 3 (1.1.0-preview2)

Problemas corregidos:

  • Se ha actualizado el SDK de WebView2 de la versión 1020.46 a la 1185.39 para corregir un problema que provocaba el bloqueo de las aplicaciones de C# con WebView2 en el inicio cuando no estaba instalado el entorno de ejecución de C/C++ (CRT).
  • Se ha corregido un problema por el que algunas esquinas redondeadas mostraban un degradado cuando debían tener un color sólido. Para obtener más información, consulte los problemas 6076 y 6194 en GitHub.
  • Se ha corregido un problema por el que faltaban estilos actualizados en el archivo generic.xaml.
  • Se ha corregido un problema de ciclo de diseño que hacía que una aplicación se bloqueara al desplazarse al final de un control ListView. Para más información, consulte el problema 6218 en GitHub.

Rendimiento

Las aplicaciones de C# tienen varias mejoras de rendimiento. Para obtener más información, consulte las notas de la versión de C#/WinRT 1.6.1.

Versión 1.1, Preview 1 (1.1.0-preview1)

Esta es la primera versión del canal de versión preliminar para la versión 1.1. Admite todas las características del canal en versión preliminar (consulte Características disponibles por canal de versión).

En una aplicación existente que utilice el SDK de Aplicaciones para Windows 1.0, puede actualizar el paquete NuGet a la versión 1.1.0-preview1 (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). Además, para obtener actualizaciones del entorno de ejecución y MSIX, consulte Descargas del SDK de Aplicaciones para Windows más reciente.

Las siguientes secciones describen las características nuevas y actualizadas , limitaciones y problemas conocidos para esta versión.

WinUI 3 (1.1.0-preview1)

Problema conocido: Los usuarios no pueden colocar un elemento cuando está habilitada la funcionalidad de arrastrar y colocar.

Compatibilidad con privilegios elevados (administrador)

Con el SDK de Aplicaciones para Windows 1.1, Preview 1, las aplicaciones (incluidas WinUI 3) podrán ejecutarse con privilegios elevados.

Limitaciones importantes:

  • Actualmente, solo está disponible en Windows 11. Pero estamos evaluando llevar la compatibilidad con versiones anteriores en una publicación futura.

Problemas conocidos:

  • Las aplicaciones WinUI 3 se bloquean al arrastrar un elemento durante una interacción de arrastrar y colocar.

Implementación autocontenida

El SDK de Aplicaciones para Windows 1.1 presentará compatibilidad con la implementación independiente. En Introducción a la implementación del SDK de Aplicaciones para Windows se detallan las diferencias entre la implementación independiente y dependiente del marco y cómo empezar.

Problemas conocidos:

  • Una aplicación de C++ empaquetada debe agregar lo siguiente al final de su archivo de proyecto para solucionar un error en el archivo autocontenido .targets que quita las referencias de marco a VCLibs:

    <PropertyGroup>
    <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
</PropertyGroup>

<Target Name="_RemoveFrameworkReferences"
    BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
        <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
    </ItemGroup>
</Target>

  • Solo se admite en Windows 10, 1903 y posterior.

Notificaciones (1.1.0-preview1)

Los desarrolladores de aplicaciones empaquetadas (incluidas las empaquetadas con ubicación externa) y las aplicaciones sin empaquetar ahora pueden enviar notificaciones de Windows.

Nuevas características:

  • Compatibilidad con notificaciones de aplicaciones en aplicaciones empaquetadas y sin empaquetar. Detalles completos en GitHub
    • Los desarrolladores pueden enviar notificaciones de aplicaciones, también conocidas como notificaciones del sistema, localmente o desde su propio servicio en la nube.
  • Compatibilidad con notificaciones push en aplicaciones empaquetadas y sin empaquetar. Detalles completos en GitHub
    • Los desarrolladores pueden enviar notificaciones sin procesar o notificaciones de aplicaciones desde su propio servicio en la nube.

Limitaciones:

  • Es posible que las aplicaciones publicadas como independientes no tengan compatibilidad con las notificaciones push. Preste atención a la próxima versión preliminar de una API IsSupported para comprobar si hay compatibilidad con las notificaciones push.
  • Las aplicaciones sin empaquetar que envían notificaciones de aplicación no verán su icono de aplicación en la notificación de aplicación, a menos que sean aplicaciones de consola. Las aplicaciones de consola sin empaquetar deben seguir los patrones que se muestran en el ejemplo ToastNotificationsDemoApp.
  • El entorno de ejecución del SDK de Aplicaciones para Windows debe estar instalado para admitir notificaciones push, consulte Descargas del SDK de Aplicaciones para Windows más reciente para el instalador.
  • Una aplicación WinUI 3 que no esté en ejecución puede activarse en segundo plano a través de una notificación. Sin embargo, estamos trabajando para su compatibilidad en una versión futura.

Administrador de entornos (1.1.0-preview1)

Conjunto de API que permite a los desarrolladores agregar, quitar y modificar variables de entorno sin tener que utilizar directamente la API de registro.

Nuevas características:

  • Proporciona la eliminación automática de cualquier cambio de variables de entorno cuando se desinstala una aplicación que usó el administrador de entornos.

Limitaciones:

  • Actualmente no está disponible en aplicaciones de C#. Pero estamos evaluando la incorporación de esta característica a aplicaciones de C# en una versión posterior.

Otros problemas conocidos y limitaciones

  • Si usa C# con la versión 1.1.0, Preview 1, debe usar una de las siguientes versiones del SDK de .NET como mínimo: SDK de .NET 6.0.201, 6.0.103, 5.0.212 o 5.0.406. Para actualizar la versión del SDK de .NET, actualice a la versión más reciente de Visual Studio o visite Descargas de .NET.