Note sulla versione di Windows App SDK 0.8

È possibile scegliere tra i canali Stabile, Anteprima e Sperimentale a seconda delle esigenze di sviluppo, dalle build di produzione affidabili all'accesso anticipato alle funzionalità future. Altre informazioni sui canali di rilascio.

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

Versione 0.8.12

Si tratta di una versione di manutenzione di Windows App SDK che include delle correzioni di bug critiche per la versione 0.8.0.

Correzioni
  • È stato risolto un problema per cui le app con SwapChainPanel o WebView2 si bloccavano in modo imprevedibile a causa di una violazione di accesso.

Versione 0.8.11

Correzioni
  • Correzione di una regressione che causava l'evento di perdita del fuoco quando si selezionava il testo con il mouse.

Versione 0.8.10

Correzioni
  • Sono stati risolti problemi che causavano il blocco delle applicazioni durante un'operazione di trascinamento della selezione.

Annotazioni

Windows App SDK 0.8.9 non è stato rilasciato. La versione rilasciata direttamente dopo la versione 0.8.8 è la 0.8.10.

--- ---

Versione 0.8.8

Si tratta di una versione di manutenzione di Windows App SDK che include delle correzioni di bug critiche per la versione 0.8.0.

Annotazioni

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK (o successive): 6.0.202, 6.0.104, 5.0.407, 5.0.213. Per aggiornare la versione di .NET SDK, visitare Downloads .NET o eseguire l'aggiornamento alla 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"..

Correzioni
  • Sono stati corretti i problemi di input tattile in TextBox per quanto riguarda la tastiera morbida e l'interazione generale. Questi problemi influiscono anche sui tasti di scelta rapida. Per altre informazioni, vedere il problema 6291 su GitHub.
  • È stato risolto un problema a causa del quale una finestra dell'app viene talvolta visualizzata come inattiva quando è attiva.
  • È stato risolto un problema di prestazioni causato da UIA (Automazione interfaccia utente) che opera in processi esterni.
  • Correzione del problema di stabilità dell'app con l'input tramite penna.
  • È stato risolto un problema per cui il rendering delle icone png in un menu veniva notevolmente ritardato a causa di UIA.

Versione 0.8.7

Si tratta di una versione di manutenzione di Windows App SDK che include diversi aggiornamenti delle prestazioni per le applicazioni C#/.NET. Per eseguire l'aggiornamento a questa versione, è necessario fare riferimento alla versione più recente del pacchetto di Windows SDK. A tale scopo, aggiungere la proprietà <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> al file .csproj con la versione dell'SDK che l'app sta utilizzando dalla proprietà TargetFramework. Per esempio:

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <OutputType>WinExe</OutputType>
        <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
        <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
        <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
    </PropertyGroup>
    ...

Questa versione della proiezione di Windows SDK sarà disponibile in una versione successiva di manutenzione di .NET 6. Dopo aver reso disponibile l'aggiornamento di .NET SDK, è necessario rimuovere la <WindowsSdkPackageVersion> proprietà dal file di progetto.

Se non si imposta questa proprietà, verrà visualizzato un errore simile al seguente: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."


Versione 0.8.6

Si tratta di una versione di manutenzione di Windows App SDK che include diversi miglioramenti delle prestazioni per le applicazioni C#/.NET per la versione 0.8.0.

Per eseguire l'aggiornamento a questa versione di Windows App SDK, è necessario che sia installato l'aggiornamento di dicembre di .NET SDK più recente. Vedere Scaricare .NET e .NET 5 raggiungerà la fine del supporto il 10 maggio 2022. Se non è installata la versione minima richiesta di .NET SDK, verrà visualizzato un errore simile al seguente: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Correzioni

Per un elenco dettagliato dei miglioramenti delle prestazioni, vedere le note sulla versione di C#/WinRT 1.4.1.


Versione 0.8.5

Si tratta di una versione di manutenzione di Windows App SDK che include le correzioni di bug più critiche per la versione 0.8.0.

Correzioni
  • È stato risolto un problema che causava l'arresto anomalo delle app WinUI usando l'input del puntatore.
  • È stato risolto un problema per cui i pulsanti della barra del titolo (min, max, close) non avrebbero angoli arrotondati in Windows 11.
  • È stato risolto un problema che causava la mancata visualizzazione delle opzioni di ridimensionamento del layout quando si passa il puntatore del mouse sul pulsante ingrandisci/ripristina in Windows 11.
  • È stato risolto un problema che causava un arresto anomalo del sistema in cui si creava un oggetto PointCollection. Per altre informazioni, vedere il problema 971 su GitHub.

