Teilen über

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

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

Die neueste verfügbare Version der 0.8.x-Reihe des stabilen Kanals des Windows App SDK ist Version 0.8.12.

Hinweis

Das Windows-App SDK war zuvor unter dem Codenamen Project Reunion bekannt. Einige SDK-Ressourcen in Version 0.8 und früher verwenden weiterhin den Codenamen. In einigen Bereichen der Dokumentation wird weiterhin Project Reunion verwendet, wenn auf eine vorhandene Ressource oder ein angegebenes früheres Release verwiesen wird.

Version 0.8.12

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

Hinweis

Für die C#-Entwicklung ist eine der folgenden .NET SDK-Versionen erforderlich: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (oder höher). Zum Aktualisieren Ihrer .NET SDK-Version besuchen Sie die Download-Website für .NET, oder aktualisieren Sie Visual Studio auf die neueste Version. Wenn Sie Ihr NuGet-Paket ohne die erforderliche .NET SDK-Version aktualisieren, wird ein Fehler wie dieser angezeigt: Diese Version von WindowsAppSDK erfordert WinRT.Runtime.dll Version 1.6 oder höher.

Fehlerbehebungen (0.8.12)

  • Ein Problem wurde behoben, bei dem Apps mit SwapChainPanel oder WebView2 aufgrund einer Zugriffsverletzung unvorhersehbar abstürzten.

Version 0.8.11

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

Hinweis

Für die C#-Entwicklung ist eine der folgenden .NET SDK-Versionen erforderlich: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (oder höher). Zum Aktualisieren Ihrer .NET SDK-Version besuchen Sie die Download-Website für .NET, oder aktualisieren Sie Visual Studio auf die neueste Version. Wenn Sie Ihr NuGet-Paket ohne die erforderliche .NET SDK-Version aktualisieren, wird ein Fehler wie dieser angezeigt: Diese Version von WindowsAppSDK erfordert WinRT.Runtime.dll Version 1.6 oder höher.

Fehlerbehebungen (0.8.11)

  • Die Regression wurde behoben, die dazu führte, dass beim Auswählen von Text mit der Maus das Ereignis „Fokusverlust“ ausgelöst wurde.

Version 0.8.10

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

Hinweis

Für die C#-Entwicklung ist eine der folgenden .NET SDK-Versionen erforderlich: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (oder höher). Zum Aktualisieren Ihrer .NET SDK-Version besuchen Sie die Download-Website für .NET, oder aktualisieren Sie Visual Studio auf die neueste Version. Wenn Sie Ihr NuGet-Paket ohne die erforderliche .NET SDK-Version aktualisieren, wird ein Fehler wie dieser angezeigt: Diese Version von WindowsAppSDK erfordert WinRT.Runtime.dll Version 1.6 oder höher.

Fehlerbehebungen (0.8.10)

  • Es wurden Probleme behoben, die dazu führten, dass Apps während eines Drag-and-Drop-Vorgangs manchmal abstürzten.

Hinweis

Windows App SDK 0.8.9 wurde nicht veröffentlicht. Die direkt nach 0.8.8 veröffentlichte Version ist 0.8.10.

Version 0.8.8

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

Hinweis

Für die C#-Entwicklung ist eine der folgenden .NET SDK-Versionen (oder höher) erforderlich: 6.0.202, 6.0.104, 5.0.407, 5.0.213. Zum Aktualisieren Ihrer .NET SDK-Version besuchen Sie die Download-Website für .NET, oder aktualisieren Sie Visual Studio auf die neueste Version. Wenn Sie Ihr NuGet-Paket ohne die erforderliche .NET SDK-Version aktualisieren, wird ein Fehler wie dieser angezeigt: Diese Version von WindowsAppSDK erfordert WinRT.Runtime.dll Version 1.6 oder höher.

Fehlerbehebungen (0.8.8)

  • Probleme mit der Toucheingabe in TextBox bei Interaktionen mit der Bildschirmtastatur und allgemeinen Interaktionen wurden behoben. Diese Probleme betrafen auch Tastenkombinationen. Weitere Informationen finden Sie im Issue #6291 auf GitHub.
  • Ein Problem wurde behoben, bei dem ein App-Fenster manchmal als inaktiv angezeigt wurde, obwohl es aktiv war.
  • Es wurde ein Leistungsproblem behoben, das durch die Ausführung von UIA (Benutzeroberflächenautomatisierung) in externen Prozessen verursacht wurde.
  • Ein Problem mit der App-Stabilität bei Stifteingaben wurde behoben.
  • Ein Problem wurde behoben, bei dem das Rendern von PNG-Symbolen in einem Menü aufgrund von UIA dramatisch verzögert wurde.

