Note sulla versione del canale di anteprima per il SDK per app di Windows 1.5

Importante

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

Il canale di anteprima include le versioni di Windows AppSDK con funzionalità del canale di anteprima nelle ultime fasi di sviluppo. Le versioni di anteprima non includono funzionalità sperimentali e API, ma potrebbero comunque essere soggette a modifiche di rilievo prima della prossima versione stabile.

Collegamenti importanti:

• Se si vuole aggiornare un'app esistente da una versione precedente di Windows App SDK di Windows a una versione più recente, vedere Aggiornare i progetti esistenti alla versione più recente di Windows App SDK.
• Per la documentazione sulle versioni di anteprima, vedere Installazione degli strumenti per i canali di anteprima e sperimentali di Windows App SDK.

Ultime note sulla versione del canale di anteprima:

• Ultime note sulla versione del canale di anteprima per Windows App SDK

Ultime note sulla versione del canale Stabile

• Ultime note sulla versione del canale stabile per Windows App SDK

Versione 1.5 Preview 1 (1.5.0-preview1)

Questa è l'ultima versione del canale di anteprima per la versione 1.5.

In un'app esistente di Windows App SDK 1.4 (dal canale stabile) è possibile aggiornare il pacchetto Nuget alla versione 1.5.0-preview1 (vedere la sezione Aggiorna un pacchetto in Installazione e gestione pacchetti in Visual Studio usando il Gestione pacchetti NuGet).

Per il runtime e l'MSIX aggiornati, vedere anche Download per il Windows App SDK.

Aggiornamenti di runtime e arresto delle isole XAML

• Esiste una differenza comportamentale tra WinAppSDK 1.4 e WinAppSDK 1.5 per le app basate sulle isole Xaml quando viene chiusa l'ultima finestra Xaml su qualsiasi thread.
  • In WinAppSDK 1.4 il runtime Xaml esce sempre dal ciclo di eventi del thread quando viene chiusa l'ultima finestra Xaml di un thread.
  • In WinAppSDK 1.5:
    • Se l'app è un'app Desktop WinUI, il comportamento predefinito è sempre uguale a quello di WinAppSDK 1.4.
    • Se si utilizza Xaml per l'API DesktopWindowXamlSource ("Isole Xaml"), il comportamento predefinito prevede che Xaml non esca automaticamente dal ciclo di eventi del thread.
    • In entrambe le modalità è possibile modificare questo comportamento impostando la proprietà Application.DispatcherShutdownMode.
  • Per altre informazioni, vedere la documentazione relativa alla Application.DispatcherShutdownMode proprietà quando disponibile.
• Esiste una differenza comportamentale tra WinAppSDK 1.4 e WinAppSDK 1.5 per le app basate su isole Xaml nella durata del runtime Xaml:
  • In WinAppSDK 1.4 il runtime XAML si arresta su un thread se tutti gli WindowsXamlManager e gli DesktopWindowXamlSource oggetti in un determinato thread vengono chiusi o arrestati oppure DispatcherQueue l'esecuzione su tale thread viene arrestata (in questo caso il runtime Xaml si arresta durante la DispatcherQueue.FrameworkShutdownStarting fase).
  • In WinAppSDK 1.5 il runtime Xaml si arresta su un thread solo quando DispatcherQueue in esecuzione su tale thread viene arrestato (il runtime Xaml viene sempre arrestato durante la DispatcherQueue.FrameworkShutdownStarting fase).
  • Per altre informazioni, vedere la documentazione relativa alla WindowsXamlManager classe quando disponibile.

Controllo Mappe WinUI

La versione iniziale del controllo WinUI Maps è ora disponibile. Questo controllo è basato su WebView2 e Mappe di Azure, fornendo le seguenti funzionalità:

• Panoramica e zoom con i pulsanti della mappa o il tocco.
• Modifica dello stile della mappa in visualizzazione satellite, terreno o strada.
• Aggiunta di pin interagendo a livello di codice con icone personalizzabili dallo sviluppatore alla mappa.
• Personalizzazione dello sviluppatore per la posizione in cui la mappa è centrata sul carico iniziale.
• Controllare per gli sviluppatori di nascondere o visualizzare i pulsanti per la panoramica, lo zoom e gli stili della mappa.

Nota

Per usare il Maps controllo, è necessario un tasto Mappe di Azure. Per creare la chiave, vedere la pagina della documentazione Mappe di Azure per la creazione di un'app Web.

Il Maps controllo è completamente nuovo e siamo lieti di valutare la sua direzione futura!

Altre nuove funzionalità da winAppSDK

• Aggiunta del supporto per il modello di distribuzione PublishSingleFile. Per altre info su PublishSingleFile, vedere la documentazione relativa alla distribuzione di file singoli.

Correzioni di bug

• È stato risolto un problema dalla versione 1.5-experimental2 in cui la DLL di proiezione non veniva generata. Per altre informazioni, vedere il problema 4152 su GitHub.
• È stato risolto un problema per cui il pulsante con i puntini di sospensione nella finestra popup per la formattazione del testo di RichEditBox non visualizzava correttamente l'elenco delle azioni. Per altre informazioni, vedere il problema 9140 su GitHub.
• È stato risolto un problema per cui ListView non gestiva correttamente gli acceleratori da tastiera. Per altre informazioni, vedere il problema 8063 su GitHub.
• Correzione di un problema di violazione di accesso relativo all'uso AccessKey di per chiudere una finestra. Per altre informazioni, vedere il problema 8648 su GitHub.
• È stato risolto un problema che interessava l'allineamento del testo in un MenuFlyoutItem all'interno di un MenuBar. Per altre informazioni, vedere il problema 8755 su GitHub.
• È stato risolto un problema per cui il testo evidenziato non rimane evidenziato al clic con il pulsante destro del mouse. Per altre informazioni, vedere il problema 1801 su GitHub.
• È stato risolto un problema che causava l'arresto anomalo dell'app inattiva all'arresto anomalo dell'app. Per altre informazioni, vedere il problema 8913 su GitHub.
• È stato risolto un problema che poteva bloccare le applicazioni durante lo scorrimento con il pulsante centrale del mouse e facendo clic con il pulsante sinistro immediatamente dopo. Per altre informazioni, vedere il problema 9233 su GitHub.

Nuove API nella versione 1.5.0-preview1

La versione 1.5-preview1 include le nuove API seguenti rispetto alla versione stabile 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

Argomenti correlati

• Ultime note sulla versione del canale stabile per Windows App SDK
• Ultime note sulla versione del canale sperimentale di Windows App SDK
• Installare gli strumenti per Windows App SDK
• Creare il primo progetto WinUI 3 (Windows App SDK)
• Usare SDK per app di Windows in un progetto esistente
• Panoramica della distribuzione