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

  • 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.1 Preview 3 (1.1.0-preview3)

Questa è l'ultima versione del canale di anteprima per la versione 1.1. Supporta tutte le funzionalità del canale di anteprima (vedere Funzionalità disponibili per canale di rilascio).

In un'app esistente che usa Windows App SDK1.3 è possibile aggiornare il pacchetto Nuget alla preview3 1.1.0 (vedere la sezione Aggiorna un pacchetto in Installazione e gestione pacchetti in Visual Studio usando Gestione pacchetti NuGet). Consultare anche la sezione Ultimi download di Windows App SDK per il runtime aggiornato e MSIX.

Nota

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK: 6.0.202, 6.0.104, 5.0.407, 5.0.213 (o versione successiva). Per aggiornare la versione di .NET SDK, visitare .NET Download o aggiornare la versione più recente di Visual Studio. 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 WinRT.Runtime.dll versione 1.6 o successiva".

Oltre a tutte le funzionalità di Preview 2 , le sezioni seguenti descrivono funzionalità, limitazioni e problemi noti nuovi e aggiornati per questa versione.

WinUI 3 (1.1.0-preview3)

Mica e Acrilico di sfondo sono ora disponibili per le applicazioni WinUI 3.

Per altre informazioni su questi materiali, vedere Materiali in Windows 11. Vedere il codice di esempio per l'applicazione di Mica in applicazioni C++ nella sezione Applicare materiali Mica o Acrilici nelle app desktop per Windows 11 e nelle applicazioni C# in GitHub come parte della raccolta di controlli WinUI.

Notifiche (1.0.0-preview3)