Version 0.8.7

Dies ist ein Wartungsrelease des Windows App SDK, das verschiedene Leistungsupdates für C#-/.NET-Anwendungen enthält. Zum Aktualisieren auf diese Version müssen Sie auf die neueste Windows SDK-Paketversion verweisen. Fügen Sie dazu die Eigenschaft <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> der .csproj-Datei mit der SDK-Version hinzu, die Ihre App über die Eigenschaft TargetFramework ansteuern soll. Beispiel:

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

Diese Version der Windows SDK-Projektion wird in einem zukünftigen .NET 6-Wartungsrelease verfügbar sein. Sobald das .NET SDK-Update verfügbar ist, sollten Sie die <WindowsSdkPackageVersion>-Eigenschaft aus Ihrer Projektdatei entfernen.

Wenn Sie diese Eigenschaft nicht festlegen, wird ein Fehler wie dieser angezeigt: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Version 0.8.6

Dies ist ein Wartungsrelease des Windows App SDK, das verschiedene Leistungsverbesserungen für C#-/.NET-Anwendungen für das Release 0.8.0 enthält.

Zum Aktualisieren auf diese Version des Windows App SDK müssen Sie das neueste .NET SDK-Update vom Dezember installiert haben (siehe Download-Website für .NET und .NET 5 will reach End of Support on May 10, 2022). Wenn Sie die mindestens erforderliche Version des .NET SDK nicht installiert haben, wird ein Fehler wie folgt angezeigt: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Fehlerbehebungen (0.8.6)

Eine ausführliche Liste der Leistungsverbesserungen finden Sie in den Release Notes zu C#/WinRT 1.4.1.

Version 0.8.5

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

Fehlerbehebungen (0.8.5)

  • Ein Problem wurde behoben, das zum Absturz von WinUI-Apps mit Zeigereingaben führte.
  • Ein Problem wurde behoben, das dazu führte, dass die Titelleistenschaltflächen (Minimieren, Maximieren, Schließen) unter Windows 11 keine abgerundeten Ecken aufwiesen.
  • Ein Problem wurde behoben, das unter Windows 11 dazu führte, dass beim Zeigen mit der Maus auf die Schaltfläche „Maximieren/Wiederherstellen“ die Optionen für Layoutänderungen nicht angezeigt wurden.
  • Ein Problem wurde behoben, das beim Erstellen eines PointCollection-Objekts eine Absturzausnahme verursachte. Weitere Informationen finden Sie im Issue 971 auf GitHub.

Die Einschränkungen und bekannten Probleme für Version 0.8 gelten auch für Version 0.8.5, sofern im folgenden Abschnitt nichts anderes angegeben ist.

Version 0.8.4

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

Fehlerbehebungen (0.8.4)

  • Korrekturen für benutzerdefinierte Titelleisten, sodass ContentDialog sie nicht verdeckt und die Schaltflächen der Titelleiste abgerundet angezeigt werden.
  • Korrektur für einen Absturz bei der Bildverarbeitung, wenn die Anzeigeskalierung geändert wird.
  • Korrekturen für Fehler beim Freistellen, bei denen die Benutzeroberfläche nicht mehr angezeigt oder falsch freigestellt wurde.

Die Einschränkungen und bekannten Probleme für Version 0.8 gelten auch für Version 0.8.4, sofern im folgenden Abschnitt nichts anderes angegeben ist.

Version 0.8.3

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

Fehlerbehebungen (0.8.3)

Der Tastaturfokus ging verloren, wenn ein Fenster minimiert und dann wiederhergestellt wurde. Es war ein Mausklick erforderlich, um den Fokus wiederherzustellen.

Die Einschränkungen und bekannten Probleme für Version 0.8 gelten auch für Version 0.8.3, sofern im folgenden Abschnitt nichts anderes angegeben ist.