Versione 0.8.4

Si tratta di una versione di manutenzione di Windows App SDK che include le correzioni di bug più critiche per la versione 0.8.0.

Correzioni
  • Correzioni per le barre del titolo personalizzate in modo che ContentDialog non lo copri e i pulsanti della barra del titolo vengano arrotondati.
  • Correzione di un arresto anomalo nell'elaborazione delle immagini quando viene modificata la scala di visualizzazione.
  • Corregge i bug di ritaglio in cui l'interfaccia utente scompare o è ritagliata in modo errato

Versione 0.8.3

Si tratta di una versione di manutenzione di Windows App SDK che include le correzioni di bug più critiche per la versione 0.8.0.

Correzioni
  • Il focus della tastiera veniva perso quando una finestra veniva ridotta a icona e successivamente ripristinata, richiedendo un clic del mouse per ripristinarlo.

Versione 0.8.2

Si tratta di una versione di manutenzione di Windows App SDK che include le correzioni di bug più critiche per la versione 0.8.0.

Correzioni
  • Windows App SDK e WinUI 3 sono ora supportati in Visual Studio 2022 Preview 2 e versioni successive.
  • Per le app .NET, è possibile che venga visualizzato l'errore seguente quando si passa una matrice di enumerazioni: Object contains non-primitive or non-blittable data.
  • La scrittura tramite il pannello Scrittura manuale all'interno di una casella di testo causa un arresto anomalo
  • Le Icone/immagini vengono sempre caricate al valore di scala del 100% anziché in base al valore di scala del monitoraggio
  • La garbage collection di EventSource<T> causa l'errore successivo nel disiscrivere i gestori (vedere Problema di GitHub per ulteriori dettagli)
  • Correzione della sicurezza: vedere CVE-2021-34533 per altri dettagli.
  • SwapChainPanel.CompositionScaleChanged talvolta restituisce valori CompositionScale non corretti dopo la modifica della scala di visualizzazione

Versione 0.8.1

Si tratta di una versione di manutenzione di Windows App SDK che include alcune correzioni di bug critiche per la versione 0.8.0.

Correzioni
  • Windows App SDK non può essere eseguito nella build più recente di Windows Insider
  • Arresto anomalo in EditableComboBox quando si immette un valore che non viene visualizzato nell'elenco a discesa
  • WebView2 non consente all'utente di uscire con il tasto Tab una volta ricevuta l'attenzione.
  • Qualificare completamente lo spazio dei nomi Windows.Foundation.Metadata.DefaultOverload nel codice generato da WinUI per evitare ambiguità dello spazio dei nomi
  • Correzione della sicurezza: vedere CVE-2021-34489 per altri dettagli.

Versione 0.8.0 stabile

Questa versione supporta tutte le funzionalità del canale stabile.

