Versionshinweise zum Vorschaukanal für das Windows App SDK 1.1

Der Vorschaukanal enthält Versionen des Windows App SDK mit Features des Vorschaukanals in späten Entwicklungsphasen. Vorschauversionen enthalten keine experimentellen Features und APIs, können bis zum nächsten stabilen Release jedoch wichtigen Änderungen unterliegen.

Wichtige Links:

• Wenn Sie für eine vorhandene App ein Upgrade von einer älteren Version des Windows App SDK auf eine neuere Version ausführen möchten, finden Sie weitere Informationen unter Aktualisieren vorhandener Projekte auf die neueste Version von Windows App SDK.
• Eine Dokumentation zu Vorschaureleases finden Sie unter Installieren von Tools für Vorschau- und experimentelle Kanäle des Windows App SDK.

Neuestes Vorschaukanal-Release:

• Neueste Versionshinweise zum Vorschaukanal für das Windows App SDK

Release des neuesten stabilen Kanals:

• Versionshinweise zum neuesten stabilen Kanal für das Windows App SDK

Version 1.1 Vorschau 3 (1.1.0-preview3)

Das ist das neueste Release des Vorschaukanals für Version 1.1. Es unterstützt alle Features des Vorschaukanals (siehe Features, die über den Releasekanal verfügbar sind).

In einer vorhandenen App unter Verwendung von Windows App SDK 1.0 können Sie Ihr NuGet-Paket auf 1.1.0-preview3 aktualisieren (weitere Informationen finden Sie im Abschnitt Aktualisieren eines Pakets in Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager). Darüber hinaus finden Sie Aktualisierungen von Runtime und MSIX unter Neueste Windows App SDK-Downloads.

Neben allen Features der Vorschau 2 werden in den folgenden Abschnitten neue und aktualisierte Features, Einschränkungen und bekannte Probleme für dieses Release beschrieben.

WinUI 3 (1.1.0-preview3)

Mica und Background Acrylic sind jetzt für WinUI 3-Anwendungen verfügbar.

Weitere Informationen zu diesen Materialien finden Sie unter Materialien in Windows 11. Sehen Sie sich unseren Beispielcode zum Anwenden von Mica in C++-Anwendungen unter Mica- oder Acrylmaterialien in Desktop-Anwendungen für Windows 11 anwenden und in C#-Anwendungen auf GitHub in der WinUI-Steuerelementsammlung an.

Benachrichtigungen (1.1.0-preview3)

Behobene Probleme:

• In 1.1.0-preview1 und 1.1.0-preview2 wurden die App-Symbole einiger ungepackter Apps fälschlicherweise in AppData\LocalMicrosoftWindowsAppSDK kopiert. Bei diesem Release werden sie stattdessen in AppData\Local\Microsoft\WindowsAppSDK kopiert. Um den Verlust von Symbolen zu vermeiden, sollten Sie das App-Symbol nach dem Update auf 1.1.0-preview3 unter dem falschen Pfad manuell löschen.
• Der Abruf von App-Symbol und App-Anzeige für App-Benachrichtigungen über Verknüpfungen wird jetzt unterstützt. Dieses App-Symbol hat Vorrang vor einem in Ressourcendateien angegebene Symbol.
• Die Unterstützung von Pushbenachrichtigungen für ungepackte Apps wurde wiederhergestellt (siehe Einschränkungen für die beschriebene Ausnahme). Wir haben die API PushNotificationManager::IsSupported eingeführt, mit der sich überprüfen lässt, ob Ihre App Pushbenachrichtigungen unterstützt.

Einschränkungen:

• Benachrichtigungen für eine nicht gepackte App mit erhöhten Rechten werden nicht unterstützt. PushNotificationManager::IsSupported führt keine Überprüfung auf den Modus mit erhöhten Rechten durch. Wir arbeiten jedoch an der Unterstützung dieser Funktion in einem künftigen Release.

MSIX-Paketerstellung

MSIX wurde durch Aufnahme neuer und Erweiterung vorhandener Funktionen über folgende Erweiterungskategorien erweitert:

• windows.appExecutionAlias
• windows.customDesktopEventLog
• windows.dataShortcuts
• windows.fileTypeAssociation
• windows.fileTypeAssociation.iconHandler
• windows.folder
• windows.shortcut

Hierfür muss das Windows App SDK-Frameworkpaket installiert sein. Informationen zum Installieren der Runtime finden Sie unter Neueste Windows App SDK-Downloads.

Umgebungsmanager (1.1.0-preview3)

API-Satz, mit dem Entwickler Umgebungsvariablen hinzufügen, entfernen und ändern können, ohne die Registrierungs-API direkt verwenden zu müssen.

