Freigeben über

Versionshinweise zum stabilen Kanal für das Windows App SDK 1.3

  • Artikel

Der stabile Kanal stellt Releases des Windows App SDK bereit, die für die Verwendung durch Apps in Produktionsumgebungen unterstützt werden. Apps, die die stabile Version des Windows App SDK verwenden, können auch im Microsoft Store veröffentlicht werden.

Wichtige Links:

Release des neuesten stabilen Kanals:

Downloads für das Windows App SDK

Hinweis

Die Windows App SDK Visual Studio Extensions (VSIX) werden nicht mehr als separater Download angeboten. Sie sind auf dem Visual Studio Marketplace innerhalb von Visual Studio erhältlich.

Version 1.3.3 (1.3.230724000)

Dies ist ein Wartungsrelease des Windows App SDK, das wichtige Fehlerbehebungen für das Release 1.3 enthält.

  • Es wurde ein Problem behoben, bei dem die Maus manchmal nicht mehr funktionierte, wenn ein Dialogfeld geschlossen wurde.
  • Es wurde ein Problem bei der Bereitstellung behoben, das die Installation von Anwendungen verhinderte, weil die Paketversionen auf dem System nicht übereinstimmten. Weitere Informationen finden Sie im GitHub-Problem #3740.
  • Es wurde ein Problem mit der Positionierung des Kontextmenüs in Windows App SDK 1.3 behoben.
  • Es wurde ein Problem behoben, das dazu führte, dass einige WinUI3-Apps in bestimmten Situationen abstürzten, wenn die App geschlossen wurde, weil XAML sich zu früh beendet hat.
  • Es wurde ein Problem behoben, bei dem die Schriftsymbole in Sprachen mit Rechts-nach-Links-Ausrichtung nicht richtig gespiegelt wurden. Weitere Informationen finden Sie im GitHub-Problem #7661.
  • Es wurde ein Problem behoben, das zum Absturz einer App beim Herunterfahren führte, wenn Ressourcen in einer falschen Reihenfolge heruntergefahren wurden. Weitere Informationen finden Sie im GitHub-Problem #7924.

Version 1.3.2 (1.3.230602002)

Dies ist ein Wartungsrelease des Windows App SDK, das wichtige Fehlerbehebungen für das Release 1.3 enthält.

  • Absturz behoben, der beim Festlegen eines geschützten Cursors auftrat.
  • Leistungsproblem in XamlMetadataProvider behoben, das während des App-Starts auftrat. Weitere Informationen finden Sie im GitHub-Problem #8281.
  • Problem mit Links und Toucheingaben in RichTextBlock behoben. Weitere Informationen finden Sie im GitHub-Problem #6513.
  • Problem mit Scrollen und Touchpads in WebView2 wurde behoben. Weitere Informationen finden Sie im GitHub-Problem #7772.
  • Problem behoben, das dazu führte, dass ein Update des Windows App SDK manchmal einen Neustart von Visual Studio erforderte. Weitere Informationen finden Sie im GitHub-Problem #3554.
  • Störende Ausnahme beim Herunterfahren bei der Ausführung in einem Debugger behoben.

Version 1.3.1 (1.3.230502000)

Dies ist ein Wartungsrelease des Windows App SDK, das wichtige Fehlerbehebungen für das Release 1.3 enthält.

  • Ein Problem wurde behoben, das zum Absturz von Apps führte, wenn SystemBackdrop festgelegt wurde und der Inhalt NULL war. Weitere Informationen finden Sie im GitHub-Problem #8416.
  • Ein Problem wurde behoben, das zum Absturz von Apps führte, wenn der Fenstertitel in XAML festgelegt wurde – eine neue Funktion, die in 1.3.0 hinzugefügt wurde. Weitere Informationen finden Sie im GitHub-Problem #3689.
  • Ein Problem wurde behoben, bei dem ein Fenster fälschlicherweise den Fokus erhielt, wenn der Inhalt sich änderte.
  • Es wurde ein Problem beim Erstellen von C++-Projekten mit den WinAppSDK 1.3-Projektvorlagen behoben.
  • Aktualisierte Vorlagen im Visual Studio Marketplace

Neue und aktualisierte Features und bekannte Probleme bei Version 1.3

In den folgenden Abschnitten werden neue und aktualisierte Features und bekannte Probleme für Version 1.3 beschrieben.

In einer vorhandenen Windows App SDK 1.2-App können Sie Ihr NuGet-Paket auf 1.3.230331000 aktualisieren (weitere Informationen finden Sie im Abschnitt Aktualisieren eines Pakets in Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager).

Die aktualisierten Runtime- und MSIX-Pakete finden Sie unter Neueste Windows App SDK-Downloads.

XAML-Hintergrund-APIs

Mit in das XAML-Fenster integrierten Eigenschaften können Mica- & Background Acrylic-Hintergründe jetzt einfacher in Ihrer WinUI 3-App verwendet werden. Informationen zu den XAML-Hintergrundeigenschaften finden Sie in der API-Dokumentation zu SystemBackdrop und MicaBackdrop.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Durch Ersetzen mehrerer Zeilen mit Codebausteinen können Sie AppWindow-APIs jetzt direkt aus einem Fenster über Window.AppWindow verwenden.

Neue Features aus WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId ersetzt die veraltete MddGetGenerationId-Funktion.
  • Umgebungs-Manager: EnvironmentManager.AreChangesTracked informiert Sie darüber, ob Änderungen am Umgebungs-Manager in Ihrer Anwendung nachverfolgt werden können.
  • Ein neues Ereignis, DebugSettings.XamlResourceReferenceFailed, wird jetzt ausgelöst, wenn ein referenzierter Static-/ThemeResource-Lookup nicht aufgelöst werden kann. Dieses Ereignis gibt Zugriff auf eine Ablaufverfolgung, die angibt, wo das Framework nach diesem Schlüssel gesucht hat, damit Sie Fehler bei Static- & ThemeResource-Lookups besser debuggen können. Weitere Informationen finden Sie in der API-Spezifikation Tracing XAML resource reference lookup failures auf GitHub.

Weitere Updates

  • Informationen zu weiteren Problemen, die in diesem Release behoben wurden, finden Sie bei den Milestones für WinAppSDK 1.3 auf der GitHub-Seite WinAppSDK.
  • Informationen zu weiteren Problemen, die in diesem Release behoben wurden, finden Sie bei den Milestones für WinUI 3 in WinAppSDK 1.3 auf der GitHub-Seite microsoft-ui-xaml.
  • Mit dem neuesten experimentellen VSIX-Paket können Sie Ihre App jetzt über das Visual Studio-Menü anstatt in Ihrer Projektdatei von der nicht gepackten in die gepackte Version konvertieren.

Bekanntes Problem

Aufgrund einer kürzlich erfolgten Änderung am XAML-Compiler kann bei einem vorhandenen Projekt, für das ein Upgrade auf Version 1.3 ausgeführt wird, in Visual Studio ein Buildfehler wie der folgende auftreten:

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

Dies wird dadurch verursacht, dass Visual Studio eine zwischengespeicherte XAML-Compilertask-DLL aus Version 1.2 verwendet, sie aber mit inkompatibler MSBuild-Logik aus Version 1.3 verarbeitet, wie im obigen Fehlertext zu sehen. Die Problemumgehung besteht darin, Visual Studio zu schließen, neu zu starten und die Projektmappe neu zu laden.