Notas de la versión del canal en versión preliminar de la SDK de Aplicaciones para Windows 1.5

  • 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.5, Preview 1 (1.5.0-preview1)

Esta es la versión más reciente del canal de versión preliminar para la versión 1.5.

En una aplicación existente del SDK de Aplicaciones para Windows 1.4 (del canal estable), puede actualizar el paquete NuGet a la versión 1.5.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).

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.
  • 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 (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 se apaga durante la fase DispatcherQueue.FrameworkShutdownStarting).
    • Para obtener más información, consulte la documentación de la clase WindowsXamlManager cuando esté disponible.

Control de Mapas de WinUI

La versión inicial del control Maps de WinUI 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.
  • Agregar patillas interactables mediante programación con iconos personalizables para desarrolladores al mapa.
  • 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.

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.

Otras características nuevas de WinAppSDK

Corrección de errores

  • 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 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.

Nuevas API en 1.5.0-preview1

La versión 1.5-preview1 incluye las siguientes API nuevas en comparación con la versión estable 1.4:

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode

    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel

    DispatcherShutdownMode
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        GetForCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Web.WebView2.Core
 
    CoreWebView2
        FrameId

    CoreWebView2AcceleratorKeyPressedEventArgs
        IsBrowserAcceleratorKeyEnabled

    CoreWebView2BrowserExtension
    CoreWebView2BrowsingDataKinds
        ServiceWorkers

    CoreWebView2CustomSchemeRegistration
        CoreWebView2CustomSchemeRegistration (String)
        AllowedOrigins
        SchemeName

    CoreWebView2Environment
        GetProcessExtendedInfosAsync

    CoreWebView2EnvironmentOptions
        AreBrowserExtensionsEnabled
        CustomSchemeRegistrations

    CoreWebView2Frame
        FrameId

    CoreWebView2FrameInfo
        FrameId
        FrameKind
        ParentFrameInfo

    CoreWebView2FrameKind
    CoreWebView2MouseEventKind
        NonClientRightButtonDown
        NonClientRightButtonUp

    CoreWebView2NavigationKind
    CoreWebView2NavigationStartingEventArgs
        NavigationKind

    CoreWebView2NewWindowRequestedEventArgs
        OriginalSourceFrameInfo

    CoreWebView2ProcessExtendedInfo
    CoreWebView2Profile
        AddBrowserExtensionAsync
        Delete
        Deleted

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    EnsureReadyOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetRuntimeDisposition
    PackageVolume
    ProvisionPackageOptions
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

Microsoft.Windows.Widgets.Feeds.Providers
 
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider