Condividi tramite

Note sulla versione del canale stabile per Windows App SDK 0.8

  • Articolo

Il canale stabile fornisce versioni di Windows App SDK supportati per l'uso da parte delle app negli ambienti di produzione. Le app che usano la versione stabile del Windows app SDK possono anche essere pubblicate in Microsoft Store.

Collegamenti importanti:

Ultime note sulla versione del canale Stabile

Vedere Download per Windows App SDK.

Nota

Le estensioni di Visual Studio (VSIX) di Windows App SDK non vengono più distribuite come download separato. Sono disponibili in Visual Studio Marketplace all'interno di Visual Studio.

Versione 0.8

La versione più recente disponibile della derivazione 0.8.x del canale stabile di Windows App SDK è la versione 0.8.12.

Nota

Windows App SDK era precedentemente noto con il nome in codice Project Reunion. Alcuni asset SDK nella versione 0.8 e precedenti usano ancora il nome del codice. Alcune aree usano ancora Project Reunion quando si fa riferimento a un asset esistente o a una versione precedente specificata.

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.

Nota

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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".

Correzioni di bug (0.8.12)

  • È 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

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

Nota

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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".

Correzioni di bug (0.8.11)

  • Correzione della regressione che causa l'attivazione dell'evento di stato attivo perso quando si seleziona il testo usando il mouse.

Versione 0.8.10

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

Nota

Per gli sviluppatori C#, è necessaria una delle seguenti versioni di .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (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".

Correzioni di bug (0.8.10)

  • Sono stati risolti problemi che causano un arresto anomalo delle app durante un'operazione di trascinamento della selezione.

Nota

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.

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".

Correzioni di bug (0.8.8)

  • 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 dall'interfaccia utente (Automazione interfaccia utente) in esecuzione in processi esterni.
  • Correzione del problema di stabilità dell'app con l'input penna.
  • È stato risolto un problema per cui il rendering delle icone png in un menu veniva notevolmente ritardato a causa dell'interfaccia utente.

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 .csproj file con la versione dell'SDK di destinazione dell'app dalla TargetFramework proprietà. Ad esempio:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.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 di bug (0.8.6)

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 di bug (0.8.5)

  • È 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.

Le limitazioni e i problemi noti per la versione 0.8 si applicano anche alla versione 0.8.5, a meno che non sia contrassegnato diversamente nella sezione successiva.

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 di bug (0.8.4)

  • 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 ritaglia erroneamente

Le limitazioni e i problemi noti per la versione 0.8 si applicano anche alla versione 0.8.4, a meno che non sia contrassegnato diversamente nella sezione successiva.

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 di bug (0.8.3)

Lo stato attivo della tastiera è andato perduto quando una finestra è stata ridotta a icona e quindi ripristinata, richiedendo un clic del mouse per ripristinare lo stato attivo.

Le limitazioni e i problemi noti per la versione 0.8 si applicano anche alla versione 0.8.3, a meno che non sia contrassegnato diversamente nella sezione successiva.

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 di bug (0.8.2)

  • 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
  • Garbage Collection di EventSource<T> causa il susseguente errore per annullare la sottoscrizione dei gestori (vedere Problema di GitHub per altri 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

Le limitazioni e i problemi noti per la versione 0.8 si applicano anche alla versione 0.8.2, a meno che non sia contrassegnato diversamente nella sezione successiva.

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 di bug (0.8.1)

  • 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 una volta ricevuto lo stato attivo
  • 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.

Le limitazioni e i problemi noti per la versione 0.8 si applicano anche alla versione 0.8.1, a meno che non sia contrassegnato diversamente nella sezione successiva.

Versione 0.8.0 stabile

Nuove funzionalità e aggiornamenti

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 ora può essere usato in qualsiasi app WinUI 3.

  • 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 provoca l’arresto anomalo dell'applicazione
    • NavigationView causa un arresto anomalo nella piattaforma UWP, Reunion 0.5 Preview
    • ProgressBar non mostra la differenza tra l'opzione Paused e Error
    • Arresto anomalo in RichEditBox durante la copia/incolla/modifica dello stile di testo
    • I pulsanti della didascalia della finestra non sono posizionati quando SetTitleBar non è impostato o risulta nullo

    Per l'elenco completo dei bug risolti in questa versione, vedere il nostro repository di GitHub..

  • L'ColorHelper.ToDisplayName API non è più disponibile.

  • I seguenti tipi sono stati rimossi:

    • Microsoft.Graphics.IGeometrySource2D
    • Microsoft.Graphics.IGeometrySource2DInterop

    In alternativa, usare Windows.Graphics.IGeometrySource2D e Windows.Graphics.IGeometrySource2DInterop.

  • Tutti i tipi nello Microsoft.System spazio dei nomi sono stati spostati nello Microsoft.UI.Dispatching spazio dei nomi, inclusa la classe DispatcherQueue.

  • La AcrylicBrush.BackgroundSource proprietà è stata rimossa, perché HostBackdrop non è supportata come in BackgroundSource WinUI 3.

Per maggiori informazioni su WinUI, vedere WinUI.

Per visualizzare 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 iniziare a sviluppare con WinUI, vedere gli articoli seguenti:

DWriteCore:

Questa versione di DWriteCore include le seguenti funzionalità nuove e aggiornate. DWriteCore è stato introdotto e descritto nella Panoramica di DWriteCore.

Nota

DWriteCoreCreateFactory è funzionalmente uguale alla funzione DWriteCreateFactory esportata dalla versione di sistema di DirectWrite. La funzione DWriteCore ha un nome diverso per evitare ambiguità nell'evento che si collega sia DWriteCore.lib che DWrite.lib.

Per informazioni di riferimento sulle API DWriteCore e DirectWrite, vedere Informazioni di riferimento sulle API DWriteCore e Informazioni di riferimento sulle API DirectWrite.

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.

Limiti

  • 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 incluse nel pacchetto, è necessario usare il canale di versione sperimentale.

Importante

Se si sta lavorando a un'app UWP, fare riferimento a Eseguire la migrazione dalla piattaforma UWP a SDK per app di Windows.

Problemi noti

  • Gli strumenti winUI 3, ad esempio Struttura ad albero visuale live, Esplora proprietà attive e Ricaricamento rapido nella versione 0.8 e successive richiedono Visual Studio 2019 16.11 Preview 3 e versioni successive.

  • Le app attualmente che usano WinUI 3 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 l'errore seguente quando si passa una matrice di enumerazioni: Object contains non-primitive or non-blittable data. questa opzione è corretta 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.