Problemi risolti:

  • Nella versione 1.1.0-preview1 e 1.1.0-preview2 alcune app non incluse nel pacchetto vedranno le icone dell'app copiate in modo non corretto in AppData\LocalMicrosoftWindowsAppSDK. Per questa versione, verranno invece copiati in AppData\Local\Microsoft\WindowsAppSDK. Per evitare la perdita di icone, è consigliabile eliminare manualmente l'icona dell'app nel percorso non corretto dopo l'aggiornamento alla versione 1.1.0-preview3.
  • L'icona dell'app e il recupero del nome visualizzato dell'app per le notifiche tramite collegamenti sono ora supportati. Questa icona dell'app avrà la priorità su qualsiasi icona specificata nei file di risorse.
  • Il supporto per le notifiche push per le app non incluse nel pacchetto è stato ripristinato (vedere Limitazioni per l'eccezione annotata). È stata introdotta l'API PushNotificationManager::IsSupported per verificare se l'app supporta le notifiche push.

Limitazioni:

  • Le notifiche per una app senza pacchetti con privilegi elevati non sono supportati. PushNotificationManager.IsSupported non eseguirà un controllo per la modalità con privilegi elevati. Tuttavia, Microsoft sta lavorando per supportare questa funzionalità in una versione futura.

Creazione di pacchetti MSIX

MsiX ha migliorato l'aggiunta e l'estensione delle funzionalità esistenti tramite le categorie di estensioni:

  • windows.appExecutionAlias
  • windows.customDesktopEventLog
  • windows.dataShortcuts
  • windows.fileTypeAssociation
  • windows.fileTypeAssociation.iconHandler
  • windows.folder
  • windows.shortcut

Questi richiedono l'installazione del pacchetto framework Windows App SDK. Consultare la sezione Ultimi download di Windows App SDK per installare il runtime.

Environment Manager (1.1.0-preview3)

Insieme di API che consente agli sviluppatori di aggiungere, rimuovere e modificare le variabili di ambiente senza dover usare direttamente l'API del Registro di sistema.

Chiarimento dalla versione 1.1 Preview 1: "La rimozione automatica di qualsiasi variabile di ambiente cambia quando viene disinstallata un'app che usa la gestione ambiente è disponibile" solo per le app in pacchetto. Inoltre, il ripristino delle modifiche delle variabili di ambiente richiede l'installazione del pacchetto framework Windows App SDK; consultare la sezione Ultimi download di Windows App SDK per il runtime.

Altre limitazioni note

Regressioni dalla versione 1.1 Preview 2:

  • Per le app .NET che usano LE API MRT Core e le app WinUI che non vengono distribuite con MSIX a progetto singolo:
    • I file RESW e di immagine aggiunti al progetto come elementi esistenti e in precedenza inclusi automaticamente nei file PRIResource e Content ItemGroup, rispettivamente, non verranno inclusi in tali ItemGroup. Di conseguenza, queste risorse non verranno indicizzate durante la generazione PRI, quindi non saranno disponibili durante il runtime.
      • Soluzione alternativa: includere manualmente le risorse nel file di progetto e rimuoverle da None ItemGroup.
      • Soluzione alternativa: se disponibile, aggiornare .NET SDK delle app alla versione 6.0.300. Per altre informazioni, vedere Requisiti della versione per .NET SDK .
  • Per le app .NET che non vengono distribuite con MSIX a progetto singolo:
    • Se un file viene aggiunto a Content ItemGroup due o più volte, si verifica un errore di compilazione.
      • Soluzione alternativa: eliminare l'inclusione/s duplicata o impostare EnableDefaultContentItems su Falso nel file di progetto.

Entrambe le regressioni verranno ripristinate nella prossima versione stabile.

Versione 1.1 Preview 2 (1.1.0-preview2)

Questa è la seconda versione del canale di anteprima per la versione 1.1. Supporta tutte le funzionalità del canale di anteprima (vedere Funzionalità disponibili per canale di rilascio).

In un'app esistente che usa Windows App SDK1.3 è possibile aggiornare il pacchetto Nuget alla preview2 1.1.0 (vedere la sezione Aggiorna un pacchetto in Installazione e gestione pacchetti in Visual Studio usando Gestione pacchetti NuGet). Consultare anche la sezione Ultimi download di Windows App SDK per il runtime aggiornato e MSIX.

Nota

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK: 6.0.202, 6.0.104, 5.0.407, 5.0.213 (o versione successiva). Per aggiornare la versione di .NET SDK, visitare .NET Download o aggiornare la versione più recente di Visual Studio. 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 WinRT.Runtime.dll versione 1.6 o successiva".

Oltre a tutte le funzionalità di Preview 1 , le sezioni seguenti descrivono funzionalità, limitazioni e problemi noti nuovi e aggiornati per questa versione.

Notifiche (1.1.0-preview2)

Problemi risolti:

  • Un'app senza l'identità del pacchetto che invia notifiche visualizzerà l'icona dell'app nella notifica se questa fa parte della risorsa dell'app. Se la risorsa dell'app non ha un'icona, viene usata l'icona dell'app predefinita di Windows.
  • Un'app WinUI 3 che non è in esecuzione non può essere ora attivata in background tramite una notifica.

Regressione dalla versione 1.1 Preview 1: supporto delle notifiche push per le app non incluse nel pacchetto. Ripristino previsto nella versione successiva.

Limitazioni note:

  • È stata introdotta l'API PushNotificationManager::IsSupported per verificare se le app autonome supportano le notifiche push. Tuttavia, questa API non funziona ancora come previsto, quindi tenere d'occhio la successiva versione di anteprima per il supporto completo dell'API IsSupported.
  • Alcune app non incluse nel pacchetto vedranno le icone dell'app copiate in modo non corretto in AppData\LocalMicrosoftWindowsAppSDK. Per la versione successiva, verranno invece copiati in AppData\Local\Microsoft\WindowsAppSDK. Per evitare la perdita di icone, lo sviluppatore deve eliminare manualmente l'icona dell'app nel percorso non corretto dopo l'aggiornamento alla versione successiva.
  • L'icona dell'app e il recupero del nome visualizzato per le notifiche tramite collegamenti non sono supportati. Tuttavia, stiamo lavorando per un supporto in una versione futura.

Distribuzione

Nuove funzionalità:

Limitazioni note:

  • La distribuzione autonoma è supportata solo in Windows 10, 1903 e versioni successive.

Windowing

Per semplificare l'accesso alla programmazione alle funzionalità implementate in USER32.dll (vedere Windows e messaggi), questa versione presenta più funzionalità nella stessa AppWindow.

Nuove funzionalità:

  • Le app con finestre esistenti hanno un maggiore controllo sulla modalità di visualizzazione di una finestra richiamando AppWindow.ShowOnceWithRequestedStartupState l'equivalente di ShowWindow(SW_SHOWDEFAULT).
  • Le app possono visualizzare, ridurre al minimo e specificare se la finestra deve essere attivata o meno al momento dell'esecuzione della chiamata.
  • Le app possono ora impostare le dimensioni dell'area client di una finestra nelle coordinate Win32.
  • Sono state aggiunte API per supportare la gestione degli ordini z delle finestre.
  • Le app che disegnano barre dei titoli personalizzate con AppWindowTitleBar.ExtendsContentIntoTitleBar possono impostare un'opzione PreferredTitleBarHeight. È possibile scegliere una barra del titolo di altezza standard o una barra del titolo alta che offre più spazio per il contenuto interattivo. Vedere Barra del titolo nelle linee guida per la progettazione fluente in modo da avere consigli su quando usare una barra del titolo alta.

Limitazioni note:

  • Il supporto della barra del titolo alta è disponibile solo in Windows 11. Stiamo lavorando per portare questo livello inferiore insieme ad altre API della barra del titolo personalizzate.

WinUI 3 (1.1.0-preview2)

Problemi risolti:

  • È stato risolto un problema che causava l'arresto anomalo delle app C# con WebView2 all'avvio quando il runtime C/C++ (CRT) non è installato aggiornando WebView2 SDK da 1020.46 a 1185.39.
  • È stato risolto un problema che creava alcuni arrotondamenti degli angoli per mostrare una sfumatura quando dovrebbero presentare un colore a tinta unita. Per ottenere altre informazioni, vedere problema 6076 & problema 6194 su GitHub.
  • È stato risolto un problema per cui gli stili aggiornati mancavano da generic.xaml.
  • Correzione del problema del ciclo di layout che causa l'arresto anomalo di un'app durante lo scorrimento fino al termine di un controllo ListView. Per altre informazioni, vedere il problema 6218 su GitHub.

Prestazioni

Le applicazioni C# presentano diversi miglioramenti delle prestazioni. Per altri dettagli, vedere le Note sulla versione di C#/WinRT 1.6.1.

Versione 1.1 Preview 1 (1.1.0-preview1)

Questa è la prima versione del canale di anteprima per la versione 1.1. Supporta tutte le funzionalità del canale di anteprima (vedere Funzionalità disponibili per canale di rilascio).

In un'app esistente che usa Windows App SDK1.3 è possibile aggiornare il pacchetto Nuget alla preview1 1.1.0 (vedere la sezione Aggiorna un pacchetto in Installazione e gestione pacchetti in Visual Studio usando Gestione pacchetti NuGet). Consultare anche la sezione Ultimi download di Windows App SDK per il runtime aggiornato e MSIX.

Nelle sezioni seguenti vengono descritte le funzionalità nuove e aggiornate, le limitazioni e i problemi noti di questa versione.

WinUI 3 (1.1.0-preview1)

Problema noto: gli utenti non sono in grado di rilasciare un elemento quando il trascinamento della selezione è abilitato.

Supporto con privilegi elevati (amministratore)

Usando Windows App SDK 1.1 Preview 1, le app (incluso WinUI 3) potranno essere eseguite con privilegi elevati.

Limitazioni importanti:

  • Attualmente disponibile solo in Windows 11. Ma stiamo valutando l'introduzione di questo livello di supporto in una versione successiva.

Problemi noti:

  • Le applicazioni WinUI 3 vanno in crash quando si trascina un elemento durante un'interazione di trascinamento.

Distribuzione autonoma

Windows App SDK 1.1 introdurrà il supporto per la distribuzione autonoma. La nostra panoramica della distribuzione di Windows App SDK illustra in dettaglio le differenze tra la distribuzione dipendente dal framework e quella autonoma e le attività iniziali.

Problemi noti:

  • Un'app C++ inclusa nel pacchetto deve aggiungere il codice seguente alla fine del file di progetto per risolvere un bug nel file autonomo .targets che rimuove i riferimenti al framework a VCLibs:

    <PropertyGroup>
    <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
</PropertyGroup>

<Target Name="_RemoveFrameworkReferences"
    BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
        <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
    </ItemGroup>
</Target>

  • Supportato solo su Windows 10 1903 e versioni successive.

Notifiche (1.1.0-preview1)

Gli sviluppatori di app incluse nel pacchetto (inclusi quelli con posizione esterna) e le app non incluse nel pacchetto possono ora inviare notifiche di Windows.

Nuove funzionalità:

  • Supporto per le notifiche app incluse nel pacchetto e non incluse nel pacchetto. Dettagli completi su GitHub
    • Gli sviluppatori possono inviare notifiche dell'app, note anche come notifiche di tipo avviso popup, localmente o dal proprio servizio cloud.
  • Supporto per le notifiche push per le app incluse nel pacchetto e non incluse nel pacchetto. Dettagli completi su GitHub
    • Gli sviluppatori possono inviare notifiche non elaborate o notifiche delle app dal proprio servizio cloud.

Limitazioni:

  • Le app pubblicate come autonome potrebbero non supportare le notifiche push. Tenere d'occhio la versione di anteprima successiva per un'API IsSupported per verificare la disponibilità del supporto delle notifiche push.
  • Le app non incluse nel pacchetto che inviano notifiche dell'app non vedranno l'icona dell'app nella relativa notifica, a meno che non siano applicazioni console. Le app console non incluse nel pacchetto devono seguire i modelli mostrati nell'esempio ToastNotificationsDemoApp .
  • È necessario installare il runtime di Windows App SDK per supportare le notifiche push; consultare la sezione Ultimi download di Windows App SDK per il programma di installazione.
  • Un'app WinUI 3 che non è in esecuzione non può essere attivata in background tramite una notifica. Tuttavia, stiamo lavorando per un supporto in una versione futura.

Environment Manager (1.1.0-preview1)

Insieme di API che consente agli sviluppatori di aggiungere, rimuovere e modificare le variabili di ambiente senza dover usare direttamente l'API del Registro di sistema.

Nuove funzionalità:

  • Fornisce la rimozione automatica di tutte le variabili di ambiente quando viene disinstallata un'app che usa gestione ambiente.

Limitazioni:

  • Attualmente non disponibile nelle app C#. Ma stiamo valutando l'introduzione di questa funzionalità alle app C# in una versione successiva.

Altre limitazioni e problemi noti

  • Se si usa C# con 1.1.0 Preview 1, è necessario usare almeno una delle seguenti versioni di .NET SDK: .NET SDK 6.0.201, 6.0.103, 5.0.212 o 5.0.406. Per aggiornare .NET SDK, è possibile eseguire l'aggiornamento alla versione più recente di Visual Studio oppure visitare Download .NET.