> WinUI 3 > Questa versione include molte correzioni di bug e una stabilizzazione migliorata in WinUI 3. Queste sono tutte le nuove modifiche apportate a WinUI 3 dalla versione di WinUI 3 - Project Reunion 0.5: > >: il controllo Pivot è stato aggiunto di nuovo in e può ora essere usato in qualsiasi app WinUI. >: tutte le correzioni di bug di Project Reunion v0.5.5, v0.5.6 e v0.5.7 sono incluse in questa versione. - Nuove correzioni di bug, tra cui: - Fare clic con il pulsante destro del mouse in TextBox causa il crash dell'applicazione - NavigationView causa un crash in UWP, Reunion 0.5 Preview - ProgressBar non mostra la differenza tra l'opzione Pausa e l'opzione Errore - Crash in RichEditBox durante la copia/incolla/modifica dello stile del testo - I pulsanti della didascalia della finestra sono posizionati in modo errato quando SetTitleBar non è impostato o è nullo **Per l'elenco completo dei bug risolti in questa versione, vedere [il repository GitHub](https://aka.ms/winui3/0.8/bugs-fixed).** - L'API 'ColorHelper.ToDisplayName' non è più disponibile. >: sono stati rimossi i tipi seguenti: > - 'Microsoft.Graphics.IGeometrySource2D' > - 'Microsoft.Graphics.IGeometrySource2DInterop' > > usare invece 'Windows.Graphics.IGeometrySource2D' e 'Windows.Graphics.IGeometrySource2DInterop'. > >: tutti i tipi nello spazio dei nomi 'Microsoft.System' sono stati spostati nello spazio dei nomi 'Microsoft.UI.Dispatching', inclusa la classe [DispatcherQueue](/windows/windows-app-sdk/api/winrt/microsoft.ui.dispatching.dispatcherqueue). > >: la proprietà 'AcrylicBrush.BackgroundSource' è stata rimossa, perché 'HostBackdrop' non è supportato come 'BackgroundSource' in WinUI 3. > > Per altre informazioni su WinUI, vedere [WinUI](.. /.. /winui/index.md). Per vedere i controlli e le funzionalità di WinUI 3 in azione, è possibile clonare e compilare l'app della raccolta WinUI 3 [da GitHub](https://github.com/microsoft/WinUI-Gallery/tree/main)) oppure scaricare l'app [dal Microsoft Store](https://apps.microsoft.com/detail/9P3JFPWWDZRC). > > Per iniziare a sviluppare con WinUI, vedere gli articoli seguenti: > > : [modelli WinUI 3 in Visual Studio](.. /.. /winui/winui3/winui-project-templates-in-visual-studio.md) > - [Creare il primo progetto WinUI 3 (Windows App SDK)](.. /.. /winui/winui3/create-your-first-winui3-app.md) > - [Compilare un'app .NET C# con interoperabilità WinUI 3 e Win32](.. /.. /winui/winui3/desktop-winui3-app-with-basic-interop.md) > - [Riferimenti API WinUI 3](/windows/winui/api)
> DWriteCore > Questa versione di DWriteCore include le funzionalità nuove e aggiornate seguenti. DWriteCore è stato introdotto e descritto in [Panoramica di DWriteCore](/windows/win32/directwrite/dwritecore-overview). > > - DWriteCore include ora il supporto per la sottolineatura—, vedere [**IDWriteTextLayout::GetUnderline**](/windows/win32/api/dwrite/nf-dwrite-idwritetextlayout-getunderline) e [**IDWriteTextLayout::SetUnderline**](/windows/win32/api/dwrite/nf-dwrite-idwritetextlayout-setunderline). - Supporto per la funzione di barratura—per informazioni vedere [**IDWriteTextLayout::GetStrikethrough**](/windows/win32/api/dwrite/nf-dwrite-idwritetextlayout-getstrikethrough) e [**IDWriteTextLayout::SetStrikethrough**](/windows/win32/api/dwrite/nf-dwrite-idwritetextlayout-setstrikethrough). > - Supporto per il testo verticale tramite [**IDWriteTextLayout**](/windows/win32/api/dwrite/nn-dwrite-idwritetextlayout)—vedere [Testo verticale](/windows/win32/directwrite/vertical-text). > : tutti i metodi delle interfacce [**IDWriteTextAnalyzer**](/windows/win32/api/dwrite/nn-dwrite-idwritetextanalyzer) e [**IDWriteTextAnalyzer1**](/windows/win32/api/dwrite_1/nn-dwrite_1-idwritetextanalyzer1) vengono implementati. > - La funzione libera [**DWriteCoreCreateFactory**](/windows/windows-app-sdk/api/win32/dwrite_core/nf-dwrite_core-dwritecorecreatefactory) crea un oggetto factory usato per la successiva creazione di singoli oggetti DWriteCore. > > [! NOTA] > [**DWriteCoreCreateFactory**](/windows/windows-app-sdk/api/win32/dwrite_core/nf-dwrite_core-dwritecorecreatefactory) è funzionale analogamente alla funzione [**DWriteCreateFactory**](/windows/win32/api/dwrite/nf-dwrite-dwritecreatefactory) esportata dalla versione di sistema di DirectWrite. La funzione DWriteCore ha un nome diverso per evitare ambiguità nel caso in cui si collegano sia 'DWriteCore.lib' che 'DWrite.lib'. > > Per informazioni di riferimento sulle API DWriteCore e DirectWrite, vedere [Informazioni di riferimento sulle API DWriteCore](/windows/windows-app-sdk/api/win32/_dwritecore/) e [Guida di riferimento all'API DirectWrite](/windows/win32/directwrite/reference).
MRTCore
  • L'Azione di compilazione per le risorse viene impostata automaticamente quando si aggiunge la risorsa al progetto, riducendo la necessità di una configurazione manuale del progetto.
Limitazioni
  • Questa versione non è attualmente supportata nel canale dev del programma Windows Insider. Questa operazione è corretta nella versione 0.8.1.

  • App desktop (C# o C++ desktop): questa versione è supportata per l'uso solo nelle app desktop (C++ o C#) incluse nei pacchetti con MSIX. Per usare Windows App SDK nelle app desktop non in pacchetto, è necessario usare il canale di versione sperimentale.

Problemi noti
  • Gli strumenti WinUI 3, come Live Visual Tree, Live Property Explorer e Hot Reload nella versione 0.8 e successive, richiedono Visual Studio 2019 16.11 Preview 3 e versioni successive.

  • Le app attualmente che usano WinUI e Windows App SDK 0.8 non possono usare librerie di classi che usano Project Reunion 0.5. Aggiornare le librerie di classi per usare Windows App SDK 0.8.

  • Le app .NET devono puntare alla build 18362 o successiva: Il TFM deve essere impostato su net6.0-windows10.0.18362 o successivo mentre il progetto di packaging deve essere impostato su 18362 o successivo. Per altre informazioni, vedere il Problema 921 su GitHub.

  • È possibile che si verifichi un arresto anomalo quando si passa di frequente tra la modalità chiara e quella scura.

  • Per le app .NET, è possibile che venga visualizzato il seguente errore quando si passa un array di enumerazioni: Object contains non-primitive or non-blittable data.Questo problema è stato risolto nella versione 0.8.2.

  • Per le app .NET, attualmente non è possibile rifiutare esplicitamente l'indicizzazione di un'immagine come risorsa dell'app usando l'interfaccia utente di Visual Studio. Per risolvere questo problema, aggiungere un file Directory.Build.targets (vedere Personalizza la compilazione - Visual Studio per istruzioni) al progetto e rimuovere le immagini come indicato di seguito:

    • Per rimuovere immagini specifiche (si noti che è necessario il percorso relativo):

      <Project>
      <ItemGroup>
          <Content Remove="..\Bitmap1.bmp" />
      </ItemGroup>
      </Project>
      
      • Per rimuovere le immagini in base ai metadati:
      <Project>
      <ItemGroup>
          <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
      </ItemGroup>
      </Project>
      

      Una correzione per questo problema è pianificata per una versione futura. A questo punto, le soluzioni alternative precedenti non saranno più necessarie.

Versione 0.8 Preview (0.8.0-preview)

WinUI 3

Questa versione introduce correzioni di bug critiche (incluse quelle corrette nelle versioni di manutenzione 0.5) e altre modifiche per WinUI. Per un elenco completo, vedi le note generali e sulla versione: WinUI 3 - Project Reunion 0.8 Preview (maggio 2021).

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 delle app.

Per altre informazioni, vedere Istanze dell'app con l'API del ciclo di vita dell'app e Attivazione avanzata con l'API del ciclo di vita dell'app.

Distribuzione per app non in pacchetto (funzionalità sperimentale)

Questa versione introduce nuove funzionalità di distribuzione sperimentale per le app non in pacchetto. Le app senza pacchetto possono ora prendere dinamicamente una dipendenza dai pacchetti di runtime di Windows App SDK, in modo da poter continuare a usare il tuo programma MSI o di installazione esistente per distribuire le app. Questa funzionalità è disponibile tramite le funzionalità seguenti:

  • Programma di installazione autonomo per Windows App SDK.
  • Bundle di pacchetti MSIX che include la funzionalità delle dipendenze dinamiche.

Per ulteriori informazioni, vedi Guida alla distribuzione di Windows App SDK per le app dipendenti dal framework confezionate con posizione esterna o non confezionate.

DWriteCore

Questa versione aggiunge le funzionalità seguenti:

  • Decorazioni di testo (sottolineatura e barrato nell'API di layout di testo)
  • Layout di testo verticale
  • API di crenatura del tipo di carattere
  • Supporto sperimentale per le app non in pacchetto

Per altre informazioni, vedere Migrazione da DirectWrite a DWriteCore.

MRT Core

Questa versione aggiunge le funzionalità seguenti:

  • L'azione di compilazione per le risorse viene ora impostata automaticamente, riducendo la necessità di una configurazione manuale del 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 qualsiasi configurazione di compilazione della CPU: Windows App SDK viene scritto nel codice nativo e pertanto non supporta Qualsiasi configurazione di compilazione della CPU. I modelli WinUI 3 in Visual Studio consentono solo compilazioni specifiche per architettura. Quando si aggiunge l'SDK di Windows App a un'applicazione o a un componente .NET esistente che supporta Qualsiasi CPU, è necessario specificare l'architettura desiderata: , o x86.
  • Le app .NET devono essere destinate alla build 18362 o successiva: Il TFM deve essere impostato su net6.0-windows10.0.18362 o versione successiva e il <TargetPlatformVersion> del progetto di creazione del pacchetto deve essere impostato su 18362 o versione successiva. Per altre informazioni, vedere il noto problema su GitHub.
Campioni

Gli esempi di Windows App SDK non funzionano con questa versione.

Non sono disponibili versioni sperimentali per questa versione.