Klarstellung zu 1.1 Vorschau 1: Das automatisches Entfernen von Änderungen an Umgebungsvariablen beim Deinstallieren einer App, die den Umgebungsmanager verwendet hat, ist nur für gepackte Apps verfügbar. Darüber hinaus erfordert das Rückgängigmachen der Umgebungsvariablen die Installation des Windows App SDK-Frameworkpakets. Weitere Informationen finden Sie unter Neueste Windows App SDK-Downloads für die Runtime.

Andere bekannte Einschränkungen

Regressionen von 1.1 Vorschau 2:

• Für .NET-Apps mit MRT Core-APIs und WinUI-Apps, die nicht mit Einzelprojekt-MSIX bereitgestellt werden:
  • RESW- und Bilddateien, die dem Projekt als vorhandene Elemente hinzugefügt wurden und bisher automatisch in die ItemGroups PRIResource bzw. Content aufgenommen wurden, werden nicht in diese ItemGroups aufgenommen. Aufgrund dessen werden diese Ressourcen während der PRI-Generierung nicht indiziert und sind deshalb während der Runtime nicht verfügbar.
    • Problemumgehung: Nehmen Sie die Ressourcen manuell in die Projektdatei auf und entfernen Sie sie aus der ItemGroup None.
    • Alternative Problemumgehung: Nehmen Sie, falls verfügbar, ein Upgrade des .NET SDK Ihrer Apps auf 6.0.300 vor. Weitere Informationen finden Sie unter Versionsanforderungen für .NET SDK .
• Für .NET-Apps, die nicht mit Einzelprojekt-MSIX bereitgestellt werden:
  • Wenn eine Datei zweimal oder öfter zur ItemGroup Content hinzugefügt wird, tritt ein Buildfehler auf.
    • Problemumgehung: Löschen Sie die doppelte(n) Aufnahme(n) oder setzen Sie EnableDefaultContentItems in der Projektdatei auf „false“.

Beide Regressionen werden im nächsten stabilen Release wiederhergestellt.

Version 1.1 Vorschau 2 (1.1.0-preview2)

Das ist das zweite Release des Vorschaukanals für Version 1.1. Es unterstützt alle Features des Vorschaukanals (siehe Features, die über den Releasekanal verfügbar sind).

In einer vorhandenen App unter Verwendung von Windows App SDK 1.0 können Sie Ihr NuGet-Paket auf 1.1.0-preview2 aktualisieren (weitere Informationen finden Sie im Abschnitt Aktualisieren eines Pakets in Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager). Darüber hinaus finden Sie Aktualisierungen von Runtime und MSIX unter Neueste Windows App SDK-Downloads.

Neben allen Features der Vorschau 1 werden in den folgenden Abschnitten neue und aktualisierte Features, Einschränkungen und bekannte Probleme für dieses Release beschrieben.

Benachrichtigungen (1.1.0-preview2)

Behobene Probleme:

• Bei einer App ohne Paketidentität zum Senden von Benachrichtigungen wird nun das App-Symbol in der Benachrichtigung angezeigt, wenn das Symbol Teil der App-Ressource ist. Wenn es in der App-Ressource kein Symbol gibt, wird das Windows-Standard-App-Symbol verwendet.
• Eine nicht ausgeführte WinUI 3-App kann jetzt über eine Benachrichtigung im Hintergrund aktiviert werden.

Regression von 1.1 Vorschau 1: Unterstützung von Pushbenachrichtigungen für ungepackte Apps. Für das nächste Release wird die Wiederherstellung erwartet.

Bekannte Einschränkungen:

• Wir haben die API PushNotificationManager::IsSupported eingeführt, mit der sich überprüfen lässt, ob eigenständige Apps Pushbenachrichtigungen unterstützen. Diese API funktioniert jedoch noch nicht wie vorgesehen. Achten Sie daher im nächsten Vorschaurelease auf die vollständige Unterstützung der IsSupported-API.
• Die App-Symbole einiger ungepackter Apps wurden fälschlicherweise in AppData\LocalMicrosoftWindowsAppSDK kopiert. Beim nächsten Release werden sie stattdessen in AppData\Local\Microsoft\WindowsAppSDK kopiert. Um den Verlust von Symbolen zu vermeiden, sollte der Entwickler sein App-Symbol nach dem Upgrade auf das nächste Release unter dem falschen Pfad manuell löschen.
• Der Abruf von App-Symbol und App-Anzeige für Benachrichtigungen über Verknüpfungen wird nicht unterstützt. Wir arbeiten aber an der Unterstützung in einem künftigen Release.

Bereitstellung

