Condividi tramite

Note sulla versione del canale di anteprima per Windows App SDK 1.2

  • Articolo

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:

Ultime note sulla versione del canale di anteprima:

Ultime note sulla versione del canale Stabile

Versione 1.2 Preview 2 (1.2.0-preview2)

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

In un'app esistente di Windows App SDK 1.1 (dal canale stabile) è possibile aggiornare il pacchetto Nuget alla versione 1.2.0-preview2 (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, consultare la sezione Ultimi download di Windows App SDK.

Importante

Visual Studio 2019 e .NET 5 non sono più supportati per la compilazione di app C# (vedere Passaggio di Windows App SDK 1.2 a C# WinRT 2.0). Sono necessari Visual Studio 2022 e una delle versioni seguenti di .NET SDK: 6.0.401 (o versioni successive), 6.0.304, 6.0.109.

Per aggiornare la versione di .NET SDK, installare la versione più recente di Visual Studio 2022 o visitare Download .NET. Durante l'aggiornamento del pacchetto NuGet senza la versione richiesta di .NET SDK, quando si aggiorna il pacchetto NuGet verrà visualizzato un errore simile al seguente: "Questa versione di WindowsAppSDK richiede NET 6+ e WinRT.Runtime.dll versione 2.0 o successiva". Per aggiornare il progetto da .NET 5.0 a .NET 6.0, aprire il file di progetto e modificare "TargetFramework" in net6.0 e "Versione del sistema operativo di destinazione" al valore appropriato ,ad esempio net6.0-windows10.0.19041.0.

Widget di terze parti in Windows

La scheda Widget è stata introdotta per la prima volta in Windows 11 ed è stata limitata alla visualizzazione di widget di prima parte. I widget di Windows sono contenitori di interfaccia utente di piccole dimensioni che visualizzano testo e grafica nell'apposita scheda, associati a un'app installata nel dispositivo. Con Windows App SDK, come sviluppatori di terze parti è ora possibile creare widget per le app Win32 in pacchetto e testarle localmente nella scheda widget di Windows 11.

Per maggiori informazioni sui widget, consultare la sezione Panoramica dei widget.

Per iniziare a sviluppare widget per l'app, consultare la documentazione di sviluppo del provider dei widget e concetti fondamentali sulla progettazione dei widget per prerequisiti, indicazioni e procedure consigliate.

I prerequisiti per questa versione includono quanto segue:

  • Modalità sviluppatore abilitata nel computer di sviluppo.
  • Il computer di sviluppo esegue una versione di Windows dal canale Dev del Programma Windows Insider (WIP) con scheda widget versione 521.20060.1205.0 o successiva.

Limitazioni note durante lo sviluppo di widget

  • I widget di terze parti possono essere testati solo localmente nei dispositivi registrati in WIP per questa versione di anteprima. In Windows App SDK 1.2.0, gli utenti delle versioni definitive di Windows possono iniziare ad acquisire widget 3P tramite le versioni fornite di Microsoft Store dell'app.
  • I widget possono essere creati solo per le app Win32 incluse nel pacchetto. I widget per l'App Web Progressiva (PWA) devono essere supportati come parte di Microsoft Edge 108.

Trimming per le app sviluppate con .NET

Gli sviluppatori .NET sono ora in grado di pubblicare le app WinAppSDK trimmate. Con CsWinRT 2.0, le proiezioni C#/WinRT distribuite in WinAppSDK sono ora trimmabili. La pubblicazione dell'app sottoposta a trimming può ridurre il footprint del disco dell'app rimuovendo qualsiasi codice inutilizzato dai file binari trimmabili. Le app possono anche visualizzare un miglioramento delle prestazioni di avvio. Con un'app Hello World di base, è stato riscontrato un miglioramento del footprint del disco circa l'80% e un miglioramento delle prestazioni di avvio del 7% quando è stato pubblicato. Con la raccolta WinUI, è stato riscontrato un miglioramento del footprint del disco del 45%.

Per altre informazioni su come abilitare il trimming, trimmare le limitazioni (ad esempio la riflessione sui tipi trimmabili) e gli avvisi: a tale proposito, vedere Trim self-contained deployments and executables (Trimming delle distribuzioni autonome e degli eseguibili). Gli sviluppatori devono testare accuratamente le proprie app dopo il trimming per assicurarsi che tutto funzioni come previsto. Per altre informazioni su queste modifiche, vedere il problema #2478 su GitHub.

DisplayInformation

Le app Win32 possono ora supportare High Dynamic Range (HDR) tramite la classe DisplayInformation in WinAppSDK. La classe DisplayInformation consente di monitorare le informazioni correlate alla visualizzazione di un'applicazione. Sono inclusi gli eventi per consentire ai client di monitorare le modifiche nella visualizzazione Applicazione che influiscono sulle visualizzazioni in cui risiede la visualizzazione, nonché sulle modifiche apportate agli schermi che possono influire sulla visualizzazione dell'applicazione.

Problemi risolti in WinUI 3

  • Il materiale di sfondo acrilico tramite DesktopAcrylicController è ora supportato nelle app di Windows 10. Per altre informazioni su queste modifiche, vedere il problema #7112 su GitHub.
  • È stato risolto un problema che causava l'errore di instradamento di App.UnhandledException all'applicazione. Per altre informazioni su queste modifiche, vedere il problema #5221 su GitHub.
  • È stato risolto un problema che causava la regressione degli stili listView e la modifica da WinAppSDK 1.1. Per altre informazioni su queste modifiche, vedere il problema #7666 su GitHub.