Version 0.8.2

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

Fehlerbehebungen (0.8.2)

  • Windows App SDK und WinUI 3 werden jetzt in Visual Studio 2022 Preview 2 und höher unterstützt.
  • Bei .NET-Apps erhalten Sie möglicherweise den folgenden Fehler, wenn Sie ein Array aus Enumerationen übergeben: Object contains non-primitive or non-blittable data.
  • Schreiben unter Verwendung des Schreibbereichs in einem Textfeld führt zu einem Absturz.
  • Symbole/Bilder werden immer mit ihrem Skalierungswert von 100 % geladen, statt basierend auf dem Monitorskalierungswert.
  • Die Garbage Collection von EventSource<T> führt zu einem nachfolgenden Fehler beim Abbestellen von Handlern (weitere Details finden Sie in diesem GitHub-Issue).
  • Sicherheitskorrektur: Details finden Sie unter CVE-2021-34533.
  • SwapChainPanel.CompositionScaleChanged gibt nach dem Ändern der Anzeigeskalierung manchmal falsche CompositionScale-Werte zurück.

Die Einschränkungen und bekannten Probleme für Version 0.8 gelten auch für Version 0.8.2, sofern im folgenden Abschnitt nichts anderes angegeben ist.

Version 0.8.1

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

Fehlerbehebungen (0.8.1)

  • Das Windows App SDK kann nicht mit dem neuesten Windows Insider-Build ausgeführt werden.
  • Das Eingeben eines Werts, der nicht in der Dropdownliste angezeigt wird, führt zu einem Absturz in EditableComboBox.
  • WebView2 erlaubt kein Verlassen mit der Tabulatortaste, sobald der Fokus empfangen wurde.
  • Der Windows.Foundation.Metadata.DefaultOverload-Namespace im von WinUI generierten Code muss vollständig qualifiziert werden, um Mehrdeutigkeit bei Namespaces zu vermeiden.
    • Diese Korrektur behebt Fehler #5108.
  • Sicherheitskorrektur: Details finden Sie unter CVE-2021-34489.

Die Einschränkungen und bekannten Probleme für Version 0.8 gelten auch für Version 0.8.1, sofern im folgenden Abschnitt nichts anderes angegeben ist.

Version 0.8.0 Stable

Neue Features und Updates

Dieses Release unterstützt alle Features des stabilen Kanals.

WinUI 3:

Dieses Release enthält viele Fehlerbehebungen und eine verbesserte Stabilisierung für WinUI 3. Dies sind alle neuen Änderungen in WinUI 3 seit der Veröffentlichung von WinUI 3 – Project Reunion 0.5:

  • Das Pivot-Steuerelement wurde wieder hinzugefügt und kann jetzt in jeder WinUI 3-App verwendet werden.

  • Alle Fehlerbehebungen aus Project Reunion v0.5.5, v0.5.6 und v0.5.7 sind in diesem Release enthalten.

  • Neue Fehlerbehebungen, einschließlich:

    • Beim Klicken mit der rechten Maustaste in „TextBox“ stürzt die Anwendung ab.
    • „NavigationView“ verursacht Absturz in UWP, Reunion 0.5 Preview.
    • ProgressBar zeigt den Unterschied zwischen „Angehalten“ und „Fehler“ nicht an
    • Kopieren/Einfügen/Ändern des Textstils führt zu einem Absturz in RichEditBox.
    • Schaltflächen für Fenstertitel werden falsch platziert, wenn SetTitleBar nicht festgelegt oder NULL ist.

    Eine vollständige Liste der in diesem Release behobenen Fehler finden Sie in unserem GitHub-Repository.

  • Die ColorHelper.ToDisplayName-API ist nicht mehr verfügbar.

  • Die folgenden Typen wurden entfernt:

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

    Verwenden Sie stattdessen Windows.Graphics.IGeometrySource2D und Windows.Graphics.IGeometrySource2DInterop.

  • Alle Typen im Microsoft.System-Namespace wurden in den Microsoft.UI.Dispatching-Namespace verschoben, einschließlich der DispatcherQueue-Klasse.

  • Die AcrylicBrush.BackgroundSource-Eigenschaft wurde entfernt, da HostBackdrop als BackgroundSource in WinUI 3 nicht unterstützt wird.