Neue Features:

• Gepackte Apps können jetzt die Bereitstellung der Windows App SDK-Laufzeitpakete über die API DeploymentManager.Initialize erzwingen.
• Die Bootstrapper-API enthält jetzt neue Optionen für verbesserte Benutzerfreundlichkeit und Problembehandlung. Weitere Informationen finden Sie unter Verwenden der Windows App SDK-Laufzeit für Apps, die mit externem Speicherort verpackt sind, oder unpackte und umfassende Informationen zum Bootstrap-Initialisierungsfehler.

Bekannte Einschränkungen:

• Die eigenständige Bereitstellung wird nur unter Windows 10, 1903 und höher unterstützt.

Windowing

Für einen einfacheren Programmierzugriff auf Funktionen, die in USER32.dll implementiert sind (siehe Fenster und Meldungen), zeigt dieses Release mehr von dieser Funktionalität in AppWindow selbst.

Neue Features:

• Apps mit vorhandenen Fenstern haben durch Aufrufen von AppWindow.ShowOnceWithRequestedStartupState – dem Äquivalent zu ShowWindow(SW_SHOWDEFAULT) – mehr Kontrolle darüber, wie ein Fenster angezeigt wird.
• Apps können ein Fenster anzeigen, minimieren oder wiederherstellen. Sie können auch angeben, ob das Fenster zum Zeitpunkt des Aufrufs aktiviert werden soll oder nicht.
• Apps können jetzt die Clientbereichsgröße eines Fensters in Win32-Koordinaten festlegen.
• Wir haben APIs zur Unterstützung der Z-Reihenfolgen-Verwaltung von Fenstern hinzugefügt.
• Apps, die mit AppWindowTitleBar.ExtendsContentIntoTitleBar benutzerdefinierte Titelleisten zeichnen, können eine Option PreferredTitleBarHeight festlegen. Sie haben jetzt die Wahl zwischen einer Titelleiste mit Standardhöhe oder einer hohen Titelleiste, die mehr Platz für interaktive Inhalte bietet. Informationen zur Verwendung einer hohen Titelleiste finden Sie unter Titelleiste in den Fluent Design-Richtlinien.

Bekannte Einschränkungen:

• Die Unterstützung der hohen Titelleiste ist nur unter Windows 11 verfügbar. Wir arbeiten an der Vereinheitlichung mit anderen benutzerdefinierten Titelleisten-APIs aus älteren Versionen.

WinUI 3 (1.1.0-preview2)

Behobene Probleme:

• Durch Upgrade des WebView2 SDK von 1020.46 auf 1185.39 wurde ein Problem behoben, das dazu führte, dass C#-Apps mit WebView2 beim Start abstürzten, wenn die C/C++ Runtime (CRT) nicht installiert war.
• Ein Problem wurde behoben, das dazu führte, dass in einigen abgerundeten Ecken ein Farbverlauf angezeigt wurde, obwohl es sich um eine Volltonfarbe handeln sollte. Weitere Informationen finden Sie in Issue 6076 & Issue 6194 auf GitHub.
• Ein Problem wurde behoben, bei dem aktualisierte Stile in generic.xaml fehlten.
• Es wurde ein Layoutzyklusproblem behoben, das dazu führte, dass eine App abstürzte, wenn bis zum Ende einer ListView gescrollt wurde. Weitere Informationen finden Sie im Issue #6218 auf GitHub.

Leistung

Für C#-Anwendungen gibt es mehrere Leistungsverbesserungen. Weitere Informationen finden Sie in den Versionshinweisen zu C#/WinRT 1.6.1.

Version 1.1 Vorschau 1 (1.1.0-preview1)

Das ist das erste Release des Vorschaukanals für Version 1.1. Es unterstützt alle Features des Vorschaukanals (siehe Features, die über den Releasekanal verfügbar sind).

In einer vorhandenen App unter Verwendung von Windows App SDK 1.0 können Sie Ihr NuGet-Paket auf 1.1.0-preview1 aktualisieren (weitere Informationen finden Sie im Abschnitt Aktualisieren eines Pakets in Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager). Darüber hinaus finden Sie Aktualisierungen von Runtime und MSIX unter Neueste Windows App SDK-Downloads.

In den folgenden Abschnitten werden neue und aktualisierte Features, Einschränkungen und bekannte Probleme für diese Version beschrieben.

WinUI 3 (1.1.0-preview1)

Bekanntes Problem: Benutzer können ein Element nicht ablegen, wenn Drag & Drop aktiviert ist.

Unterstützung erhöhter Rechte (Administrator)