Altri limiti e problemi noti (1.2.0-preview2)

Importante

Quando si fa riferimento a WinAppSDK 1.2 da un progetto, è possibile che venga visualizzato un errore simile al seguente: "Downgrade del pacchetto rilevato: Microsoft.Windows.SDK.BuildTools da 10.0.22621.1 a 10.0.22000.194.", causato da riferimenti incompatibili al pacchetto dal progetto dell'app e dal pacchetto WinAppSDK. Per risolvere questo problema, è possibile aggiornare il riferimento nel progetto a una versione più recente e compatibile di Microsoft.Windows.SDK.BuildTools o semplicemente rimuovere il riferimento dal progetto. Se si rimuove dal progetto, verrà fatto riferimento implicito a una versione compatibile dal pacchetto WinAppSDK.

  • La compilazione con Arm64 Visual Studio non è attualmente supportata.
  • Le impostazioni predefinite del programma di avvio automatico e dell'inizializzatore automatico WinRT RegFree sono (ora) impostate solo per i progetti che producono un elemento eseguibile (OutputType=Exe o WinExe). Ciò previene l'aggiunta di inizializzatori automatici nelle DLL della libreria di classi e in altri file non eseguibili per impostazione predefinita.
    • Se è necessario un inizializzatore automatico in un file non eseguibile ,ad esempio una DLL di test caricata da un eseguibile generico che non inizializza il programma di avvio automatico, è possibile abilitare in modo esplicito un inizializzatore automatico nel progetto tramite <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize> o <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
  • Le API delle informazioni sulla versione (ReleaseInfo e RuntimeInfo) possono essere richieste ma restituiscono la versione 0 (non le informazioni effettive sulla versione).

Versione 1.2 Anteprima (1.2.0-preview1)

In un'app esistente di Windows App SDK 1.1 (dal canale stabile) è possibile aggiornare il pacchetto Nuget alla versione 1.2.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, consultare la sezione Ultimi download di Windows App SDK.

WinUI 3

Le app WinUI 3 possono riprodurre audio e video con i controlli di riproduzione multimediale MediaPlayerElement e MediaTransportControls. Per altre info su come e quando usare i controlli multimediali, vedere Lettori multimediali.

WinUI 3 è stato aggiornato con i controlli, gli stili e i comportamenti più recenti di WinUI 2.8. Questi aggiornamenti includono l'aggiunta del comando InfoBadge, miglioramenti alla modalità di accessibilità e contrasto elevato, nonché correzioni di bug tra i comandi. Per altri dettagli, vedere le note sulla versione per WinUI 2.7 e WinUI 2.8.

Problema noto

Gli stili ListView sono regrediti e modificati da WinAppSDK 1.1.

Notifications

AppNotificationBuilder è stato introdotto come alternativa al payload XML per la creazione e la definizione delle notifiche dell'app.

Per informazioni sull'utilizzo, vedere la specifica AppNotificationBuilder su GitHub.

Inoltre, si veda Avvio rapido: notifiche di Windows App SDK per un esempio di come creare un'applicazione di Windows desktop che invia e riceve notifiche di app locali.

Modifica

Per le notifiche push, quando si effettua una chiamata di richiesta canale, le app dovranno usare l'ID oggetto di Azure anziché l'ID app Azure. Per informazioni dettagliate sulla ricerca dell'ID oggetto di Azure, vedere Avvio rapido: notifica push in Windows App SDK.

Problema risolto

PushNotificationManager.IsSupported eseguirà un controllo per la modalità con privilegi elevati. Restituirà false se l'app è elevata.

Limitazioni note (notifiche)

Windowing

La personalizzazione completa della barra del titolo è ora disponibile in Windows 10, versione 1809 e successive tramite la classe AppWindowTitleBar. È possibile impostare AppWindowTitleBar.ExtendsContentIntoTitleBar per true estendere il contenuto nell'area della barra del titolo e SetDragRectangles per definire le aree di trascinamento (oltre ad altre opzioni di personalizzazione).

Se è stata usata la proprietà AppWindowTitleBar.IsCustomizationSupported per verificare se è possibile richiedere le API AppWindowTitleBar, ora restituisce true nelle versioni supportate di Windows App SDK Windows 10 (1809 e versioni successive).

Limitazioni note (Windowing)

Le personalizzazioni della barra del titolo semplice non sono supportate in Windows 10. Ad esempio: BackgroundColor, InactiveBackgroundColor, ForegroundColor, InactiveForegroundColor e IconShowOptions. Se si richiedono queste proprietà, queste verranno ignorate automaticamente. Tutte le altre API AppWindowTitleBar operano in Windows 10, versione 1809 e successive. Per le API colore del pulsante didascalia (tra le altre) e Height, ExtendsContentIntoTitleBar è necessario impostare su true, altrimenti verranno ignorate automaticamente.

Controllo di accesso

Introdotto security.accesscontrol.h con la funzione GetSecurityDescriptorForAppContainerNames per semplificare e semplificare la condivisione di oggetti denominati tra processi in pacchetto e API Win32 generali. Questo metodo accetta un elenco di nomi di famiglia di pacchetti (PFN) e maschere di accesso, oltre a restituire un descrittore di sicurezza. Per altre informazioni, vedere la specifica GetSecurityDescriptorForAppContainerNames spec su GitHub.

Altri limiti e problemi noti (1.2.0-preview1)

  • .NET PublishSingleFile non è supportato.