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

  • Artículo

Importante

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

El canal experimental proporciona versiones del SDK de Aplicaciones para Windows que incluyen características del canal experimental que se encuentran en las primeras fases de desarrollo. Las API de características experimentales tienen el atributo Experimental. Si llama a una API experimental en el código, recibirá una advertencia durante la compilación. Todas las API del canal experimental pueden sufrir cambios de última hora en futuras versiones, pero las API experimentales están especialmente sujetas a cambios. Las características experimentales se pueden quitar de la próxima versión o no se pueden publicar nunca.

Vínculos importantes:

Versión del canal experimental más reciente:

Versión del canal estable más reciente:

Version 1.3 Experimental (1.3.0-experimental1)

Esta es la versión más reciente del canal experimental. Para descargarlo, vuelva a establecer la versión de NuGet de WinAppSDK en 1.3.230202101-experimental1.

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 la especificación de la API Xaml Backdrop en GitHub para más información sobre la propiedad Window.SystemBackdrop.

Es importante destacar que, en esta versión, solo se puede establecer el telón de fondo en el código subyacente, como se indica a continuación. Si se establece <Window.SystemBackdrop> en el marcado, se produce un error de compilación.

Además, las API de fondo Xaml carecen actualmente de una etiqueta "experimental", ya que se encuentran en desarrollo activo.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Reemplazar varias líneas de código reutilizable, ahora puede usar las API de AppWindow directamente desde una ventana a través Window.AppWindowde . Consulte la especificación de la API Window.AppWindow en GitHub para más información sobre el fondo y el uso.

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. Consulte la especificación de la API del administrador de entorno en GitHub para obtener más información.
  • MRT Core: un nuevo evento, Application.ResourceManagerInitializing que permite a la aplicación proporcionar su propia implementación de la interfaz IResourceManager, y da acceso al ResourceManager que WinUI utiliza para resolver URI de recursos.
  • 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.
  • 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 los problemas 4972, 2350 y 6073 en GitHub .

Corrección de errores

  • Se corrigieron problemas con la entrada táctil que provocaba que el teclado en pantalla no apareciera en los cuadros de texto. Para más información, consulte el problema 6291 en GitHub.
  • Se corrigió un problema que provocaba que un ItemsRepeater con un IElementFactory como su ItemTemplate lanzara una ArgumentException. Para más información, consulte el problema 4705 en GitHub.

API experimentales adicionales

Esta versión también incluye varias API que se encuentran en fase inicial de desarrollo.

La siguiente lista detalla las API presentadas en esta versión experimental que no planeamos incluir en la versión 1.3.0 estable.

**Microsoft.UI.Content**

    DesktopSiteBridge
        GetInputEnabledToRoot
        GetVisibleToRoot
        InputEnabled

**Microsoft.UI.Dispatching**

    DispatcherQueue
        FrameworkShutdownStarting

**Microsoft.UI.Input**

    InputLightDismissAction
        GetForIsland

    InputNonClientPointerSource
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior

    NonClientRegionCaptionTappedEventArgs
    NonClientRegionHoverEventArgs
    NonClientRegionKind

**Microsoft.UI.Input.DragDrop**

    DragDropManager
    DragDropModifiers
    DragInfo
    DragOperation
    DragUIContentMode
    DragUIOverride
    DropOperationTargetRequestedEventArgs
    IDropOperationTarget

**Microsoft.UI.Xaml.Automation.Peers**

    ItemContainerAutomationPeer
    ItemsViewAutomationPeer

**Microsoft.UI.Xaml.Controls**

    AnnotatedScrollBar
    AnnotatedScrollBarLabel
    AnnotatedScrollBarScrollEventArgs
    AnnotatedScrollBarScrollEventType
    AnnotatedScrollBarScrollOffsetRequestedEventArgs
    AnnotatedScrollBarSubLabelRequestedEventArgs
    AnnotatedScrollBarValueRequestedEventArgs
    ElementFactory
        GetElement
        GetElementCore
        RecycleElement
        RecycleElementCore

    IndexBasedLayoutOrientation
    ItemContainer
    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    ItemsView
    ItemsViewItemInvokedEventArgs
    ItemsViewItemInvokeMode
    ItemsViewSelectionMode
    Layout
        IndexBasedLayoutOrientation

    NonVirtualizingLayout
        IndexBasedLayoutOrientationCore

    RiverFlowLayout
    RiverFlowLayoutItemsInfoRequestedEventArgs
    RiverFlowLayoutItemsJustification
    RiverFlowLayoutItemsStretch
    VirtualizingLayout
        IndexBasedLayoutOrientationCore

    VirtualizingLayoutContext
        VisibleRect
        VisibleRectCore

**Microsoft.Graphics.Display**

    DisplayInformation
        AngularOffsetFromNativeOrientation
        DpiChanged
        OrientationChanged
        RawDpi
        RawPixelsPerViewPixel

    DisplayOrientation

**Microsoft.UI.Xaml.Hosting**

    DesktopWindowXamlSource
        CreateSiteBridge
        SiteBridge
        SystemBackdrop