Mit Windows App SDK 1.1 Vorschau 1 können Apps (einschließlich WinUI 3) mit erhöhten Rechten ausgeführt werden.

Wichtige Einschränkungen:

• Derzeit nur unter Windows 11 verfügbar. Wir prüfen jedoch, ob diese Unterstützung in einem späteren Release vereinheitlicht werden kann.

Bekannte Probleme:

• WinUI 3-Apps stürzen ab, wenn während einer Drag & Drop-Interaktion ein Element gezogen wird.

Eigenständige Bereitstellung

Windows App SDK 1.1 führt die Unterstützung der eigenständigen Bereitstellung ein. Unsere Übersicht über die Windows App SDK-Bereitstellung enthält Informationen zu den Unterschieden zwischen frameworkabhängiger und eigenständiger Bereitstellung sowie zu den ersten Schritten.

Bekannte Probleme:

• Eine gepackte C++-App muss unten in der Projektdatei den Folgendes hinzufügen, um einen Bug in der eigenständigen .targets-Datei zu umgehen, der Frameworkverweise auf VCLibs entfernt:

  <PropertyGroup>
      <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
  </PropertyGroup>
  
  <Target Name="_RemoveFrameworkReferences"
      BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
      <ItemGroup>
          <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
      </ItemGroup>
  </Target>
  

• Nur unter Windows 10, 1903 und höher unterstützt.

Benachrichtigungen (1.1.0-preview1)

Entwickler*innen von gepackten Apps (einschließlich gepackten Apps mit externem Speicherort) und nicht gepackten Apps können jetzt Windows-Benachrichtigungen senden.

Neue Features:

• Unterstützung für App-Benachrichtigungen für gepackte und nicht gepackte Apps. Vollständige Details auf GitHub
  • Entwickler*innen können App-Benachrichtigungen – auch als Popupbenachrichtigungen bezeichnet – lokal oder über ihren eigenen Clouddienst senden.
• Unterstützung der Pushbenachrichtigung für gepackte und ungepackte Apps. Vollständige Details auf GitHub
  • Entwickler*innen können unformatierte Benachrichtigungen oder App-Benachrichtigungen über ihren eigenen Clouddienst senden.

Einschränkungen:

• Als eigenständig veröffentlichte Apps haben möglicherweise keine Unterstützung von Pushbenachrichtigungen. Achten Sie im nächsten Vorschaurelease auf eine IsSupported-API, um die Unterstützung von Pushbenachrichtigungen zu überprüfen.
• Bei ungepackten Apps, die App-Benachrichtigungen senden, ist das App-Symbol in der App-Benachrichtigung nicht zu sehen, es sei denn, es handelt sich um Konsolenanwendungen. Ungepackte Konsolen-Apps sollten den Mustern aus dem Beispiel ToastNotificationsDemoApp folgen.
• Zur Unterstützung von Pushbenachrichtigungen muss Windows App SDK-Runtime installiert werden, siehe Neueste Windows App SDK-Downloads für das Installationsprogramm.
• Eine nicht ausgeführte WinUI 3-App kann nicht über eine Benachrichtigung im Hintergrund aktiviert werden. Wir arbeiten aber an der Unterstützung in einem künftigen Release.

Umgebungsmanager (1.1.0-preview1)

API-Satz, mit dem Entwickler Umgebungsvariablen hinzufügen, entfernen und ändern können, ohne die Registrierungs-API direkt verwenden zu müssen.

Neue Features:

• Ermöglicht das automatische Entfernen von Änderungen an Umgebungsvariablen beim Deinstallieren einer App, die den Umgebungs-Manager verwendet hat.

Einschränkungen:

• Derzeit nicht in C#-Apps verfügbar. Wir prüfen jedoch die Aufnahme dieses Features in C#-Apps in einem späteren Release.

Weitere Einschränkungen und bekannte Probleme

• Wenn Sie C# mit 1.1.0 Vorschau 1 verwenden, müssen Sie mindestens eine der folgenden .NET SDK-Versionen verwenden: .NET SDK 6.0.201, 6.0.103, 5.0.212 oder 5.0.406. Für ein Upgrade Ihrer .NET SDK-Version können Sie ein Update auf die neueste Version von Visual Studio vornehmen oder zu Download .NET gehen.

Zugehörige Themen

• Versionshinweise zum neuesten stabilen Kanal für das Windows App SDK
• Neueste Versionshinweise zum experimentelle Kanal für das Windows App SDK
• Installieren von Tools für das Windows App SDK
• Erstellen Ihres ersten WinUI 3-Projekts (Windows App SDK)
• Verwenden des Windows-App SDK in einem vorhandenen Projekt
• Übersicht über die Bereitstellung