Teilen über

Versionshinweise zum Vorschaukanal für das Windows App SDK 1.1

  • Artikel

Wichtig

Der Vorschaukanal wird für die Verwendung in Produktionsumgebungen nicht unterstützt, und Apps, die die Vorschaureleases verwenden, können nicht im Microsoft Store veröffentlicht werden.

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:

Neuestes Vorschaukanal-Release:

Release des neuesten stabilen Kanals:

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.

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.

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.

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.

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:

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.