Weitere Informationen zu WinUI finden Sie unter WinUI.

Um die WinUI 3-Steuerelemente und -Features in Aktion zu sehen, können Sie die WinUI 3-Katalog-App von GitHub klonen und kompilieren oder aus dem Microsoft Store herunterladen.

In den folgenden Artikeln finden Sie Informationen zu den ersten Schritten bei der Entwicklung mit WinUI:

DWriteCore:

Dieses Release von DWriteCore enthält die folgenden neuen und aktualisierten Features. DWriteCore wird in der Übersicht über DWriteCore vorgestellt und beschrieben.

Hinweis

DWriteCoreCreateFactory ist funktionell identisch mit der DWriteCreateFactory-Funktion, die von der Systemversion von DirectWrite exportiert wird. Die DWriteCore-Funktion hat einen anderen Namen, um Mehrdeutigkeiten zu vermeiden, falls Sie sowohl DWriteCore.lib als auch DWrite.lib verknüpfen.

Referenzinformationen zu DWriteCore und der DirectWrite-API finden Sie unter DWriteCore-API-Referenz und DirectWrite-API-Referenz.

MRTCore:

  • Die Buildaktion für Ressourcen wird automatisch festgelegt, wenn Sie die Ressource zu Ihrem Projekt hinzufügen – dadurch ist weniger manuelle Projektkonfiguration erforderlich.

Einschränkungen

  • Dieses Release wird im Dev-Kanal des Windows-Insider-Programms derzeit nicht unterstützt. Dies wird in Version 0.8.1 behoben.

  • Desktop-Apps (C#- oder C++-Desktop): Dieses Release wird nur für die Verwendung in Desktop-Apps (C++ oder C#) unterstützt, die mit MSIX gepackt werden. Um das Windows App SDK in nicht gepackten Desktop-Apps zu verwenden, müssen Sie den experimentellen Releasekanal verwenden.

Wichtig

Wenn Sie an einer UWP-App arbeiten, lesen Sie Migrieren von UWP zum Windows App SDK.

Bekannte Probleme

  • WinUI 3-Tools wie Live Visual Tree, Live Property Explorer und Hot Reload in Version 0.8 und höher erfordern Visual Studio 2019 16.11 Preview 3 und höher.

  • Apps, die derzeit WinUI 3 und das Windows App SDK 0.8 verwenden, können keine Klassenbibliotheken nutzen, die Project Reunion 0.5 verwenden. Aktualisieren Sie die Klassenbibliotheken, um das Windows App SDK 0.8 zu verwenden.

  • .NET-Apps müssen auf Build 18362 oder höher ausgerichtet sein: Ihr TFM muss auf „net6.0-windows10.0.18362“ oder höher festgelegt sein, und die Version Ihres Paketprojekts muss auf 18362 oder höher festgelegt sein. Weitere Informationen finden Sie im GitHub-Issue #921.

  • Bei einem häufigen Wechsel zwischen hellem und dunklem Modus kann es zu einem Absturz kommt.

  • Bei .NET-Apps erhalten Sie möglicherweise den folgenden Fehler, wenn Sie ein Array aus Enumerationen übergeben: Object contains non-primitive or non-blittable data.Dies wird in Version 0.8.2 behoben.

  • Für .NET-Apps gibt es derzeit keine Möglichkeit, die Indizierung eines Bilds als App-Ressource über die Visual Studio-Benutzeroberfläche zu deaktivieren. Um dies zu umgehen, fügen Sie dem Projekt eine Directory.Build.targets-Datei hinzu (Anweisungen finden Sie unter Anpassen des Builds – Visual Studio), und entfernen Sie die Bilder wie folgt:

    • So entfernen Sie bestimmte Bilder (beachten Sie, dass der relative Pfad erforderlich ist):

      <Project>
<ItemGroup>
    <Content Remove="..\Bitmap1.bmp" />
</ItemGroup>
</Project>
      • So entfernen Sie Bilder basierend auf Metadaten:
      <Project>
<ItemGroup>
    <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
</ItemGroup>
</Project>

      Eine Behebung dieses Problems ist für ein zukünftiges Release geplant – sobald dies verfügbar ist, werden die oben genannten Problemumgehungen nicht mehr benötigt.