Note sulla versione del canale sperimentale di Windows App SDK 1.3

  • Articolo

Importante

Il canale sperimentale non è supportato per l'uso negli ambienti di produzioni e le app che utilizzano i rilasci sperimentali non possono essere pubblicati nel Microsoft Store.

Il canale sperimentale offre versioni di Windows App SDK funzionalità del canale sperimentale che sono nelle prime fasi di sviluppo. Le API delle funzionalità sperimentali hanno l'attributo Sperimentale. Se si chiama un'API sperimentale nel codice, si riceve un avviso in fase di compilazione. Tutte le API nel canale sperimentale potrebbero avere significative modifiche nelle future versioni, ma le API sperimentali sono specialmente soggette a modifiche. Le funzionalità sperimentali possono essere rimosse nella versione successiva oppure non essere mai rilasciate.

Collegamenti importanti:

Ultime note sulla versione del canale sperimentale:

Ultime note sulla versione del canale Stabile

Versione 1.3 sperimentale (1.3.0-experimental1)

Questa è la versione più recente del canale sperimentale. Per scaricarla, impostare nuovamente la versione NuGet di WinAppSDK su 1.3.230202101-experimental1.

API di sfondo XAML

Con le proprietà incorporate nella Window XAML, gli sfondi acrilico di sfondo & Mica sono ora più facili da usare nell'app WinUI 3.

Vedere le specifiche delle API di sfondo Xaml su GitHub per ulteriori informazioni sulla proprietà Window.SystemBackdrop.

Si noti che in questa versione è possibile impostare lo sfondo solo nel code-behind, come indicato di seguito. L'impostazione di <Window.SystemBackdrop> nel markup genera un errore di compilazione.

Inoltre, alle API di sfondo Xaml manca attualmente un tag "sperimentale", perché sono nella fase attiva di sviluppo.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Sostituendo diverse righe di codice boilerplate, è ora possibile usare le API AppWindow direttamente da una finestra tramite Window.AppWindow. Vedere le specifiche delle API Window.AppWindow su GitHub per ulteriori informazioni sullo sfondo e sull'uso.

Nuove funzionalità di WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId che sostituisce il MddGetGenerationId deprecato.
  • Responsabile ambiente: EnvironmentManager.AreChangesTracked per indicare se le modifiche apportate al responsabile ambiente possono essere monitorate nell'applicazione. Vedere le specifiche API del responsabile ambiente su GitHub per altre informazioni.
  • MRT Core: un nuovo evento, Application.ResourceManagerInitializing permette alla tua app di fornire la sua implementazione dell'interfaccia IResourceManager e offre l'accesso al ResourceManager utilizzato da WinUI per risolvere gli URI delle risorse.
  • Con la versione più recente di VSIX sperimentale, è ora possibile convertire l'app tra non in pacchetto e in pacchetto tramite il menu di Visual Studio anziché nel file di progetto.
  • Un nuovo evento, DebugSettings.XamlResourceReferenceFailed viene ora generato quando non è possibile risolvere una ricerca Static/ThemeResource di riferimento. Questo evento consente di accedere a una traccia che indica il punto in cui il framework ha cercato tale chiave per aiutarti a eseguire il debug degli errori di ricerca Static & ThemeResource. Per altre informazioni, vedere i problemi 4972, 2350 e 6073 su GitHub.

Correzioni di bug

  • Risolti problemi relativi all'input touch che causava la mancata visualizzazione della tastiera virtuale nelle caselle di testo. Per altre informazioni, vedere il problema 6291 su GitHub.
  • Risolto un problema che causava la generazione di un ArgumentException da parte di un ItemsRepeater con un IElementFactory come ItemTemplate. Per altre informazioni, vedere il problema 4705 su GitHub..

Altre API sperimentali

Questa versione include anche diverse API in fase di sviluppo iniziale.

Il seguente è un elenco dettagliato delle API introdotte in questa versione sperimentale che non prevediamo di inserire nella versione stabile 1.3.0.

**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