Note di rilascio del canale sperimentale di Windows App SDK
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:
- 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 sperimentali, vedere Installare gli strumenti per i canali di anteprima e sperimentali di Windows App SDK.
Rilasci del canale sperimentale:
- Versione 1.5 sperimentale
- Versione 1.4 sperimentale
- Versione 1.3 sperimentale
- Versione 1.2 sperimentale
- Versione 1.0 sperimentale
- Versione 0.8 Anteprima
Versione 1.5 sperimentale (1.5.0-experimental2)
Questa è la versione più recente del canale sperimentale.
Per scaricarla, impostare nuovamente la versione NuGet di WinAppSDK su 1.5.240124002-experimental2.
Correzioni di bug
Questa versione include le seguenti correzioni di bug:
- Risolto un problema che causava l'arresto anomalo delle app durante l'uso di un
NavigationViewItempersonalizzato. Per altre informazioni, vedere il problema 8814 su GitHub. - Risolto un problema
NavigationViewper cui il pulsante con i puntini di sospensione generava erroneamente un errore. Per altre informazioni, vedere il problema 8380 su GitHub. - Risolto un problema per cui il rendering di
SystemBackdropnon veniva effettuato correttamente in un'app con più finestre. Per altre informazioni, vedere il problema 8423 su GitHub. - Risolto un problema di duplicazione durante l'inserimento all'inizio di una
ObservableCollection. Per altre informazioni, vedere il problema 8370 su GitHub.
Nuove API
La versione 1.5-experimental2 include le nuove API seguenti. Queste API non sono sperimentali, ma non sono ancora incluse in una versione stabile di WinAppSDK.
Microsoft.Graphics.DirectX
DirectXPixelFormat
A4B4G4R4
Microsoft.UI.Xaml
DebugSettings
LayoutCycleDebugBreakLevel
LayoutCycleTracingLevel
LayoutCycleDebugBreakLevel
LayoutCycleTracingLevel
Microsoft.UI.Xaml.Automation.Peers
SelectorBarItemAutomationPeer
Microsoft.UI.Xaml.Controls
MapControl
MapControlMapServiceErrorOccurredEventArgs
MapElement
MapElementClickEventArgs
MapElementsLayer
MapIcon
MapLayer
SelectorBar
SelectorBarItem
SelectorBarSelectionChangedEventArgs
WebView2
EnsureCoreWebView2Async
EnsureCoreWebView2Async
Microsoft.Windows.Management.Deployment
EnsureReadyOptions
PackageDeploymentManager
AddPackageSetAsync
DeprovisionPackageAsync
DeprovisionPackageByUriAsync
DeprovisionPackageSetAsync
EnsurePackageReadyAsync
EnsurePackageReadyByUriAsync
EnsurePackageSetReadyAsync
IsPackageReady
IsPackageReadyByUri
IsPackageRegistrationPending
IsPackageRegistrationPendingForUser
ProvisionPackageAsync
ProvisionPackageByUriAsync
ProvisionPackageSetAsync
RegisterPackageAsync
RegisterPackageByUriAsync
RegisterPackageSetAsync
RemovePackageByUriAsync
RepairPackageAsync
RepairPackageByUriAsync
RepairPackageSetAsync
ResetPackageAsync
ResetPackageByUriAsync
ResetPackageSetAsync
StagePackageAsync
StagePackageByUriAsync
StagePackageSetAsync
PackageDeploymentProgress
PackageDeploymentResult
Error
ErrorText
PackageSet
Items
PackageUri
PackageVolume
FindPackageVolumeByName
FindPackageVolumeByPath
FindPackageVolumes
IsRepairNeeded
Repair
ProvisionPackageOptions
RegisterPackageOptions
DependencyPackageFamilyNames
RemovePackageOptions
FailIfNotFound
Altre API sperimentali
Questa versione include le seguenti API sperimentali, nuove e modificate:
Microsoft.UI.Xaml
Application
DispatcherShutdownMode
DispatcherShutdownMode
XamlIsland
SystemBackdrop
Microsoft.UI.Xaml.Hosting
WindowsXamlManager
IsXamlRunningOnCurrentThread
XamlShutdownCompletedOnThread
XamlShutdownCompletedOnThreadEventArgs
Microsoft.Windows.System.Workloads
IWorkloadHandler
Workload
WorkloadManager
WorkloadProgress
WorkloadProgressStatus
WorkloadResult
WorkloadsContract
WorkloadStatus
Versione 1.5 sperimentale (1.5.0-experimental1)
Questa è la versione più recente del canale sperimentale.
Per scaricarla, ridestinare la versione NuGet di WinAppSDK su 1.5.231202003-experimental1.
Nuove API
La versione 1.5-experimental1 include le nuove API seguenti. Queste API non sono sperimentali, ma non sono ancora incluse in una versione stabile di WinAppSDK.
Microsoft.Windows.Widgets.Feeds.Providers
CustomQueryParametersRequestedArgs
CustomQueryParametersUpdateOptions
FeedDisabledArgs
FeedEnabledArgs
FeedManager
FeedProviderDisabledArgs
FeedProviderEnabledArgs
FeedProviderInfo
IFeedManager
IFeedProvider
Altre API sperimentali
Questa versione include le seguenti API sperimentali, nuove e modificate:
Microsoft.UI.Content
ContentIsland
ConnectionInfo
ConnectRemoteEndpoint
IsRemoteEndpointConnected
ContentIslandEnvironment
CurrentOrientation
DisplayScale
NativeOrientation
ThemeChanged
ContentSiteEnvironment
CurrentOrientation
DisplayScale
NativeOrientation
NotifyThemeChanged
DesktopChildSiteBridge
AcceptRemoteEndpoint
ConnectionInfo
IsRemoteEndpointConnected
RemoteEndpointConnecting
RemoteEndpointDisconnected
RemoteEndpointRequestedStateChanged
EndpointConnectionEventArgs
EndpointRequestedStateChangedEventArgs
IContentIslandEndpointConnectionPrivate
IContentSiteBridgeEndpointConnectionPrivate
ProcessStarter
SystemVisualSiteBridge
IsClosed
Microsoft.UI.Input
FocusNavigationReason
FocusNavigationRequest
FocusNavigationRequestEventArgs
FocusNavigationResult
InputFocusController
DepartFocus
NavigateFocusRequested
InputFocusNavigationHost
Microsoft.UI.Xaml
DebugSettings
LayoutCycleDebugBreaks
LayoutCycleTracing
LayoutCycleDebugBreakLevel
LayoutCycleTracingLevel
XamlIsland
Microsoft.UI.Xaml.Controls
SelectionModel
SelectAllFlat
Microsoft.UI.Xaml.Core.Direct
XamlPropertyIndex
FlyoutBase_SystemBackdrop
Popup_SystemBackdrop
Microsoft.Windows.Management.Deployment
AddPackageOptions
AddPackageSetOptions
DeploymentPriority
DeploymentProcessingModel
EnsureIsReadyOptions
FindPackageSetOptions
PackageDeploymentContract
PackageDeploymentManager
PackageDeploymentProgress
PackageDeploymentProgressStatus
PackageDeploymentResult
PackageDeploymentStatus
PackageRuntimeManager
PackageSet
PackageSetItem
PackageSetItemRuntimeDisposition
PackageSetManager
PackageSetRuntimeDisposition
PackageVolume
PackageVolumeManager
PackageVolumeStatus
RegisterPackageOptions
RemovePackageOptions
StagePackageOptions
StubPackageOption
Versione 1.4 sperimentale (1.4.0-experimental1)
Questa è la versione più recente del canale sperimentale.
Per scaricarla, ridestinare la versione NuGet di WinAppSDK su 1.4.230518007-experimental1.
Correzioni di bug
Questa versione contiene varie correzioni, tra cui le seguenti:
- Risolto un problema per cui l'abilitazione del contatore della frequenza dei fotogrammi nelle impostazioni di debug in una nuova applicazione desktop WinUI causava una violazione di accesso. Per altre informazioni, vedere il problema 2835 su GitHub.
- Risolto un problema per cui lo scorrimento orizzontale su un touchpad non funzionava in una pagina Web WebView2. Per altre informazioni, vedere il problema 7772 su GitHub.
Altre API sperimentali
Questa versione include le seguenti API sperimentali, nuove e modificate:
Microsoft.UI
IClosableNotifier
Microsoft.UI.Composition.SystemBackdrops
DesktopAcrylicController
Closed
FrameworkClosed
Kind
DesktopAcrylicKind
MicaController
Closed
FrameworkClosed
Microsoft.UI.Content
ContentAppWindowBridge
SettingChanged
ContentEnvironmentSettingChangedEventArgs
ContentExternalBackdropLink
ContentExternalOutputLink
ExternalOutputBorderMode
ContentIsland
FrameworkClosed
ContentIslandWindow
SettingChanged
ContentSite
FrameworkClosed
ContentSiteWindow
NotifySettingChanged
SettingChanged
CoreWindowTopLevelWindowBridge
SettingChanged
DesktopSiteBridge
Closed
FrameworkClosed
IContentWindow
SettingChanged
SystemVisualSiteBridge
Closed
FrameworkClosed
Microsoft.UI.Input
InputLayoutPolicy
InputNonClientPointerSource
ConfigurationChanged
GetForWindowId
NonClientRegionConfigurationChangedEventArgs
Microsoft.UI.System
ThemeSettings
Microsoft.UI.Windowing
DisplayArea
GetMetricsFromWindowId
Microsoft.UI.Xaml
XamlRoot
ContentWindow
Microsoft.UI.Xaml.Controls
ItemContainer
Child
ChildProperty
ItemContainerMultiSelectMode
Extended
ItemsView
Animator
AnimatorProperty
MenuFlyoutPresenter
SystemBackdrop
SystemBackdropProperty
RiverFlowLayout
InvalidateItemsInfo
RequestedRangeCount
RequestedRangeStartIndex
RiverFlowLayoutElementAnimator
Microsoft.UI.Xaml.Controls.Primitives
CommandBarFlyoutCommandBar
SystemBackdrop
SystemBackdropProperty
Microsoft.UI.Xaml.Input
AccessKeyManager
EnterDisplayMode
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 Window 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.PackageGraphRevisionIdche sostituisce il MddGetGenerationId deprecato.- Responsabile ambiente:
EnvironmentManager.AreChangesTrackedper 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.ResourceManagerInitializingpermette alla tua app di fornire la sua implementazione dell'interfacciaIResourceManagere 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.XamlResourceReferenceFailedviene 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
Versione 1.2 sperimentale (1.2.0-experimental2)
Questa è la versione più recente del canale sperimentale. Supporta tutte le funzionalità del canale sperimentale e quelle della versione 1.2.0-preview 1.
Per scaricarla, impostare nuovamente la versione NuGet di WinAppSDK su 1.2.220909.2-experimental2.
Problema risolto
Nelle prossime build di Windows Insider Preview, le applicazioni che usano Windows App SDK non verranno avviate.
Versione 1.2 sperimentale (1.2.0-experimental1)
Questa è la versione più recente del canale sperimentale. Supporta tutte le funzionalità del canale sperimentale.
Per scaricarla, impostare nuovamente la versione NuGet di WinAppSDK su 1.2.220727.1-experimental1.
Input & Composizione
Introdotte per la prima volta in Windows App SDK 0.8, esistono diverse classi sperimentali negli spazi dei nomi Microsoft.UI.Input.Experimental & Microsoft.UI.Composition.Experimental.
Novità di questa versione:
- InputPointerSource ha un nuovo factory statico, GetforWindowId.
Sommario
Novità di questa versione, le classi sperimentali nello spazio dei nomi Microsoft.UI.Content forniscono i blocchi predefiniti dei contenuti interattivi. Si tratta di primitive di basso livello che possono essere assemblate nei contenuti per offrire l'esperienza interattiva all'utente finale. Il contenuto definisce la struttura per: output del rendering con animazioni, elaborazione dell'input su destinazioni diverse, fornitura della rappresentazione di accessibilità e gestione delle modifiche dello stato dell'host.
API rilevanti:
ContentIsland: riunisce output, input e accessibilità e fornisce l'astrazione per i contenuti interattivi. Con queste API si può costruire e rendere interattivo un albero visivo personalizzato.DesktopChildSiteBridge: consente aContentIslandil collegamento a una gerarchia basata su HWND.
Vedere l'esempio su GitHub per ulteriori informazioni.
Invio
DispatcherQueue ora spedisce come rientrante. In precedenza, non più di un singolo callback DispatcherQueueHandler poteva essere attivo su un singolo thread alla volta. Ora, se un gestore avvia un message pump nidificato, i callback aggiuntivi spediscono come rientranti. Questo corrisponde al comportamento Win32 relativo ai messaggi di finestra e ai message pump nidificati.
Notifications
La registrazione del nome visualizzato dell'app e dell'icona per le notifiche dell'app è ora supportata. Vedere le specifiche su GitHub per ulteriori informazioni.
WinUI 3
- I controlli e gli stili sono aggiornati con la versione WinUI 2.8.
- La piattaforma UWP non è più supportata nelle versioni sperimentali.
Altre limitazioni e problemi noti
- Le app devono essere ricompilate dopo l'aggiornamento a Windows App SDK 1.2-experimental1 a causa di una modifica di rilievo introdotta nell'ABI.
- Non è possibile compilare app che fanno riferimento a un pacchetto che dipende da WebView2 (come Microsoft.Identity.Client). Ciò dipende da file binari in conflitto in fase di compilazione. Vedere il problema 2492 su GitHub per ulteriori informazioni.
- L'uso di
dotnet buildcon un progetto di libreria di classi C# WinAppSDK potrebbe comportare un errore di compilazione "Impossibile caricare l'attività Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent". Per risolvere questo problema, impostare<EnableMsixTooling>true</EnableMsixTooling>nel file di progetto. - Nei modelli WinAppSDK predefiniti l'annotazione è MaxVersionTested="10.0.19041.0" mentre dovrebbe essere "10.0.22000.0". Per il supporto completo di alcune funzionalità, in particolare UnlockedDEHs, aggiornare MaxVersionTested a "10.0.22000.0" nel file di progetto.
Versione 1.0 sperimentale (1.0.0-experimental1)
Questa versione supporta tutte le funzionalità del canale sperimentale.
Nelle sezioni seguenti vengono descritte le funzionalità nuove e aggiornate, le limitazioni e i problemi noti di questa versione.
WinUI 3
Questa versione di WinUI 3 è incentrata sulla creazione di nuove funzionalità per la versione 1.0 stabile e sulla correzione di bug.
- Nuove funzionalità: supporto per la visualizzazione di ContentDialog per finestra anziché per thread.
- Bugs: per l'elenco completo dei bug risolti in questa versione, vedere il nostro repository GitHub.
- Esempi: per vedere controlli e funzionalità WinUI3 in azione, è possibile clonare e compilare l'app della raccolta WinUI da GitHub o scaricare l'app da Microsoft Store.
Per altre informazioni o per iniziare a sviluppare con WinUI, vedere:
Notifiche push (funzionalità sperimentale)
Questa versione introduce un'API per le notifiche push che può essere usata dalle app desktop in pacchetto con identità basate sulla registrazione delle app Azure. Per usare questa funzionalità, è necessario iscriversi all'anteprima privata.
Limitazioni importanti:
- Le notifiche push sono supportate solo nelle app in pacchetto MSIX in esecuzione in Windows 10, versione 2004 (build 19041) o versioni successive.
- Microsoft si riserva il diritto di disabilitare le notifiche push o di revocarle durante l'anteprima privata.
- Microsoft non garantisce l'affidabilità o la latenza delle notifiche push.
- Durante l'anteprima privata, il volume delle notifiche push è limitato a 1 milione al mese.
Per altre informazioni, vedere Notifiche push.
Windowing
Questa versione include aggiornamenti alle API di windowing. Si tratta di un set di API di windowing di alto livello, incentrate sulla classe AppWindow, che consente scenari di windowing facili da usare che si integrano bene con l'esperienza utente di Windows e altre app. Il set è simile, ma non uguale ad AppWindow sulla piattaforma UWP.
Limitazioni importanti:
- Questa versione di
AppWindowè attualmente disponibile solo per le app Win32 (in pacchetto e non in pacchetto). - Al momento Windows App SDK non fornisce metodi per collegare il contenuto del framework dell'interfaccia utente a un
AppWindow; è possibile usare solo i metodi di accesso di interoperabilitàHWND. - Al momento l'API di windowing non funziona in Windows versione 1809 e 1903 per AMD64.
Per altre informazioni, vedere Gestire le finestre delle app.
Distribuzione per app non in pacchetto
Questa versione introduce gli aggiornamenti alla funzionalità delle dipendenze dinamiche, inclusa l'Api del programma di avvio automatico.
Limitazioni importanti:
- La funzionalità delle dipendenze dinamiche è supportata solo per le app non in pacchetto.
- I chiamanti con privilegi elevati non sono supportati.
Per altre informazioni, vedere gli articoli seguenti:
- Usare pacchetti framework MSIX in modo dinamico dall'app desktop
- Usare il runtime di SDK per app di Windows per le app in pacchetto con posizione esterna o non in pacchetto
Altre limitazioni e problemi noti
- Nessun supporto per la configurazione di compilazione Qualsiasi CPU: Windows App SDK viene scritto nel codice nativo e pertanto non supporta le configurazione di compilazione Qualsiasi CPU. I modelli WinUI 3 in Visual Studio consentono solo compilazioni specifiche per l'architettura. Quando si aggiunge Windows App SDK a un'applicazione o a un componente .NET esistente che supporta Qualsiasi CPU, è necessario specificare l'architettura desiderata:
x86ox64arm64. - Le app .NET devono avere come destinazione la build 18362 o successive: il TFM deve essere impostato su
net6.0-windows10.0.18362o successive e la<TargetPlatformVersion>del progetto di creazione del pacchetto su 18362 o successive. Per altre informazioni, vedere il problema noto su GitHub. - Le app C# che usano la versione 1.0 sperimantale devono usare uno dei seguenti SDK .NET:
- SDK .NET 6 o successive (vedere Scaricare .NET e Il supporto per .NET 5 terminerà il 10 maggio 2022).
Versione 0.8 Anteprima (0.8.0-preview)
Questa versione supporta tutte le funzionalità del canale sperimentale.
Nelle sezioni seguenti vengono descritte le funzionalità nuove e aggiornate, le limitazioni e i problemi noti di questa versione.
WinUI 3
Questa versione introduce correzioni di bug critici (inclusi quelli corrette nelle versioni di manutenzione 0.5) e altre modifiche per WinUI. Per un elenco completo, vedere le note di rilascio di WinUI 3 - Windows App SDK 0.8.
Ciclo di vita dell'app (funzionalità sperimentale)
Questa versione introduce nuove funzionalità sperimentali correlate alla gestione del ciclo di vita dell'app.
- Tutte le app (in pacchetto e non in pacchetto) possono usare GetActivatedEventArgs (anche se le app in pacchetto possono già usare l'implementazione di questa funzionalità nella piattaforma).
- Solo le app non in pacchetto possono usare le funzioni RegisterForXXXActivation.
- Le app desktop in pacchetto possono usare la creazione di istanze del ciclo di vita dell'app.
Per altre informazioni, vedere Creazione di istanze dell'app e Attivazione avanzata.
Distribuzione per le app non in pacchetto (funzionalità sperimentale)
Questa versione introduce nuove funzionalità di distribuzione sperimentale per le app non in pacchetto. Le app non in pacchetto possono ora acquisire dinamicamente una dipendenza dai pacchetti di runtime di Windows App SDK in modo da poter continuare a usare il programma di installazione o MSI esistente per la distribuzione delle app. Questa opzione è disponibile attraverso le seguenti funzionalità:
- Programma di installazione autonomo per Windows App SDK.
- Bundle di pacchetti MSIX che include la funzionalità delle dipendenze dinamiche.
Per altre informazioni, vedere la Guida alla distribuzione di Windows App SDK per le app dipendenti dal framework in pacchetto con posizione esterna o non in pacchetto.
DWriteCore
Questa versione aggiunge le seguenti funzionalità:
- Decorazioni di testo (testo sottolineato e barrato nell'API del layout di testo)
- Layout di testo verticale
- API di kerning del tipo di carattere
- Supporto sperimentale per le app non in pacchetto
Per altre informazioni, vedere Eseguire il rendering del testo con DWriteCore.
MRT Core
Questa versione aggiunge le seguenti funzionalità:
- L'azione di compilazione per le risorse viene ora impostata automaticamente, riducendo la necessità di configurare manualmente il progetto.
- Supporto sperimentale per le app non in pacchetto.
Per altre informazioni, vedere Gestire le risorse con MRT Core.
Limitazioni e problemi noti
- Nessun supporto per la configurazione di compilazione Qualsiasi CPU: Windows App SDK viene scritto nel codice nativo e pertanto non supporta le configurazione di compilazione Qualsiasi CPU. I modelli WinUI 3 in Visual Studio consentono solo compilazioni specifiche per l'architettura. Quando si aggiunge Windows App SDK a un'applicazione o a un componente .NET esistente che supporta Qualsiasi CPU, è necessario specificare l'architettura desiderata:
x86ox64arm64. - Le app .NET devono avere come destinazione la build 18362 o successive: il TFM deve essere impostato su
net6.0-windows10.0.18362o successive e la<TargetPlatformVersion>del progetto di creazione del pacchetto su 18362 o successive. Per altre informazioni, vedere il problema noto su GitHub.
Esempi
Gli esempi di Windows App SDK ancora non funzionano con questa versione. Saranno presto disponibili esempi nuovi e aggiornati, inclusi quelli che illustrano nuove funzionalità, come la distribuzione delle app non in pacchetto.
Argomenti correlati
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per