Note sulla versione del canale stabile per Windows App SDK 1.3

  • 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 1.3.3 (1.3.230724000)

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

  • È stato risolto un problema a causa del quale il mouse smetteva di funzionare quando una finestra di dialogo veniva chiusa.
  • È stato risolto un problema di distribuzione che impediva l'installazione delle app a causa di una mancata corrispondenza delle versioni del pacchetto nel sistema. Per altre informazioni, vedere il problema #3740 su GitHub.
  • Correzione di un problema che interessa il posizionamento del menu di scelta rapida in Windows App SDK 1.3.
  • È stato risolto un problema che causava l'arresto anomalo di alcune app WinUI3, in alcune situazioni, quando l'app veniva chiusa perché XAML si arresta troppo presto.
  • È stato risolto un problema per cui le icone dei caratteri non si rispecchiavano correttamente nelle lingue da destra a sinistra. Per altre informazioni, vedere il problema #7661 su GitHub.
  • È stato risolto un problema che causava l'arresto anomalo di un'app al momento dello spegnimento quando le risorse venivano eliminate in un ordine non valido. Per altre informazioni, vedere il problema #7924 su GitHub.

Versione 1.3.2 (1.3.230602002)

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

  • Correzione di un arresto anomalo durante l'impostazione di un cursore protetto.
  • È stato risolto un problema di prestazioni in XamlMetadataProvider durante l'avvio dell'app. Per altre informazioni, vedere il problema #8281 su GitHub.
  • È stato risolto un problema relativo ai collegamenti ipertestuali e al tocco in un controllo RichTextBlock. Per altre informazioni, vedere il problema #6513 su GitHub.
  • È stato risolto un problema relativo allo scorrimento e ai touchpad in WebView2. Per altre informazioni, vedere il problema #7772 su GitHub.
  • È stato risolto un problema per cui un aggiornamento di Windows App SDK talvolta richiedeva un riavvio di Visual Studio. Per altre informazioni, vedere il problema #3554 su GitHub.
  • Correzione di un'eccezione rumorosa all'arresto durante l'esecuzione in un debugger.

Versione 1.3.1 (1.3.230502000)

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

  • È stato risolto un problema che causava l'arresto anomalo delle app durante l'impostazione di SystemBackdrop se il contenuto era Null. Per altre informazioni, vedere il problema #8416 su GitHub.
  • È stato risolto un problema che causava l'arresto anomalo delle app durante l'impostazione del titolo della finestra in XAML, una nuova funzionalità aggiunta nella versione 1.3.0. Per altre informazioni, vedere il problema #3689 su GitHub.
  • È stato risolto un problema a causa del quale una finestra si concentrava erroneamente quando il contenuto cambiava.
  • Correzione di un problema relativo alla creazione di progetti C++ con i modelli di progetto WinAppSDK 1.3.
  • Modelli aggiornati in Visual Studio Marketplace

Funzionalità nuove e aggiornate e problemi noti per la versione 1.3

Nelle sezioni seguenti vengono descritte le funzionalità nuove e aggiornate e i problemi noti per la versione 1.3.

In un'app esistente di Windows App SDK1.2 è possibile aggiornare il pacchetto Nuget alla versione 1.3.230331000 (vedere la sezione Aggiorna un pacchetto in Installazione e gestione pacchetti in Visual Studio usando Gestione pacchetti NuGet).

Per il runtime e l'MSIX aggiornati, consultare la sezione Ultimi download di Windows App SDK.

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. Per altre informazioni sulle proprietà dello sfondo Xaml, vedere la documentazione dell'API Sfondo di sistema e Sfondo Mica .

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 Finestra tramite Window.AppWindow.

Nuove funzionalità di WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId che sostituisce il MddGetGenerationId deprecato.
  • Responsabile ambiente: EnvironmentManager.AreChangesTracked per indicare se le modifiche apportate al responsabile ambiente possono essere monitorate nell'applicazione.
  • Un nuovo evento DebugSettings.XamlResourceReferenceFailed, viene 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 la specifica dell'API degli errori di ricerca delle risorse XAML di traccia su GitHub.

Altri aggiornamenti

Problema noto

A causa di una modifica recente al compilatore xaml, un progetto esistente che viene aggiornato alla versione 1.3 potrebbe riscontrare un errore di compilazione simile al seguente in Visual Studio:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Ciò è causato da Visual Studio usando una DLL dell'attività del compilatore XAML memorizzata nella cache dalla versione 1.2, ma la causa è la logica MSBuild incompatibile dalla versione 1.3, come illustrato nel testo dell'errore precedente. La soluzione alternativa consiste nell'arrestare Visual Studio, riavviarlo e ricaricare la soluzione.