Windows App SDK 2.0 Versionshinweise

Unterstützung für die windows.diagnosticServiceModule Paketmanifesterweiterung hinzugefügt. Eigenständige .NET-MSIX-Apps können diese Erweiterung verwenden, um Diagnosemodule anzugeben, damit Windows Error Reporting diese laden und aussagekräftige Absturzabbilder erfassen kann.

Neue AppContentIndex APIs sind jetzt als Feature für eingeschränkten Zugriff (Limited Access Feature, LAF) für Apps verfügbar, die ein LAF-Token erhalten haben. Mit diesen APIs können Apps Text- und Bildinhalte für die Indizierung und Abfrage von Inhalten mit lexikalischem Abgleich und auf unterstützten NPU-fähigen Geräten den semantischen Abgleich bereitstellen. AppContentIndex unterstützt semantische Suche und Szenarien der abrufgestützten Generierung (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Es wurde ein Absturz in der Eingabebehandlung für Fenster-Popups behoben, wenn ein Fokus- oder Zeigerereignis verarbeitet wurde, nachdem die Insel des Popups verworfen wurde. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Ein Absturz in NavigationView wurde behoben, der auftreten konnte, wenn durch das Ändern der Größe des Steuerelements ein negativer Fensterbereich MaxHeight entstand. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Es wurde ein Problem behoben, bei dem der zurückgegebene Eigenschaftensatz beim ElementCompositionPreview.GetPointerPositionPropertySet Drücken eines Zeigers nicht mehr aktualisiert wurde. (RuntimeCompatibilityChange: PointerPositionPropertySet_UpdateWhilePressed)
• Ein Absturz in NavigationView wurde behoben, der auftrat, wenn das Flyout eines aufgeklappten Elements angezeigt wurde, nachdem das Element eingeklappt oder recycelt worden war. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Ein Fail-Fast wurde behoben, der auftrat, wenn ein KeyboardAccelerator eine OEM- oder Interpunktionstaste wie ein Komma, Semikolon oder eine Klammer verwendete und die Beschriftung des Tastenkürzels angezeigt wurde. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Es wurde ein schwerwiegender Prozessabbruch behoben, der während des XAML-Herunterfahrens in Apps mit WinUI 3 auf mehr als einem UI-Thread auftreten konnte. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Es wurde ein Problem behoben, bei dem bei einem CommandBar ohne sekundäre Befehle bei fraktionierten Anzeigeskalierungen wie 175 % eine leere Überlaufsschaltfläche angezeigt werden konnte. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Es wurde ein Problem behoben, das Apps, die die System Composition Engine verwenden, daran hinderte, VisualInteractionSource.CreateFromIVisualElement aufzurufen. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Feste Effektdiagramme und SceneLighting-Rendering für Apps, die das System Composition Engine verwenden. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Fehler behoben, bei dem InputPointerSource.ActivationBehavior nicht NoActivate bei Verwendung der System Composition Engine berücksichtigt hat. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Das Auswahlverhalten für NULL-Eingaben und no-op Auswahl wurde behoben CompositionEngine . (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Die Cursor-Anpassung für angehobene Eingabefelder bei Verwendung der System Composition Engine wurde korrigiert. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Abfragen von ICompositionObject Gradientenstopp-Sammlungen bei Verwendung der System Composition Engine wurden behoben. (RuntimeCompatibilityChange: N/A, Betriebssystemkompositionskorrektur)
• Festes ContentExternalOutputLink Rahmen- und Hintergrundverhalten bei Verwendung des Systemkompositionsmoduls. (RuntimeCompatibilityChange: N/A, Betriebssystemkompositionskorrektur)
• Der Zugriff auf VisualReferenceController bei der Verwendung der System Composition Engine wurde behoben. (RuntimeCompatibilityChange: N/A, Betriebssystemkompositionskorrektur)
• Es wurde ein Registrierungsproblem behoben, das beim Installieren des Windows App SDK auftreten konnte. (RuntimeCompatibilityChange: N/A, Korrektur der Bereitstellungsregistrierung)
• Ein Problem wurde behoben, bei dem die Video-Superauflösung während der Initialisierung oder Ableitung mit der aktualisierten ONNX-Runtime-Abhängigkeit fehlschlug. (RuntimeCompatibilityChange: N/A, Abhängigkeitskompatibilitätsupdate)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.4.0:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

WinUI 3-Apps unterstützen jetzt Betriebssystem-Haptik für Touchpad und Maus über Windows.Devices.Haptics sowie das Ein-Finger-Schwenken auf dem Touchpad, sofern dies vom Betriebssystem und von der Hardware unterstützt wird. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• Es wurde ein Absturz behoben, der auftreten konnte, wenn ein Berührungs- oder Stiftkontakt unter bestimmten zeitlichen Bedingungen einen scrollbaren Bereich verließ. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Es wurde ein Problem behoben, bei dem die Speicherauswahlfenster (FileSavePicker, FileOpenPicker und FolderPicker) dazu führten, dass das aufrufende WinUI-App-Fenster nach dem Schließen des Dateidialogs keinen Tastaturfokus mehr hatte. Die App stellt nun den vorherigen Fokus wieder her, nachdem das Dialogfeld geschlossen wurde. Weitere Informationen finden Sie unter GitHub Problem Nr. 6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Eine Regression wurde behoben, bei der MrmGetFilePathFromNameERROR_FILE_NOT_FOUND zurückgab, wenn die PRI-Datei nicht vorhanden war, anstatt den dokumentierten Fallbackpfad zurückzugeben. Weitere Informationen finden Sie unter GitHub Problem Nr. 5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Es wurde ein Problem behoben, bei dem MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY von untergeordneten Prozessen geerbt werden konnte, was MRT Core und Katalogsuchvorgänge beeinträchtigte. Weitere Informationen finden Sie unter GitHub Problem Nr. 5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Es wurde ein Problem behoben, bei dem LanguageModel ein generischer Error Status für nicht unterstützte Sprachen oder nicht übereinstimmende Eingabe- und Ausgabesprachen zurückgegeben wurde. Diese Bedingungen geben nun jeweils LanguageModelResponseStatus.UnsupportedLanguage bzw. LanguageModelResponseStatus.LanguageMismatch zurück. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Ein Absturz wurde behoben, der auftrat, wenn Apps, die die System Composition Engine verwenden, VisualInteractionSource.TryRedirectForManipulation aufgerufen haben. (RuntimeCompatibilityChange: N/A, Behebung eines Problems mit der Kompositionsbrücke des Betriebssystems)
• Es wurde ein Problem mit dem Zugriffsmodifizierer für die generierte C#-Einstiegspunkthilfe behoben, wenn DISABLE_XAML_GENERATED_MAIN definiert ist. Weitere Informationen finden Sie unter GitHub Problem Nr. 11245. (RuntimeCompatibilityChange: N/A, Änderung der Buildzeit-Tools)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.3.1:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Die Strukturierte JSON-Ausgabe-API (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync) wurde hinzugefügt, die Sprachmodellantworten generiert, die auf ein vom Aufrufer bereitgestelltes JSON-Schema beschränkt sind. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

Die XamlOptionalChanges-API wurde hinzugefügt, mit der Apps optionale Unterbrechungsänderungen vor der XAML-Initialisierung vornehmen können. Weitere Informationen finden Sie unter GitHub PR microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Das Verhalten der Präprozessorkonstante DISABLE_XAML_GENERATED_MAIN wurde geändert, sodass sie, wenn sie definiert ist, die generierte Methode main() (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) jetzt umbenennt, statt sie vollständig zu entfernen. Auf diese Weise kann eine benutzerdefinierte main() Methode die Standardimplementierung aufrufen.

Die CompositionEngine-API wurde als instabiles Feature für eingeschränkten Zugriff (Limited Access Feature, LAF) hinzugefügt, das es Apps ermöglicht, das Betriebssystem als Modul für die Kompositions-APIs zu verwenden. (RuntimeCompatibilityChange: CompositionEngine_API)

Die NPU-Erkennung wurde behoben, die CPU-Unterstützung hinzugefügt und die Leistung für die Video-Superauflösung verbessert. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Die Ausführungsanbieter-Auflistung wurde in bestimmten Szenarien behoben. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• Windows ML wurde um ARM64EC-Unterstützung erweitert.

IntelliSense-Dokumentation für stabile APIs im Microsoft.WindowsAppSDK.AI NuGet-Paket hinzugefügt.

Einige der unten aufgeführten Optimierungen sind opt-in. Um sie zu aktivieren, legen Sie die angegebene XamlChangeId wie in jedem Element angegeben fest.

• Neue optimierte XamlControlsResources Formatvorlagen hinzugefügt, einschließlich einer optimierten ScrollBar Vorlage. Verwenden Sie die DefaultStyleOptimizations XamlChangeId, um sich für diese Stile zu entscheiden. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon und BitmapIcon vermeiden das Einfügen eines zusätzlichen Grid in ihre visuelle Struktur für Apps, die sich mit der IconNoGridOptimization XamlChangeId dafür anmelden. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Das Laden von Style Settern für Eigenschaften, die keinen Wert festlegen, wurde eingestellt. Verwenden Sie die OptimizeApplyStyles XamlChangeId, um sich zu anmelden. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• Anwenden der FrameworkElement- und Control-Stile verzögert, bis sich das Element in der Struktur befindet. Verwenden Sie die OptimizeApplyStyles XamlChangeId, um sich zu anmelden. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Optimierte CommandBar Initialisierung, indem der gesamte Zustand des Visual State Manager nicht mehr geladen wird. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Verbesserte Leistung beim Hinzufügen zu CommandBarFlyouts PrimaryCommands und SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Verwendet eine leistungsfähigere Hashtabelle für ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Beim Laden von verzögerten Ressourcen wurden das Kopieren und Vergleichen einer ressourcenspezifischen Zeichenfolge optimiert. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Verbesserte Leistung von ThemeResource Suchvorgängen durch Reduzierung von Zeichenfolgenvergleichen. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Verbesserung der CPU-Leistung bei der Suche nach XAML-Designressourcen durch Verringerung des Aufwands für das Hashing von Ressourcenschlüsseln. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Verbesserte CPU-Leistung für gängige interne XAML-Typprüfungen bei UIElement und FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Verbesserte CPU-Leistung in internen Aktivierungs-Factory-Lookup-Pfaden. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Verbesserte Leistung der Decodierung ganzzahliger Zahlen, die in XBF-Dateien gespeichert sind. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Reduzierte Heap-Zuordnungen für Startuppfade und Strukturverzweigungen durch Reservieren des Vektorspeichers und Optimieren eines RAII-Helfers. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Verbesserte Leistung durch Reservieren von Speicherplatz in Trackersammlungen vor dem Anfügen mehrerer Elemente. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Optimierte Bindungen für XamlUICommand Eigenschaftsbindungen. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Verbesserte Leistung beim Zuordnen von XamlUICommands, die keine Tastenkombinationen definieren. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• Initialisiert die TintLuminosityOpacity Eigenschaft im Markup für Objekte im Standardstil AcrylicBrush und nicht im Code, um die erzwungene Realisierung zu vermeiden. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Unnötige Standardinitialisierung auf ContextFlyout, TextBlock und RichTextBlock beim Betreten oder Verlassen der Elementstruktur vermieden. Verwenden Sie die DeferContextFlyoutInit XamlChangeId, um sich zu anmelden. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Die Wartezeiten beim Startup aufgrund von Direct3D-Sperrkonflikten wurden reduziert, indem das D3D-„Device Removed“-Ereignis von XAML bereits während der Hintergrundgeräteerstellung registriert wird, anstatt erst später im UI-Thread. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Es wurde eine redundante Registrierung der Strombenachrichtigung von RefreshRateInfo entfernt, wodurch der Start-Overhead reduziert wurde. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Eine redundante version.dll-Abhängigkeit aus dem WinUI-Startpfad entfernt, indem die protokollierte Laufzeitversion beim Kompilieren berechnet wird. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Ein Use-After-Free-Absturz in CPopupRoot::ReplayPointerUpdate wurde behoben, wenn ein Pop-up während der Wiederholung von Zeigerereignissen synchron geschlossen wird. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Ein Zugriffsverstoß in CXamlIslandRoot::GetScreenOffset wurde behoben, der durch wiedereintrittsfähige UI-Automation-Abfragen beim Abbau der XAML-Insel ausgelöst wurde. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Ein Absturz in ModernCollectionBasePanel wurde behoben, bei dem ein vom Viewport verfolgter Container oder Header, der durch den Layoutdurchlauf eines gleichgeordneten Elements wiederverwendet wurde, einen veralteten Anker hinterlassen konnte, der beim nächsten Messdurchlauf ein Fail-Fast auslöste. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Ein Fail-Fast-Fehler in CPopup::RemoveChild wurde behoben, der auftrat, wenn ein ToolTip-Schließvorgang Nachrichten verarbeitete und den Schließpfad erneut aufrief. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• Ein Eintrittsinvarianz-bedingter Absturz in CXcpDispatcher wurde behoben, wenn ein Popup-Destruktor bei aktiven UI-Automatisierungsclients UIADisconnectAllProviders auslöste. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Ein Absturz wurde behoben, der auftrat, wenn ein Timer für die verzögerte Öffnung eines kaskadierenden Menüs oder AutoSuggestBox ausgelöst wurde, nachdem die zugehörige Insel oder der Dispatcher bereits mit dem Abbau begonnen hatte. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Ein potenzieller Use-After-Free-Absturz beim Entladen der DLL wurde behoben, wenn COM-Zeiger in benutzerdefinierten Metadatentypen nicht ordnungsgemäß freigegeben wurden. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Ein Absturz beim Öffnen von Popup aus einem CompositionTarget.Rendering-Rückruf aufgrund von Dispatcher-Eintrittsinvarianz während Fokusänderungen wurde behoben. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Ein Absturz in MediaPlayerPresenter wurde behoben, wenn das GPU-Gerät während der Verarbeitung von Medienwiedergabeereignissen ausfällt. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Eine potenzielle Zugriffsverletzung beim Rendern von Direct2D-Text wurde behoben, wenn die Wiederherstellung nach Geräteverlust während des Erstellens der Textur für den Glyphenlauf erfolgte. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Ein Absturz in CFocusRectManager::FindFocusRectHost wurde behoben, wenn der Fokus auf ein Steuerelement gelangt, das inline über InlineUIContainer in RichTextBlock oder TextBlock gehostet wird. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Es wurde ein Absturz behoben, der backgroundTaskHost.exe wiederholt zum Absturz bringen konnte, wenn eine Hintergrundaufgabe keine gespeicherte CLSID hatte, und es wurde eine robuste Fehlerbehandlung hinzugefügt, wenn CoCreateInstance fehlschlägt. Weitere Informationen finden Sie unter GitHub Problem Nr. 5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Es wurde ein Problem behoben, bei dem sich feststehende Flyouts mit und ohne Fenster bei seitlicher Anordnung falsch ausgerichtet anzeigten (etwa eine Elementhöhe über dem übergeordneten Element), wenn sie sich nahe am unteren Bildschirmrand nach oben öffneten. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• Ein Absturz (null LayoutState Dereferenzierung) in UniformGridLayout und FlowLayout wurde behoben, der auftreten konnte, wenn eine Sammlungsänderung für ein ItemsRepeater, das nicht mehr geladen war, ausgelöst wurde. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Behoben wurde, dass ApplicationData.GetForUnpackaged().LocalSettings() einen Registrierungsschlüssels unter dem falschen Pfad (HKCU\SOFTWARE\publisher\product statt HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product) öffnet, der ein Roaming-Speicherort und nicht ein lokaler Speicherort des Computers ist. Weitere Informationen finden Sie unter GitHub Problem Nr. 6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Eine Racebedingung bei der Verarbeitung des Zustands von Modifikatortasten wurde behoben, durch die Apps bei gleichzeitigen Eingaben im UI-Thread abstürzen konnten. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• Ein AppxSvc-Absturz wurde behoben, der während der Paketinstallation, Aktualisierung oder Deinstallation auftreten kann. (RuntimeCompatibilityChange: N/A, Behebung eines Service-Host-Absturzes)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.2.0:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Die Microsoft.Windows.AI.Video.VideoScaler API bietet eine Verbesserung von Echtzeitvideos durch erweitertes KI-Upscaling, das für Streams optimiert ist, die Personen in Unterhaltungen zeigen. Es ermöglicht Entwicklern, schärfere, klarere visuelle Elemente über Konferenz-, Streaming- und Bearbeitungsplattformen hinweg bereitzustellen, auch unter schlechten Netzwerkbedingungen. Die API unterstützt die Anpassung von Ausgabeauflösung, Bildfrequenz und interessanten Regionen mit Kompatibilität für mehrere Videoformate, einschließlich BGR, RGB und NV12.

VideoScaler ist verfügbar und enthält eine Funktionsüberprüfung, sodass Apps die VSR-Unterstützung zur Laufzeit überprüfen können. Explizite Windows ML-Initialisierung ist nicht erforderlich.

Eine neue Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged()-API bietet nicht paketierten Apps einen vollwertigen WinRT-Zugriffspunkt auf Anwendungsdaten pro Benutzer bzw. pro Computer und entspricht damit dem Funktionsumfang, der zuvor nur paketierten Apps zur Verfügung stand. Dies vereinfacht zukünftige Migrationen zwischen verpackten und unverpackten Versionen und macht Registry-API-Problemumgehungen überflüssig.

Boxenfreie Wertsatzüberladungen wurden zu XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) hinzugefügt und die Setter.ValueProperty Abhängigkeitseigenschaft wurde verfügbar gemacht.

• Ein Absturz in RenderTargetBitmap wurde behoben, wenn das Zielelement die visuelle Struktur verlässt (z. B. wenn ein Pop-up geschlossen wird), bevor PreCommit abgeschlossen ist. RenderAsync gibt jetzt E_ABORT zurück, anstatt abzustürzen. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Ein Use-After-Free-Absturz in ScrollView wurde behoben, der auftrat, wenn das Steuerelement zerstört wurde, während noch ein Tick des Hide-Indicators-Timers ausstand. Weitere Informationen finden Sie unter GitHub Problem #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Es wurde ein potenzieller Absturz in Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate behoben, der durch den Versuch verursacht wurde, auf ein objekt zuzugreifen, das freigegeben werden soll. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Es wurde ein Problem behoben, bei dem Microsoft.UI.System.ThemeSettings eine App abstürzen konnte, wenn sie in einem Hintergrundthread zerstört wurde (z. B. beim Löschen durch den .NET Garbage Collector). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Es wurde ein Absturz behoben, der auf bestimmten Geräten auftreten konnte, wenn aktive Touchkontakte von der Eingabehardware abgebrochen wurden, z. B. wenn die Stifteingabe diese außer Kraft setzt. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
• Es wurde ein Problem behoben, bei dem spärlich verpackte Apps keine modulspezifischen PRI-Dateien ermitteln konnten. Weitere Informationen finden Sie unter GitHub Problem #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Ein Fehler bei der Eigentümerschaft von Zeichenfolgen bei der Verwendung der Flat-C Windows ML-Katalog-API wurde behoben. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Ein potenzielles Problem in Windows ML beim Herunterfahren des Prozesses wurde behoben. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Potenzielle Probleme bei der COM-Initialisierung und -Aufhebung in Windows ML wurden behoben. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.1.3:

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Video

    VideoScaler
    VideoScalerOptions
    VideoScalerResult
    VideoScalerStatus

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Verbessert, wie TitleBar entscheidet, welche Teile von TitleBar.Content verschoben werden können, und fügt APIs hinzu, die Entwicklern explizite Kontrolle über Ziehbereiche geben. Siehe PR microsoft/microsoft-ui-xaml#10936 und Tracking Issue #10421.

Was sich geändert hat

• Neues Standardverhalten — Das Framework durchläuft jetzt rekursiv den visuellen Baum und schließt automatisch nur interaktive Steuerelemente vom Ziehbereich aus. Leere Lücken und nicht interaktive visuelle Elemente können standardmäßig gezogen werden, ohne dass Markupänderungen erforderlich sind.
• Neue APIs für explizites Steuerelement:
  • TitleBar.IsDragRegion – Angefügtes nullables Bool, um ein Element als ziehbar (True), klickbar (False) oder im Rahmen festgelegt (deaktiviert) zu markieren.
  • TitleBar.AutoRefreshDragRegions – wenn True, werden Ziehbereiche bei Layoutaktualisierungen automatisch aktualisiert.
  • TitleBar.RecomputeDragRegions() — berechnet Drag-Bereiche nach dynamischen Inhaltsänderungen manuell neu.

Grund

Benutzerdefinierte Titelleisten kombinieren häufig interaktive Steuerelemente mit nicht interaktiven visuellen Elementen innerhalb Grid/StackPanel von Layouts. Der bisherige Ansatz, „Löcher aus dem gesamten Inhaltsbereich auszustanzen“, hinterließ in Layouts mit Leerraum, ungleichmäßigen Abständen oder dynamischer UI unerwartete, nicht ziehbare Leerstellen.

Visueller Vergleich

Standardverhalten (bisher) – nicht ziehbare Lücken:

Der leere mittlere Bereich kann nicht gezogen werden.

Aktuelles (neues) Verhalten – Lücken, die gezogen werden können, interaktive Steuerelemente ausgeschlossen:

Der leere Bereich ist verschiebbar; interaktive Bedienelemente sind korrekterweise ausgenommen. (RuntimeCompatibilityChange: TitleBar_ContentDragRegions)

Die API für Low-Rank Adapter (LoRA) für Phi Silica ist jetzt stabil.

LoRA ermöglicht Es Entwicklern, das Geräte-Phi-Silika-Sprachmodell mit ihren eigenen benutzerdefinierten Daten zu optimieren und die Ausgabe für bestimmte Szenarien wie Finanzen, Medizin und Ausbildung auszurichten. Laden Sie einen Adapter mit LanguageModelLowRankAdapter.CreateFromPath und übergeben Sie ihn über LanguageModelOptions.LowRankAdapter beim Aufruf von GenerateResponseAsync. Details finden Sie unter Phi Silika loRA .

Mit einer neuen AICapabilities.HasAICapability-API können Drittanbieteranwendungen bestimmen, ob das Gerät ein Copilot+ PC ist.

Die Version der ONNX-Runtime wurde auf 1.24.6 aktualisiert. Weitere Informationen finden Sie unter ONNX-Runtime-Versionen .

• Unterstützung für mehrere Ausführungsanbieter in einem einzigen MSIX-Paket hinzugefügt. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Unterstützung für die Erkennung von Execution Providern, die als Frameworkpakete bereitgestellt werden, hinzugefügt. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Der Auswahlmodus des Ausführungsanbieters für flexible Bereitstellungskonfigurationen wurde hinzugefügt. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Es wurde ein Speicherleck in ItemsRepeater behoben, bei dem wiederverwendete Elemente aufgrund eines Verweiszyklus durch RecyclePool nie vom Garbage Collector erfasst wurden, was auch zu Abstürzen in InvalidateChildrenMeasure führen konnte. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Ein Absturz wurde behoben, bei dem ein impliziter Abschluss-Callback einer Ein-/Ausblendanimation auf ein zerstörtes CUIElement zugreifen konnte, was zu einer Zugriffsverletzung führte. Die Rückruffunktion verwendet nun einen schwachen Verweis, um den Fall sicher zu handhaben, dass das Element zerstört wird, bevor die Animation beendet ist. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
• Es wurde ein Problem behoben, bei dem in einer XAML Island geöffneter Popupinhalt im Fenster OverrideScale nicht berücksichtigte, was dazu führte, dass der Inhalt überdimensioniert und abgeschnitten angezeigt wurde. Weitere Informationen finden Sie unter GitHub Problem #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• Es wurde ein Fail-Fast-Absturz behoben, der durch einen wiedereintrittsfähigen Dispatch während apartmentübergreifender COM-Freigabevorgänge in UIAffinityReleaseQueue::DoCleanup verursacht wurde. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: Ein nicht eindeutiger Modulsuchvorgang wurde behoben, wenn mehrere Module mit demselben Namen im selben Prozess geladen werden. GetModuleHandleW wurde durch GetModuleHandleExW ersetzt, sodass das richtige Modul anhand der Adresse aufgelöst wird. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Ein Absturz durch eine Ganzzahldivision durch null wurde in UniformGridLayout::GetMajorSize behoben, wenn ein ItemsRepeater in einer verfügbaren Breite angeordnet wird, die schmaler ist als der Minor-Stride eines Elements. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• Ein möglicher Absturz wurde behoben, falls ein Paket deinstalliert wurde, bevor es verarbeitet wurde. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Es wurde ein Problem behoben, bei dem GetReadyState falsche Fehlercodes (z. B. DisabledByUser oder NotSupportedOnCurrentSystem) zurückgeben konnte, wenn erforderliche Pakete noch nicht bereitgestellt wurden. Die API meldet NotReady nun ordnungsgemäß in diesem Szenario und verbessert die Diagnoseklarkeit. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Verbesserte interne Leistungsdiagnostik bei LanguageModel.GenerateResponseAsync zur besseren Identifizierung der Latenzquellen, bevor das erste Token zurückgegeben wird. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Es wurde ein Problem behoben, bei dem XAML-Compilerfehler beim Verwenden dotnet buildim Hintergrund verloren gingen und nur MSB3073: exited with code 1 anstelle der tatsächlichen Fehlermeldungen angezeigt wurden. Weitere Informationen finden Sie unter GitHub Problem #9813. (RuntimeCompatibilityChange: N/A, Änderung an den XAML-Compilerwerkzeugen zur Buildzeit)
• Es wurde ein Problem behoben, bei dem Microsoft.Windows.Workloads.dll aufgrund statischer Importe dynamischer Abhängigkeits-APIs, die in diesen Betriebssystemversionen nicht verfügbar sind, auf Windows Builds vor 22000 nicht geladen werden konnte. Die Funktionen werden jetzt dynamisch behoben, sodass Fehler in nicht unterstützten Betriebssystemversionen als normal HRESULT statt als Ladefehlerdialogfeld angezeigt werden. (RuntimeCompatibilityChange: N/A, keine Eindämmung)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.0.1:

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Windows App SDK 2.0 ist die erste Version des neuen Windows App SDK Versionsverwaltungsschemas, standardisiert auf Semantic Versioning 2.0.0. Dies ist auch das erste Mal, wenn wir die Hauptversionsnummer erhöhen.

Das neue Schema vereinfacht die Versionsverwaltung, indem die Windows App SDK Version mit der NuGet-Paketversion ausgerichtet wird. Das Verweisen auf Windows App SDK 2.0 in Ihrem Projekt bedeutet jetzt, dass Sie die entsprechende NuGet-Version ohne separate datumsbasierte Buildnummer verwenden, um folgendes nachzuverfolgen:

<PackageDependency Name="Microsoft.WindowsAppSDK" Version="2.0.1" />

Der Paketfamilienname entspricht auch der Hauptversion anstelle der Nebenversion, sodass die nächste parallele Version von Windows App SDK Version 3.0.0 ist. Unter SemVer sind grundlegende Änderungen nur für Hauptversionsupdates zulässig (siehe Windows App SDK Bereitstellungsarchitektur).

Das Microsoft.WindowsAppSDK.ML NuGet-Paket wurde umgestaltet und fügt eine neue Basisabhängigkeit hinzu. Die Funktionalität des vorhandenen ML NuGet-Pakets bleibt unverändert, aber die wichtigsten Windows ML-Features wurden in ein Basispaket namens Microsoft.Windows.AI.MachineLearning umgestaltet. Dieses neue Paket enthält einen minimalen Satz von Abhängigkeiten, bietet Unterstützung für Apps bis Windows 10 v1903. Wenn Sie Windows 10 v1809-Unterstützung benötigen, verwenden Sie weiterhin das vorhandene Microsoft.WindowsAppSDK.ML-Paket.

ONNX-Runtime. Die in Windows ML enthaltene Version der ONNX-Runtime wurde auf 1.24.5 aktualisiert. Weitere Informationen finden Sie unter ONNX-Runtime-Versionen . Diese Version enthält auch eine additive ORT-API-Änderung zur Unterstützung der Modellkompilierung mithilfe von Diagrammen, die von der OrtModelEditor API erstellt werden (eine Featurelücke in der vorherigen OrtCompileApi Oberfläche). Die Änderung ist nicht unterbrechend und wurde ergriffen, um die Blockierung anstehender WebNN-Browserszenarien aufzuheben; weitere Informationen finden Sie in der zugrunde liegenden ONNX Runtime PR #27332.

Lizenzierung: Der Windows ML-Lizenzvertrag wurde mit klareren Bedingungen für ISVs vereinfacht:

• Neustrukturierte Abschnitte "Installation", "Data" und "Distributionable Code" zur Übersichtlichkeit.
• In einem neuen Abschnitt zum Compliance-Hinweis für Ausführungsanbieter (EP) werden die Verantwortlichkeiten der Entwickler für hardwarebeschleunigte Ausführungsanbieter klargestellt.
• Direkte Links zu Lieferantenlizenzvereinbarungen für NVIDIA TensorRT, Intel OpenVINO und Qualcomm QNN (Qualcomm Neural Network SDK).

• Phi Silica APIs werden jetzt als Bestandteil einer Funktion mit eingeschränktem Zugriff (Limited Access Feature, LAF) erzwungen. Details finden Sie unter Phi Silika .
• Es wurden neue Zustände hinzugefügt, um Apps bei der Erläuterung vorübergehender und dauerhafter Fehler während des KI-Modellerwerbsprozesses zu AIFeatureReadyState unterstützen: CapabilityMissing, NotCompatibleWithSystemHardware und OSUpdateNeeded. Apps können diese Zustände verwenden, um Benutzern handlungsfähige Anleitungen zu geben, anstatt jede "nicht bereit"-Bedingung als generischen Fehler zu behandeln.
• Es wurden Überprüfungen auf verschiedene Netzwerk- und Windows Update Fehler während der KI-Modellinstallation hinzugefügt und dauerhafte Fehler gekennzeichnet, sodass Benutzer verstehen können, warum Modellpakete nicht installiert wurden.
• Verbesserte Diagnosefähigkeit für Textintelligenz-APIs, die in Windows KI-Szenarien verwendet werden.

Aktivierte Ziehunterstützung für WebView2-Inhalte, die in WinUI 3-Anwendungen gehostet werden. Diese Funktion wurde zuvor nicht unterstützt und ist jetzt verfügbar, ohne neue öffentliche APIs einzuführen. (Das Ablegen in ein WebView2-Steuerelement aus externen Quellen wurde bereits unterstützt.)

Unterstützte Szenarien:

• Standardmäßiger Drag-and-Drop-Inhalt. Das Ziehen von Text, HTML, Bildern und URLs wird unterstützt. Das Ziehen eines Bilds außerhalb der App führt zurzeit zu einem Standarddateinamen (z. B download.jpg. ), wenn es im Datei-Explorer abgelegt wird.
• Abbrechen des Ziehens. Bei Bedarf wird ein Abbruch eines aktiven Ziehvorgangs unterstützt, sodass eine App Drag-Vorgänge für eingeschränkte oder kurzlebige Inhalte bedingt blockieren kann, nachdem die Ziehvorgänge initiiert wurden.
• Benutzerdefinierte Drag-Visuals. Benutzerdefinierte Zieh-UI, z. B. Symbole oder Vorschauen, wird unterstützt, damit Benutzer den gezogenen Inhalt eindeutig identifizieren können.
• Anpassbare Ziehdaten. Das Bearbeiten und Anpassen von Ziehdaten wird unterstützt, um App-spezifische Szenarien zu ermöglichen, wie das Ziehen von Nachrichten innerhalb der App oder das Anfügen von Kontextmetadaten (z. B. „Von <App-Name>“), die der Zielort beim Ablegen lesen kann.

Limitations:

• Einige zusätzliche Drag-Datentypen werden derzeit nicht unterstützt, einschließlich DownloadURL.

Requirements:

• Minimale WebView2-Runtime-Version (Edge Beta-Kanal): 144.0.3719.11.

Die Microsoft.Windows.Storage.Pickers-API (eingeführt in Windows App SDK 1.8) wurde erweitert, um die Datei- und Ordnerauswahl zu optimieren, indem Entwickler initiale und persistente Ordnerspeicherorte und Gruppendateitypfilter mit klaren Bezeichnungen für die einfachere Navigation festlegen können.

• FileOpenPicker addiert FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, , SuggestedStartFolderund Title.
• FileSavePicker addiert InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, , SuggestedStartFolderund Title.
• FolderPicker addiert PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, , SuggestedStartFolderund Title.

• Relative Popup-Positionierung. Die neue PopupAnchor API ermöglicht DesktopPopupSiteBridge es, die relative Positionierung durch Verankern an ein eigenes Fenster oder eine Insel zu unterstützen, wobei die Einschränkung behoben wird, dass Popups nur absolut mithilfe von Bildschirmkoordinaten positioniert werden konnten. Neue DesktopPopupSiteBridge.AnchoringBehavior und DesktopPopupSiteBridge.AnchoringPixelAlignment Eigenschaften steuern das Verankerungsverhalten.
• Leitfaden für Tastaturhinweise Die neue InputFocusController.ShouldShowKeyboardCues Eigenschaft gibt Entwicklern Anleitung, ob Tastaturhinweise direkt nach der Erstellung eines ContentIsland angezeigt werden sollen.
• PointerPoint-Komfort-API. Mit der neuen PointerPoint.GetCurrentPoint Methode können Entwickler die aktiven PointerPoint Daten aus einer bereitgestellten Methode pointerIdabrufen.

Das neue Microsoft.UI.Xaml.Controls.SystemBackdropElement ist ein einfaches FrameworkElement, mit dem Apps einen Systemhintergrund wie Mica oder Acryl überall im XAML-Layout platzieren können, mit einer CornerRadius-Eigenschaft für abgerundete Hintergrundbereiche. Es schließt eine langjährige WinUI 3-Lücke, bei der In-App-Acryleffekte (zuvor einfach in WinUI 2 via AcrylicBrush.BackgroundSource) keine direkte Entsprechung hatten.

Der namespace Microsoft.Windows.Management.Deployment fügt ein Paketüberprüfungsframework und eine PackageVolume-API zum Verwalten der Speichervolumes hinzu, auf denen Pakete bereitgestellt werden.

• Validierungssteuerelemente. Neue IPackageValidator Schnittstelle plus drei integrierte Validatoren (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator), die über die neue AddPackageOptions Eigenschaft angefügt / StagePackageOptionsPackageValidators werden können. PackageValidationEventArgs, PackageValidationEventSource und PackageValidationHandler führen Validierungsereignisse durch; IsPackageValidationSupported und GetValidationEventSourceForUri ermöglichen es Benutzern, die Unterstützung zu testen, bevor sie die Bereitstellung aufrufen.
• Paketvolumen. Neuer PackageVolume Typ mit GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync und IsFeatureSupported für die Erkennung von Laufzeitfunktionen (PackageVolumeFeature).

Mit der neuen IXamlCondition Schnittstelle können Entwickler benutzerdefinierte Bedingungen definieren, die in die bedingte Namespacesyntax von XAML integriert sind und zur XAML-Analysezeit ausgewertet werden. Dadurch wird die experimentelle IXamlPredicate Schnittstelle ersetzt. Benutzerdefinierte Bedingungen ermöglichen bedingte XAML-Szenarien basierend auf anwendungsspezifischen Faktoren wie Featurekennzeichnungen, Gerätefunktionen, Geschäftslogik, Konfigurationseinstellungen und anderen Laufzeitbedingungen.

• Es wurde ein Problem behoben, bei dem das WindowsAppSDK-Installationsprogramm während der Installation keinen Fortschritt zeigte, sodass es angehalten wurde. Das Installationsprogramm bietet jetzt klareres Fortschrittsfeedback.
• Verbesserte Fehlerbehandlung für Szenarien, in denen WindowsAppSDKSelfContained für Klassenbibliotheken aktiviert ist.
• Es wurden MSB8027- und LNK4042-Buildwarnungen behoben, die durch doppelte ClCompile-Elemente in den Windows App SDK NuGet .targets-Dateien verursacht wurden, indem Präprozessordefinitionen aus <Target>-Blöcken in <ItemDefinitionGroup> verschoben wurden. Eine Opt-Out-Problemumgehung (WindowsAppSDK_Arm64EcCompilerWorkaround) ist für ARM64EC+LTCG-Builds enthalten, um einen bekannten internen MSVC-Compilerfehler zu vermeiden.
• Ein ListView-Absturz wurde behoben, der während der Tastaturnavigation (Tab/UMSCHALT+TAB) auftreten konnte, nachdem die Elementliste aktualisiert wurde.
• Es wurde ein Problem behoben, bei dem WinUI 3 abstürzen konnte, wenn der Fokus auf den CoreWebView2Controller Controller verschoben wurde, während der Controller nicht sichtbar war.
• Verbesserte DeleteIndex Zuverlässigkeit, sodass es mit ERROR_SHARING_VIOLATION in einigen Szenarien nicht mehr fehlschlägt (App-Inhaltssuche; verbleibt im experimentellen Kanal).
• Feste OCR-Begrenzungsfelder, die negative Werte in einigen Edgefällen zurückgeben.
• Ein Windows ML-Fehler wurde behoben, bei dem das Aufrufen von RegisterCertifiedAsync im selben Prozess fälschlicherweise 0 Ausführungsanbieter (EP) zurückgegeben hat.

Diese Version enthält eine Umgestaltung von transitiven Nuget-Verweisen. Um ein vorhandenes C++-Projekt zu aktualisieren, empfiehlt es sich, tools (nuget.exe oder Visual Studio) zu verwenden, um den vorhandenen Windows App SDK Paketverweis zu entfernen und den neuen Verweis hinzuzufügen. Dies funktioniert bei Upgradeproblemen mit packages.config-basierten Projekten.

Upgrade von 2.0 Experimental7. Das experimentelle Microsoft.WindowsAppSDK.ML-Paket wurde mit einer höheren Patchnummer als 2.0.0 stabil ausgeliefert, die als NuGet-Downgradefehler (insbesondere in C++-Projekten) angezeigt werden kann. Wenn Sie Experimental7 ausführen, folgen Sie der NuGet-Deinstallationsanleitung, um das experimentelle Paket zu entfernen, bevor Sie auf Version 2.0.0 wechseln.

• Die App-Inhaltssuche bleibt experimentell. Die Microsoft.Windows.Search.AppContentIndex-API-Oberfläche (App-Inhaltssuche) wurde in 2.0-Preview2 entfernt, um die Grundlagen zu verbessern und die zukünftige Kompatibilität sicherzustellen. Es ist nicht in 2.0.1 stable enthalten. Um damit zu experimentieren, verwenden Sie weiterhin experimentelle Versionen. Wenn Sie zuvor das experimentelle Microsoft.Windows.Search-Paket installiert haben, deinstallieren Sie es über die NuGet Uninstall Anleitung, bevor Sie zu 2.0.1 stable wechseln.
• APIs wurden bereits in der 1.8 Serviceversion ausgeliefert. Einige experimentelle Features, die während des 2.0-Zyklus in einer Vorschau angezeigt wurden, wurden in 1.8-Wartungsversionen auf stabile APIs heraufgestuft und sind daher in 2.0.1 nicht neu. Sie umfassen ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) und SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer (1.8.6). Details finden Sie in den Versionshinweisen zu 1.8 .

• AICapabilities fehlt von 2.0.1. Microsoft.Windows.AI.AICapabilities und AICapabilityCategory.CopilotPlusPCCapable (eine Copilot+ PC Funktionsprüfung) wurden in 1.8.7 ausgeliefert, sind aber nicht in 2.0.1 enthalten. Wir planen, sie in der Mai-Version wiederherzustellen.

Diese Version enthält die folgenden neuen APIs im Vergleich zur stabilen Version 1.8.7:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Controls

    SystemBackdropElement

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Das Microsoft.WindowsAppSDK.ML NuGet-Paket wurde umgestaltet und fügt eine neue Basisabhängigkeit hinzu. Die Funktionalität des vorhandenen ML NuGet-Pakets bleibt unverändert, aber die zentralen Windows ML-Funktionen wurden in ein abhängiges Basispaket namens Microsoft.Windows.AI.MachineLearning umstrukturiert. Dieses neue Paket enthält einen minimalen Satz von Abhängigkeiten, aber in C#/WinRT oder C++/WinRT unterstützt es nur bis zu Windows 10 18362. Wenn Sie Windows 10 17763-Unterstützung benötigen, verwenden Sie das vorhandene Microsoft.WindowsAppSDK.ML-Paket.

Für neue transitive Abhängigkeiten empfehlen wir die Verwendung von Tools zum Upgrade des Pakets (nuget.exe oder VS). Siehe auch: Windows App SDK 1.6 Versionshinweise.

Die Version der ONNX-Runtime wurde auf 1.24.4 aktualisiert. Weitere Informationen finden Sie unter ONNX-Runtime-Versionen .

Erzwungene Phi-Silikat-APIs, die Teil eines Features für eingeschränkten Zugriff sind.

Es wurden Überprüfungen auf verschiedene Netzwerk- und Windows Update Fehler während der KI-Modellinstallation hinzugefügt und dauerhafte Fehler gekennzeichnet, sodass Benutzer verstehen können, warum Modellpakete nicht installiert wurden.

Verbesserte Diagnosefähigkeit für Textintelligenz-APIs, die in Windows KI-Szenarien verwendet werden.

Die App-Inhaltssuche wurde aus der Vorschau 2.0 entfernt, während wir daran arbeiten, die Grundlagen zu verbessern und die zukünftige Kompatibilität sicherzustellen, während sich die zugrunde liegenden KI-Modelle ändern. In der Zwischenzeit verwenden Sie bitte weiterhin den experimentellen Kanal, um die neuesten Änderungen zu testen.

Aktivierte Ziehunterstützung für WebView2-Inhalte, die in WinUI 3-Anwendungen gehostet werden. Diese Funktion wurde zuvor nicht unterstützt und ist jetzt verfügbar, ohne neue öffentliche APIs einzuführen. Hinweis: Drag-and-Drop in WebView2 aus externen Quellen wird bereits unterstützt.

Unterstützte Szenarien

• Standardmäßiger Drag-and-Drop-Inhalt Das Ziehen von Text, HTML, Bildern und URLs wird unterstützt. Basierend auf dem aktuellen Verhalten führt das Ziehen von Bildern außerhalb der App zu einem Standarddateinamen (z. B download.jpg. ), wenn sie im Datei-Explorer abgelegt werden. Beispielszenario: Ein Benutzer wählt Text oder ein Bild in WebView2 aus und zieht es entweder innerhalb der App oder an ein anderes Ziel, z. B. den Datei-Explorer.

• Abbrechen des Ziehens. On-demand-Abbruch eines aktiven Ziehvorgangs wird unterstützt. Beispielszenario: Eine App blockiert bedingte Ziehvorgänge für bestimmte Inhaltstypen (z. B. eingeschränkte oder kurzlebige Inhalte), indem der Ziehvorgang abgebrochen wird, nachdem er initiiert wurde.

• Benutzerdefinierte visuelle Ziehelemente Benutzerdefinierte Zieh-UI, z. B. Symbole oder Vorschauen, wird unterstützt, damit Benutzer den gezogenen Inhalt eindeutig identifizieren können. Beispielszenario: Eine App zeigt eine Miniaturansicht oder ein Symbol an, während ein Benutzer Medieninhalte zieht, wodurch klar wird, welches Element derzeit verschoben wird.

• Anpassbare Ziehdaten Das Bearbeiten und Anpassen von Ziehdaten wird unterstützt, sodass App-spezifische Szenarien wie das Ziehen von Nachrichten innerhalb der App (z. B. als alternative Interaktion für die Nachrichtenweiterleitung) aktiviert werden. Beispielszenario: Eine App passt die Nutzlast des Ziehens an, um Kontextmetadaten wie den ursprünglichen Anwendungsnamen einzuschließen. Wenn der Inhalt abgelegt wird, kann das Ziel Informationen wie „Von <App-Name>“ anzeigen oder verarbeiten, um die Quelle des gezogenen Inhalts anzugeben.

Einschränkungen

• Die Unterstützung für zusätzliche Drag-Datentypen ist begrenzt. Die folgenden Formate werden derzeit nicht unterstützt:
  • DownloadURL

Anforderungen

• Minimale WebView2-Runtime-Version (Edge Beta-Kanal): 144.0.3719.11

Mit der IXamlCondition Schnittstelle können Entwickler benutzerdefinierte Bedingungen definieren, die in die bedingte Namespacesyntax von XAML integriert sind und zur XAML-Analysezeit ausgewertet werden. Dies ist eine Umbenennung und Graduierung der experimentellen IXamlPredicate Schnittstelle. Benutzerdefinierte Bedingungen ermöglichen bedingte XAML-Szenarien basierend auf anwendungsspezifischen Faktoren wie Featurekennzeichnungen, Gerätefunktionen, Geschäftslogik, Konfigurationseinstellungen und anderen Laufzeitbedingungen.

• Es wurden MSB8027- und LNK4042-Buildwarnungen behoben, die durch doppelte ClCompile-Elemente in Windows App SDK NuGet-.targets-Dateien verursacht wurden, und zwar durch das Verschieben von Präprozessordefinitionen von <Target>-Blöcken in <ItemDefinitionGroup>. Eine Opt-Out-Problemumgehung (WindowsAppSDK_Arm64EcCompilerWorkaround) ist für ARM64EC+LTCG-Builds enthalten, um einen bekannten internen MSVC-Compilerfehler zu vermeiden.
• Ein ListView-Absturz wurde behoben, der während der Tastaturnavigation (Tab/UMSCHALT+TAB) auftreten konnte, nachdem die Elementliste aktualisiert wurde.
• Es wurde ein Problem behoben, bei dem WinUI 3 abstürzen konnte, wenn der Fokus auf den CoreWebView2Controller verschoben wurde, während der Controller nicht sichtbar war.

Diese Version enthält die folgenden neuen und geänderten APIs im Vergleich zu 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• Die Version der ONNX-Runtime in Windows ML wurde auf 1.24 RC aktualisiert.
• Ein Fehler wurde behoben, bei dem beim erneuten Aufruf von RegisterCertifiedAsync im selben Prozess fälschlicherweise 0 Ausführungsanbieter (EP) zurückgegeben wurden.

• Neue InputFocusController.ShouldShowKeyboardCues-Eigenschaft, die Entwickler leitet, ob Tastaturhinweise unmittelbar nach der Erstellung einer ContentIsland angezeigt werden sollen.
• Neue Hilfs-APIPointerPoint.GetCurrentPoint, damit Entwickler die aktiven PointerPoint-Daten aus den bereitgestellten pointerId abrufen können.

• Verbesserte DeleteIndex Zuverlässigkeit. Manchmal würde DeleteIndex mit ERROR_SHARING_VIOLATION fehlschlagen.

• Behoben für OCR-Begrenzungsfelder, die negative Werte in einigen Edgefällen zurückgeben.

• Die App-Inhaltssuche ist Teil eines separaten Microsoft.Windows.Search-Pakets, anstatt Teil von Microsoft.Windows.AI package zu sein.

• Behebung des Problems, dass die Präfixsuche bei kurzen Suchanfragen nicht funktioniert.

• Neue APIs und Umbenennen basierend auf der offiziellen API-Überprüfung.

  • AppContentIndexer
    • GetContentItemsDieEineNeuindexierungErfordern
    • Entfernen -> InhaltselementEntfernen
    • EntferneMehrere -> EntferneInhaltsElemente
    • AlleInhaltsElementeEntfernen
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppContentIndexListener
    • IndexingStatusChanged –> ContentItemStatusChanged
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • Letztes Ergebnis -> Ergebnis abrufen
    • LetztesErgebnisGeändert -> ErgebnisGeändert
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • Letztes Ergebnis -> Ergebnis abrufen
    • LetztesErgebnisGeändert -> ErgebnisGeändert
  • AppManagedImageQueryMatch
    • Unterregion -> Interessengebiet
  • Content-Element-Status-Ergebnis
    • ReindexingStatus * ContentItemReindexingStatus (Status des Neuindizierens * Status des Inhaltsobjekts beim Neuindizieren)
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Es wurde ein Problem behoben, bei dem das WindowsAppSDK-Installationsprogramm während der Installation keinen Fortschritt zeigte, sodass es angehalten wurde. Das Installationsprogramm bietet jetzt klareres Fortschrittsfeedback.
• Verbesserte Fehlerbehandlung von Szenarien, in denen WindowsAppSDKSelfContained für Klassenbibliotheken aktiviert ist.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 1.8.5:

---

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem
    SystemBackdropElement

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryContentItemsFilterFlags
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

• Mit neuen AIComputeDevice-APIs können Apps beim Erstellen eines TextRecognizers das Standard-, CPU- oder NPU-Ausführungsgerät auswählen. ContentRegionImageOptions.PreferredTextRecognizerDevice stellt dieselbe Gerätepräferenz für die OCR bereit, die bei der Bildindizierung des App-Inhaltsindex durchgeführt wird.
• AI Speech verwendet jetzt SpeechRecognitionModelFactory und SpeechRecognitionModelFactoryOptions zum Konfigurieren und Erstellen von Spracherkennungsmodellen. Audioeingabemethoden akzeptieren jetzt 16-Bit-Samplepuffer, das Beenden der kontinuierlichen Erkennung erfolgt asynchron, und Ereignisse der Streamingerkennung legen anbieterspezifische Eigenschaften offen.
• LanguageModel.ModelName, LanguageModel.ModelVersion und LanguageModelLowRankAdapterStatus ermöglichen Apps die Identifizierung des installierten Sprachmodells und prüfen das Kompatibilitätsergebnis beim Laden eines Low-Rank-Adapters.
• LanguageModelResponseStatus.BlockedByGameMode und LanguageModelResponseStatus.LowOnVram identifizieren Antworten, die nicht abgeschlossen werden konnten, da der Spielmodus aktiv war oder der verfügbare Videospeicher niedrig war.

Mit der neuen experimentellen FrameworkElement.SetThemeResourceBinding-API können Apps das Äquivalent einer {ThemeResource} Bindung aus Code erstellen. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

Ein neuer experimenteller DataTemplate-Konstruktor akzeptiert einen app-bereitgestellten Delegaten, der die Elementunterstruktur der Vorlage erstellt. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

Das experimentelle TableView-Steuerelement ist jetzt in den öffentlichen WinMDs verfügbar. Es unterstützt die Gruppierung mit Gruppenkopfzeilen mit Vorlagen, das Sortieren und Filtern mit Sortierindikatoren in den Spaltenüberschriften, das Ändern der Spaltengröße per Mauszeiger und Tastatur sowie optionale Tooltips für Zellen und Spaltenüberschriften. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Diese Version fügt ein experimentelles WinUI 3 Chart-Steuerelement zum Darstellen von kartesischen Daten als Linien-, Flächen- und Balkenreihen hinzu. Das Steuerelement unterstützt konfigurierbare Achsen, Legenden, Datenbeschriftungen und Datenmarkierungen. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• InkPresenter.ActivateCustomDrying und InkSynchronizer hinzugefügt, mit denen Apps abgeschlossene Freihandstriche mithilfe von BeginDry und EndDry selbst darstellen können.
• Es wurde ein Zugriffsverstoß behoben, der beim Lesen von InkPresenter.StrokeContainer während der aktiven benutzerdefinierten Trocknung auftreten konnte.
• Die Größenanpassung des InkCanvas-Presenters unter einer RenderTransform wurde behoben.
• Richtete die experimentelle InkToolbar-API mit dem überprüften Design aus. Die Symbolleiste zielt jetzt direkt auf ein InkPresenter-Element ab, ohne dass inkCanvas erforderlich ist. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Es wurde ein Problem bei der WinUI-Ressourcennachverfolgung behoben, das dazu führen konnte, dass die Speicherauslastung anstieg, wenn Apps wiederholt Visual-State-Storyboards erstellten oder statische Ressourcen bzw. Themeressourcen auflösten. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• Verbesserte Bereinigung nicht erreichbarer nativer WinUI-Objekte in .NET-Apps nach dem Schließen einer Registerkarte oder Seite. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

Diese Version enthält die folgenden neuen und aktualisierten APIs im Vergleich zur 2.4 Experimental-Version :

Microsoft.UI.Xaml

    DataTemplate
        DataTemplate (elementFactory)

    DataTemplateElementFactory

    FrameworkElement
        SetThemeResourceBinding

Microsoft.UI.Xaml.Controls

    InkPresenter
        ActivateCustomDrying
        HighContrastAdjustment

    InkToolbar
        TargetInkPresenter

    InkStrokeInput
        InkPresenter

    InkSynchronizer

    InkUnprocessedInput
        InkPresenter

Microsoft.UI.Xaml.Controls.Charts

    AreaSeries
    Axis
    BarOrientation
    BarSeries
    CartesianAxis
    CartesianSeries
    CategoryAxis
    CategorySortKey
    Chart
    DataLabelOverride
    DataMarkerOverride
    DateTimeAxis
    DateTimeIntervalType
    GridLines
    LinearAxis
    LineSeries
    MarkerShape
    Samples
    SortOrder
    StrokeDashStyle
    WinUIChartingContract
    XamlChartsResources

Microsoft.UI.Xaml.Controls.Tabular

    ITableViewSortComparer
    SortDirection
    TableView
    TableViewAutomationPeer
    TableViewBeginningEditEventArgs
    TableViewCellAutomationPeer
    TableViewCellEditEndingEventArgs
    TableViewCellsPanel
    TableViewColumn
    TableViewColumnHeaderAutomationPeer
    TableViewDensity
    TableViewEditAction
    TableViewFrozenEdge
    TableViewGridLinesVisibility
    TableViewGroupHeader
    TableViewGroupHeaderAutomationPeer
    TableViewGroupHeaderToggleRequestedEventArgs
    TableViewGroupInfo
    TableViewHeadersVisibility
    TableViewIdentitySelector
    TableViewKeySelector
    TableViewPredicate
    TableViewRow
    TableViewRowAutomationPeer
    TableViewRowTemplateSelector
    TableViewSelectionMode
    TableViewSortCycle
    TableViewSortedEventArgs
    TableViewSortingEventArgs
    TableViewSource
    TableViewTemplateColumn
    TableViewTextColumn
    TabularControlsResources

Microsoft.UI.Xaml.XamlTypeInfo

    XamlControlsChartsXamlMetaDataProvider
    XamlControlsTabularXamlMetaDataProvider

Microsoft.Windows.AI

    AIComputeContract
    AIComputeDevice

Microsoft.Windows.AI.Imaging

    TextRecognizer
        CreateAsync
        EnsureReadyAsync
        GetReadyState

Microsoft.Windows.AI.Speech

    BatchRecognition
        Recognize

    SpeechAudioProvider
        PushData

    SpeechRecognitionModelFactory
    SpeechRecognitionModelFactoryOptions

    StreamingRecognition
        StopContinuousRecognitionAsync

    StreamingRecognizedEventArgs
        GetProperty

    StreamingRecognizingEventArgs
        GetProperty

Microsoft.Windows.AI.Text

    LanguageModel
        ModelName
        ModelVersion

    LanguageModelLowRankAdapterResult
        Status

    LanguageModelLowRankAdapterStatus

    LanguageModelResponseStatus
        BlockedByGameMode
        LowOnVram

Microsoft.Windows.Search.AppContentIndex

    ContentRegionImageOptions
        PreferredTextRecognizerDevice

Diese Version fügt Unterstützung für Freihandeingaben in WinUI 3 mit InkCanvas, InkToolbar und InkPresenter hinzu, einschließlich Stift- und Toucheingabe, Zwischenablageunterstützung, Unterstützung für den hohen Kontrastmodus, Stricheingabe und nicht verarbeitete Eingabe. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.3 Experimental A :

Microsoft.UI.Xaml.Automation.Peers

    InkToolbarAutomationPeer
    InkToolbarFlyoutItemAutomationPeer
    InkToolbarMenuButtonAutomationPeer
    InkToolbarToolButtonAutomationPeer

Microsoft.UI.Xaml.Controls

    InkCanvas
        InkPresenter

    InkHighContrastAdjustment
    InkInputConfiguration
    InkInputProcessingConfiguration
    InkInputProcessingMode
    InkInputRightDragAction
    InkPresenter
    InkStrokeContainer
    InkStrokeInput
    InkStrokesCollectedEventArgs
    InkStrokesErasedEventArgs
    InkToolbar
    InkToolbarBallpointPenButton
    InkToolbarButtonFlyoutPlacement
    InkToolbarCustomPen
    InkToolbarCustomPenButton
    InkToolbarCustomToggleButton
    InkToolbarCustomToolButton
    InkToolbarEraserButton
    InkToolbarEraserFlyoutItemClickedEventArgs
    InkToolbarEraserFlyoutItemKind
    InkToolbarEraserKind
    InkToolbarFlyoutItem
    InkToolbarFlyoutItemKind
    InkToolbarHighlighterButton
    InkToolbarInitialControls
    InkToolbarIsStencilButtonCheckedChangedEventArgs
    InkToolbarMenuButton
    InkToolbarMenuKind
    InkToolbarPenButton
    InkToolbarPencilButton
    InkToolbarPenConfigurationControl
    InkToolbarRulerButton
    InkToolbarStencilButton
    InkToolbarStencilKind
    InkToolbarToggle
    InkToolbarToggleButton
    InkToolbarTool
    InkToolbarToolButton
    InkUnprocessedInput

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Neue experimentelle Window.Width - und Window.Height-Eigenschaften bieten Apps eine DPI-fähige Möglichkeit, die Größe eines Fensters direkt aus Code oder Markup in logischen (Client)-Pixeln abzurufen und festzulegen, ohne window.AppWindow zu erreichen und manuelle logische zu physische DPI-Konvertierung durchzuführen. Die Begleiteigenschaften "Window.MinWidth", "Window.MinHeight", "Window.MaxWidth" und "Window.MaxHeight " beschränken die Größe des Fensters. Wir freuen uns über Ihr Feedback.

Der experimentelle SpeechAudioProvider (verwendet zum Pushen von 16 kHz, 16-Bit- und Single-Channel-PCM-Audio in die Spracherkennung) implementiert jetzt IClosable, sodass Apps den Anbieter mit Close/Dispose deterministisch freigeben können, wenn sie das Streaming von Audio beenden.

Die experimentellen App-Inhaltsindex-APIs fügen neue Indizierungsfunktionen und erhebliche Zuverlässigkeits- und Leistungsverbesserungen in dieser Version hinzu:

• Schnellere Batch-Indizierung. Mit einer neuen AppContentIndexer.BatchAddOrUpdate-API können mehrere Elemente zusammen indiziert werden. Die Indizierungspipeline wurde ebenfalls neu gestaltet, um parallele Phasenausführung und effizientere Batchverarbeitung zu unterstützen.
• Verbesserte mehrsprachige Tokenisierung. App Content Index verwendet jetzt einen ICU-basierten Wortsegmentierer, wodurch die Korrektheit der Tokenisierung sprachübergreifend verbessert und gleichzeitig die Abhängigkeit von WinRT WordsSegmenter entfernt wird.
• Verbesserte Indizierungs- und Abfrageleistung. Indexaktualisierungen vermeiden jetzt unnötige lexikalische Neuschreibungen, führen Batch-Bereinigungen effizienter aus und speichern Indexfunktionen abfrageübergreifend im Cache, wodurch der Overhead in gängigen Abfrage- und Indizierungspfaden erheblich reduziert wird.
• Stabilere lexikalische Rangfolge. Die BM25-Bewertung führt Statistiken zur Dokumentlänge jetzt separat, sodass die Rangfolge konsistent bleibt, wenn Inhalte inkrementell aktualisiert oder entfernt werden.
• Automatische Wiederherstellung nach Beschädigung. Der App-Inhaltsindex erkennt Datenbankbeschädigungen und inkompatible Schemaänderungen beim Öffnen eines Indexes und wird automatisch wiederhergestellt, indem eine Neuindizierung initiiert wird, anstatt den Index nicht zu verwenden. GetOrCreateIndexStatus.RecoveredFromCorruption gibt an, wann die Wiederherstellung erfolgt ist.
• Statische Ranking-Anhebungen. Mit neuen APIs können Apps Bewertungsverstärkungen auf einzelne Inhaltselemente oder Regionen anwenden, sodass Ergebnisse mithilfe von anwendungsbezogenen Signalen verzerrt werden können. Verwenden Sie statische Verstärkungen, wenn Ihre App Über die relative Wichtigkeit von Inhalten verfügt, die nicht von den Inhalten selbst erfasst werden, z. B. um ein Dokument anzuzeigen, das besonders wichtig oder häufig von Ihren Benutzern gesucht wird.
• Bildinhaltsindizierung. Apps können jetzt Bitmap- oder Bildstreaminhalte direkt indizieren, mit Optionen zur Steuerung der OCR-Extraktion und semantischen Indizierung von extrahierten Text. Verwenden Sie die Bildindizierung, wenn aussagekräftige durchsuchbare Informationen in einem Bild enthalten sind, anstatt bereits als Text verfügbar zu sein, z. B. Screenshots, gescannte Dokumente oder andere visuelle Inhalte.
• Steuerelement für die semantische Indizierung für Text. Mit einer neuen ContentRegionTextOptions.AllowSemanticIndexing-Eigenschaft können Apps einzelne Textbereiche aus der semantischen Indizierung deaktivieren. Dies ist nützlich für Text, der lexikalisch durchsuchbar bleiben sollte, aber nicht von semantischem Abgleich profitieren kann, wodurch Apps mehr Kontrolle darüber erhalten, welche Inhalte am semantischen Abruf teilnehmen.

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.2 Experimental 9 :

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml

    Window
        Height
        MaxHeight
        MaxWidth
        MinHeight
        MinWidth
        Width

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Speech

    SpeechAudioProvider
        Dispose

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        BatchAddOrUpdate
        GetContentStaticBoost
        GetRegionStaticBoost
        ResetAllStaticBoosts
        SetContentStaticBoost
        SetRegionStaticBoost

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream
        StaticBoost

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    BatchAddOrUpdateItemResult
    BatchAddOrUpdateResult
    ContentRegionImageOptions
    ContentRegionTextOptions
        AllowSemanticIndexing

    GetOrCreateIndexStatus
        RecoveredFromCorruption

    ImageOcrIndexingOptions
    IndexableAppContent
        StaticBoost

Die Sprachmodell-APIs werden jetzt auf nicht-Copilot+ PCs ausgeführt, die mit einer unterstützten GPU ausgestattet sind, wodurch die Funktionen des lokalen Sprachmodells auf eine breitere Palette von Windows 11 Geräten bereitgestellt werden. Unterstützte Hardware umfasst NVIDIA GeForce RTX 30-Serie und neuer mit 6+ GB vRAM. GPU-Inferenz erfordert einen aktivierten Entwicklermodus sowie einen Build des Windows Insider Experimental Channel.

Das GPU-Modell ist nicht vorinstalliert. Sie wird bei Bedarf über EnsureReadyAsync über Windows Update heruntergeladen. Apps sollten GetReadyState überprüfen und vor dem Auslösen des Downloads ein Einwilligungsdialogfeld anzeigen. Benutzer können das Modell unter "Settings > System > AI Components" verwalten.

Informationen zur verantwortungsvollen KI finden Sie im neuen Transparenzhinweis: Sprachmodell-APIs auf Nicht-Copilot+-PCs.

Neue geräteinterne Spracherkennungs-APIs in Microsoft.Windows.AI.Speech ermöglichen sowohl die Sprach-zu-Text-Umwandlung per Stapelverarbeitung als auch per Streaming. BatchRecognition erkennt eine vollständige Audioquelle mit einem einzigen Aufruf, und StreamingRecognition löst Recognizing- und Recognized-Ereignisse aus. Audio kann von einem Gerät (), einer Datei (AudioConfiguration.FromAudioDeviceFromFile), einem Eingabedatenstrom (FromStream) oder vom Anrufer per SpeechAudioProvider Push übertragen werden (16 kHz, 16-Bit, Single-Channel PCM). Das On-Device-Modell wird über SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync verwaltet, wobei der Download- und Ladefortschritt über SpeechRecognitionModelProgress gemeldet wird.

Eine neue Microsoft.Windows.Workloads.NpuType Enumeration zeigt die NPU-Klasse auf dem aktuellen Gerät an (z. B. Qnn, Lnl, Stx, Win365, Unknown, None), sodass Apps und Workloads-Infrastruktur KI-Workloads an den entsprechenden Ausführungspfad weiterleiten können.

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.1 Experimental 8 :

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Speech

    AudioConfiguration
    BatchRecognition
    SpeechAudioProvider
    SpeechContract
    SpeechRecognitionModel
    SpeechRecognitionModelProgress
    SpeechRecognitionModelProgressStatus
    SpeechRecognitionModelResult
    StreamingRecognition
    StreamingRecognizedEventArgs
    StreamingRecognizingEventArgs

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        CompressPromptAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync

    LanguageModelOptionsExperimental
        PreferredRetentionRatio

Microsoft.Windows.Workloads

    NpuType

LanguageModelExperimental.GenerateStructuredJsonResponseAsync (eingeführt in 2.0 Experimental 7) gibt nun einen dedizierten GenerateStructuredJsonResponseResult Typ mit einer GenerateStructuredJsonResponseStatus Eigenschaft anstelle des generischen LanguageModelResponseResult / LanguageModelResponseStatus Paares zurück. Die neue Statusenume ist spezifisch für die schemabeschränkte Generierung: Sie enthält einen ResponseInvalidJson Wert für den Fall, in dem die Modellausgabe das angeforderte JSON-Schema nicht erfüllt hat, getrennt von generischen Antwortfehlern im Sprachmodell.

Im Rahmen dieser Aufteilung wurde der ResponseInvalidJson-Wert aus dem stabilen Enum LanguageModelResponseStatus (dem er zuvor hinzugefügt worden war, um die strukturierte JSON-Ausgabe zu unterstützen). Apps, die ResponseInvalidJson von LanguageModelResponseStatus verarbeitet haben, sollten diese Verarbeitung auf das neue GenerateStructuredJsonResponseStatus verlagern, das von GenerateStructuredJsonResponseAsync zurückgegeben wird. Andere Aufrufer von LanguageModelResponseStatus müssen keinen JSON-spezifischen Fehlerwert mehr berücksichtigen.

Diese Version enthält die folgenden neuen APIs im Vergleich zur Version 2.0 Experimental 7 :

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Microsoft.Windows.AI.Text.Experimental

    GenerateStructuredJsonResponseResult

    GenerateStructuredJsonResponseStatus

    LanguageModelOptionsExperimental
        LowRankAdapter [Experimental]

Windows App SDK 2.0.0-experimental7 führt experimentelle CMake-Unterstützung (unter aktiver Entwicklung) ein, sodass C++-Entwickler Windows App SDK NuGet-Pakete aus CMake-basierten Projekten nutzen können.

Die CMake-Integration basiert auf NuGetCMakePackage, einem Open-Source-CMake-Modul, das die Lücke zwischen der NuGet-Paketverwaltung und dem systemeigenen find_package() Workflow von CMake überbrückt. NuGetCMakePackage behandelt das Herunterladen und Wiederherstellen von NuGet-Paketen während der Konfiguration über add_nuget_packages(), untersucht jedes Paket auf eine eingebettete CMake-Konfiguration (bei build/cmake/<package>-config.cmake) und macht die Header-Dateien des Pakets, Importbibliotheken, Laufzeit-DLLs und WinRT-Metadaten als standardmäßige CMake-Ziele verfügbar.

Jede Windows App SDK NuGet-Komponente und jedes abhängige Paket bettet jetzt eine CMake-Konfigurationsdatei unter build/cmake/ ein, die mit Hilfe der NuGetCMakePackage-Bibliothek CMakes find_package() ermöglicht, Ziele, Header, Bibliotheken und Laufzeit-DLLs ohne manuelle Pfadkonfiguration automatisch zu ermitteln. Dies umfasst alle Komponentenpakete, einschließlich Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML und WinUI sowie Abhängigkeiten wie Base und Runtime.

Eine Übersicht über das CMake-Verbrauchsmodell und erste Schritte finden Sie auf der CMake-Startseite.

Dieses Feature ist experimentell und wird frühzeitig eingeführt, um Feedback aus der Community zu sammeln. Die Zielbenennungskonventionen und Konfigurationsmuster können basierend auf Entwicklereingaben geändert werden. Da es sich um einen frühen Test-Flight handelt, sind einige Zeremonien und Setups erforderlich . Weitere Informationen finden Sie in den CMake-Beispielanwendungen , die die End-to-End-Konfiguration und -Nutzung in allen vier Bereitstellungsszenarien (SelfContained|FrameworkDependent x Packaged|Unpackaged) veranschaulichen.

Wir möchten von Ihnen hören! Wenn ein Szenario auftritt, das derzeit nicht behandelt wird, Vorschläge zur Verbesserung der Entwicklererfahrung haben oder Probleme auftreten, senden Sie bitte Feedback unter der Registerkarte Issues im Windows App SDK Open-Source-Repository oder starten Sie eine Unterhaltung in Discussions. Ihre Eingabe wird die aktive Entwicklung dieses Features direkt gestalten.

In dieser experimentellen Version sind die Änderungen und Korrekturen enthalten, die in 2.0-Preview1 und 2.0-Preview2 bereitgestellt wurden. Die angesprochenen Punkte sind nachstehend zusammengefasst; ausführliche Informationen finden Sie in den verknüpften Vorschauhinweisen.

Von 2.0-Preview1:

• Windows ML: Behoben für RegisterCertifiedAsync, der 0 Ausführungsanbietern zurückgibt, wenn sie im selben Prozess erneut aufgerufen werden.
• Microsoft.UI.Content: Neue Eigenschaft und neue benutzerfreundliche API.
• Microsoft.Windows. Management.Deployment: Neue PackageVolume-APIs für Parity+ mit Windows.Management.Deployment (einschließlich AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported und mehr). Neuer IPackageValidator Erweiterbarkeitspunkt auf AddPackageOptions und StagePackageOptions, mit drei integrierten Validatoren: PackageCertificateEkuValidator, , PackageFamilyNameValidatorund PackageMinimumVersionValidator.
• Microsoft.Windows. Storage.Pickers:
  • Neue Title Eigenschaften für FileOpenPicker, FileSavePickerund FolderPicker, aktivieren benutzerdefinierte Dialogfeldtitel.
  • Neue SettingsIdentifier Eigenschaften auf FileOpenPicker, FileSavePicker und FolderPicker, die einen instanzspezifischen Zustand des Auswahlwerkzeugs über Sitzungen hinweg ermöglichen.
  • Neue InitialFileTypeIndex Eigenschaften für FileOpenPicker und FileSavePicker, sodass Entwickler den standardmäßig ausgewählten Dateitypfilter nach Index (0-basiert) festlegen können.
  • Neue ShowOverwritePrompt Eigenschaft für FileSavePicker. Der Standardwert ist true, und er steuert, ob der Dateiauswahldialog eine Warnung vor dem Überschreiben ausgibt, wenn der Benutzer über FileSavePicker eine vorhandene Datei wählt.
  • Das Standardverhalten von FileSavePicker wurde geändert: Beginnend mit WindowsAppSDK 2.0 wird FileSavePicker keine leere Datei mehr erstellt, wenn der Benutzer eine nicht vorhandene Datei auswählt, sodass Entwickler selbst entscheiden können, wann die Datei erstellt werden soll.
  • Neue PickMultipleFoldersAsync Methode auf FolderPicker, die die Auswahl mehrerer Ordner in einem Schritt ermöglicht.
• Fehlerkorrekturen: Berichterstellung über den Installationsfortschritt; verbesserte Fehlerbehandlung für WindowsAppSDKSelfContained Klassenbibliotheken.

Von 2.0-Preview2:

• Windows AI-APIs: Phi Silica-APIs sind als Funktion mit eingeschränktem Zugriff implementiert; neue AIFeatureReadyState Werte weisen auf Modellerwerbsprobleme wie fehlende Funktionen, inkompatible Hardware und erforderliche Betriebssystemupdates hin; dauerhafte Netzwerk- oder Windows-Update-Installationsfehler werden jetzt gekennzeichnet; verbesserte Diagnosefunktionen für Text Intelligence-APIs.
• Custom XAML Conditionals: IXamlCondition führt die experimentelle IXamlPredicate Schnittstelle ein und benennt sie um, wodurch benutzerdefinierte Bedingungen ermöglicht werden, die bereits beim Parsen von XAML ausgewertet werden.
• WebView2 (WinUI 3): Unterstützung für in WebView2 gehostete Inhalten (Text, HTML, Bilder, URLs), Drag-Abbruch, benutzerdefinierte Drag-Visualisierungen und anpassbare Drag-Daten. Erfordert WebView2 Runtime 144.0.3719.11 oder höher. (DownloadURL noch nicht unterstützt.)
• Bug fixes: MSB8027/LNK4042-Buildwarnungen aufgrund doppelter ClCompile-Elemente in .targets-Dateien (mit Opt-out-Workaround WindowsAppSDK_Arm64EcCompilerWorkaround für ARM64EC+LTCG); ListView-Absturz während der Tastaturnavigation nach Aktualisierung der Elementlisten; WinUI 3-Absturz, wenn der Fokus auf einen nicht sichtbaren CoreWebView2Controller verschoben wird.

• Durchführung der API-Umbenennung zur Übersichtlichkeit und Konsistenz:
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale und VideoScaler.ScaleImageBuffer
• Verschiedene Fehlerbehebungen und Qualitätsverbesserungen in VSR.

• Neue LanguageModelExperimental.GenerateStructuredJsonResponseAsync-API unter Microsoft.Windows.AI.Text.Experimental zum Generieren einer strukturierten JSON-Ausgabe aus einem Sprachmodell.
• Neuer LanguageModelResponseStatus.ResponseInvalidJson Statuswert, der angibt, dass ein Modell eine Antwort zurückgegeben hat, die nicht als gültiges JSON analysiert wurde.

• Neue AppContentIndexer.GetExistingIndexes und AppContentIndexer.IsContentKindSupported APIs.
• Neuer AppManagedOcrTextQueryMatch Typ und QueryMatchContentKind.AppManagedOcrText Wert zur Unterstützung der Abfrage von App-Inhalten über OCR-abgeleiteten Text.
• Neue GetOrCreateIndexOptions.CreateAlways, um die Erstellung eines neuen Indexes zu erzwingen.
• Neu ContentItemErrorDetail.InsufficientDiskSpace zum Aufzeigen von Fehlern bei geringem Speicherplatz während der Indizierung.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0.0-experimental6:

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

Windows ML kann jetzt aus C++-Projekten mit CMake verwendet werden. Weitere Informationen finden Sie auf der Seite "Erste Schritte" .

Die Version der ONNX-Runtime wurde auf 1.24.2 aktualisiert. Weitere Informationen finden Sie unter ONNX-Runtime-Versionen .

• NPUPowerMode wird zugunsten neuerer APIs für die Energieverwaltung nicht mehr unterstützt.
• GetReadyState gibt ordnungsgemäß nun NotSupported zurück, wenn der Sitzungsbroker nicht verfügbar ist, anstatt eine Ausnahme auszulösen.

• Unterstützung des NV12-Ausgabeformats für die Video-Superauflösung hinzugefügt.

• Verbesserte DeleteIndex Zuverlässigkeit. Manchmal würde DeleteIndex mit ERROR_SHARING_VIOLATION fehlschlagen.

• Behoben für OCR-Begrenzungsfelder, die negative Werte in einigen Edgefällen zurückgeben.

• Die App-Inhaltssuche ist Teil eines separaten Microsoft.Windows.Search-Pakets, anstatt Teil von Microsoft.Windows.AI package zu sein.

• Behebung des Problems, dass die Präfixsuche bei kurzen Suchanfragen nicht funktioniert.

• Neue APIs und Umbenennen basierend auf der offiziellen API-Überprüfung.

  • AppContentIndexer
    • GetContentItemsDieEineNeuindexierungErfordern
    • Entfernen -> InhaltselementEntfernen
    • EntferneMehrere -> EntferneInhaltsElemente
    • AlleInhaltsElementeEntfernen
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppCOntentIndexListener
    • IndexingStatusChanged –> ContentItemStatusChanged
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • Letztes Ergebnis -> Ergebnis abrufen
    • LetztesErgebnisGeändert -> ErgebnisGeändert
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • Letztes Ergebnis -> Ergebnis abrufen
    • LetztesErgebnisGeändert -> ErgebnisGeändert
  • AppManagedImageQueryMatch
    • Unterregion -> Interessengebiet
  • Content-Element-Status-Ergebnis
    • ReindexingStatus * ContentItemReindexingStatus (Status des Neuindizierens * Status des Inhaltsobjekts beim Neuindizieren)
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• ImageDescription.DescribeAsync-Fehler mit InternalError aufgrund einer Rennbedingung wurde behoben.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Vereinfachte Lizenzvereinbarung mit klareren Bedingungen für ISVs, die Anwendungen mit Windows ML erstellen.
• Umstrukturierte Abschnitte, die Installation, Daten und Verteilungscode mit verbesserter Übersichtlichkeit abdecken.
• Im Abschnitt "New Execution Provider (EP) Compliance Notice" werden die Verantwortlichkeiten von Entwicklern in Bezug auf hardwarebeschleunigte Ausführungsanbieter erläutert.
• Direkte Links zu Lieferantenlizenzvereinbarungen für NVIDIA TensorRT, Intel OpenVINO und Qualcomm QNN (Qualcomm Neural Network SDK).

• Windows ML-experimentelle Builds werden an die Hauptlinie der ONNX-Runtime, Version 1.24, angeglichen, um die Kompatibilität und Stabilität zu verbessern.
• Stable Application Binary Interface (ABI)-Ausführungsanbieter werden erzwungen, um ein vorhersagbares Verhalten auf allen Geräten sicherzustellen, wobei nicht stabile Ausführungsanbieter vom Erwerb ausgeschlossen sind.
  • Nur der OpenVINO-Ausführungsanbieter wird unterstützt, mit zusätzlichen Ausführungsanbietern, die im Laufe der Zeit hinzugefügt werden sollen, da sie den Stabilitätsanforderungen entsprechen.
• Die Größe von Microsoft.Windows.AI.MachineLearning.dll wurde um ca. 160 KB reduziert.

• Neue experimentelle APIs zum Nachschlagen von Statistiken zu Elementen, die indiziert werden. Dies bietet Einblicke in die Vorgänge im Index.
• Unterstützung für Abfrageabbruch, damit Apps eine Abfrage ausführen und aktualisieren können, wenn eine neue Abfrage vorhanden ist, bevor die aktuelle Abfrage abgeschlossen ist. Dies ermöglicht es, schneller auf die Abfrage zu reagieren, wenn ein Benutzer die Abfragezeichenfolge eingibt.
• Präfixabgleichsunterstützung für kurze Zeichenfolgen, um Ergebnisse zu verbessern, während der Benutzer eingabet.

• VideoScaler ist jetzt verfügbar und verbessert die Ressourcenverwaltung und die Lebenszyklussteuerung.
• Das VSR-Modell wird jetzt kompiliert und zwischengespeichert, um die Leistung zu verbessern und wiederholte Initialisierungskosten zu reduzieren.
• Es wurde eine Funktionsüberprüfung hinzugefügt, um die VSR-Unterstützung vor der Verwendung zu überprüfen.
• Die explizite WinML-Initialisierung ist bei Verwendung der Video-Superauflösung nicht mehr erforderlich.

• Das FlowLayout Steuerelement verwendet jetzt die Terminologie "ItemSpacing" und "LineSpacing" anstelle von horizontalen und vertikalen Abstandseigenschaften. Die abgestimmte Benennung verbessert Klarheit und Konsistenz mit modernen Layoutmustern in verschiedenen UI-Frameworks.

• Das WrapPanel Steuerelement verwendet jetzt itemSpacing und LineSpacing-Nomenklatur anstelle der vorherigen horizontalen und vertikalen Abstandseigenschaften.

• Die IXamlPredicate Schnittstelle wurde implementiert, um benutzerdefinierte Prädikate zu definieren, die nahtlos in die bedingte Namespacesyntax von XAML integriert werden und beim XAML-Parser ausgewertet werden.
• Benutzerdefinierte Prädikate ermöglichen bedingte XAML-Szenarien basierend auf anwendungsspezifischen Faktoren wie:
  • Featureflags
  • Gerätefunktionen
  • Geschäftslogik
  • Konfigurationseinstellungen
  • Andere Laufzeitbedingungen

• Aktualisierte Pakete zur Verbesserung der externen Benutzerfreundlichkeit, einschließlich Änderungen an:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Hinzugefügte Buildunterstützung für Visual Studio 2026
• Es wurden Tools und Skripts eingeführt, die von externen Entwicklern zum Erstellen und Testen von WinUI verwendet werden können.

• [veraltet] DependencyObject.Dispatcher
• [veraltet] Window.Current
• [veraltet] FocusManager.GetFocusedElement
• [umbenannt] SystemBackdropHost zu SystemBackdropElement

• [umbenannt] Microsoft.Windows.AI.Search.Experimental.AppContentIndex in Microsoft.Windows.Search.AppContentIndex

• Fehler „Klasse nicht registriert“ wurden behoben, die beim Verwenden der eigenständigen Bereitstellung mit Windows ML auftraten. Entwickler, die eine eigenständige Bereitstellung verwenden, müssen nicht mehr alle aktivierbaren Klassen des Foundation-Pakets registrieren, die intern verwendet wurden.
• Es wurde ein potenzieller Absturz beim Herunterfahren von Prozessen behoben, wenn Windows ML verwendet wurde.
• ImageForegroundExtractor Der API-Routingpfad wurde behoben, sodass Aufrufe den richtigen Endpunkt erreichen.
• Sichergestellt, dass der Installations- und Downloadstatus des Ausführungsanbieters während der Paketbereitstellung ordnungsgemäß an Apps weitergeleitet wird.
• Ein Absturz in SystemBackdrop wurde behoben, der auftritt, wenn das Ziel getrennt wird, indem ungültige Verbindungsabbruchpfade geschützt werden.
• Es wurde ein Problem behoben, durch das verhindert wurde, dass Windows AI-APIs für einige Anwendungen verfügbar sind.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0.0-experimental3:

Microsoft.UI.Content

    ChildSiteLink
        IsHitTestVisible

Microsoft.UI.Xaml.Controls

    FlowLayout
        LineSpacing
        LineSpacingProperty
        MinItemSpacing
        MinItemSpacingProperty

    SystemBackdropElement
    WrapPanel
        ItemSpacing
        ItemSpacingProperty
        ItemsStretch
        ItemsStretchProperty
        LineSpacing
        LineSpacingProperty

    WrapPanelItemsStretch

Microsoft.UI.Xaml.Markup

    IXamlPredicate

Microsoft.Windows.AI.Video

    VideoScaler
        Dispose

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

• Eine ONNX-Runtime-Regression bewirkt, dass die Video-Superauflösung auf Qualcomm-Geräten fehlschlägt. Ein ausstehendes Update des Qualcomm NPU-Ausführungsanbieters behebt dieses Problem.

Das neue experimentelle SplitMenuFlyoutItem-Steuerelement wurde entwickelt, um eine geteilte Schaltfläche in einem Menü-Flyout bereitzustellen. Mit diesem Steuerelement können Entwickler eine primäre Standardaktion verfügbar machen und gleichzeitig zusätzliche Optionen über ein Untermenü anbieten, ideal für die Verdichtung komplexer Funktionen in einen kleineren Speicherbedarf und zum Speichern der Gesamtmenülänge.

Zusammen mit den Funktionen von MenuFlyoutItem und MenuFlyoutSubItem verfügt das Steuerelement über zwei andere Eigenschaften: SubMenuPresenterStyle und SubMenuItemStyleermöglicht die Anpassung des Untermenüs, z. B. die Verwendung von GridView für den Untermenüreferent.

    <Button Content="Open file">
        <Button.Flyout>
            <MenuFlyout>
                <SplitMenuFlyoutItem Text="Open with Notepad">
                    <MenuFlyoutItem Text="Visual Studio" />
                    <MenuFlyoutItem Text="VS Code" />
                    <MenuFlyoutItem Text="Word" />
                </SplitMenuFlyoutItem>
            </MenuFlyout>
        </Button.Flyout>
    </Button>

Umbenannte Typen

• Umbenannt WinMLCatalogModel in ModelCatalog
• Umbenannt CatalogModelSource in ModelCatalogSource

Methodenaktualisierungen

• CatalogModelInfo: Umbenannt GetInstance in GetInstanceAsync
• ModelCatalogSource: Umbenannt CreateFromUri in CreateFromUriAsync
• ModelCatalog: Umbenannt FindModel in FindModelAsync
• ModelCatalog: Umbenannt FindAllModels in FindAllModelsAsync

Eigenschaftsänderungen

• Aktualisiert CatalogModelInfo.Size auf CatalogModelInfo.ModelSizeInBytes

Verhaltensupdates

• Instanz aus CatalogModelInstanceResult abrufen mit .GetInstance()
• CatalogModelStatus gibt "Bereit" oder "NichtBereit" basierend auf der lokalen Verfügbarkeit zurück.
• Hinzugefügt CatalogModelInstanceStatus , um den Instanzstatus vom Modellstatus zu trennen

CatalogModelInfo-Verbesserungen

• Umbenannt Alias in Name
• Umbenannt Revision in Version
• Publisher hinzugefügt
• DisplayName entfernt

JSON-Änderungen

• alias wurde in id umbenannt.
• Entfernt modelType und description.
• executionProvider wurde in executionProviders umbenannt.
• Aktualisiert executionProviders , um ein Array von JSON-Objekten anstelle einer durch Trennzeichen getrennten Liste zu sein.

Weitere Änderungen

• ModelCatalog gibt jetzt eine Liste der Ausführungsanbieter (EPs) zurück, wenn eine Instanz erstellt wird.
• Unterstützung für Windows 10 (1809) und höher hinzugefügt.
• Unterstützung für lokale Dateien hinzugefügt, einschließlich regulärer Dateien und MSIX-Pakete.
• Abstürze, die durch einen ungültigen JSON-Katalog verursacht wurden, wurden behoben.

• Der vorherige AppIndexQuery-Typ, der die GetNextTextMatches und GetNextImageMatches-Methoden enthielt, wurde in zwei verschiedene Typen aufgeteilt: AppIndexTextQuery und AppIndexImageQuery. Die AppContentIndexer.CreateQuery Methode wurde ersetzt durch: CreateTextQuery und CreateImageQuery.

• Diese Methoden geben nun AppIndexTextQuery bzw. AppIndexImageQuery zurück. Um die Verwendung zu vereinfachen, wurden auch die Optionentypen aktualisiert:

  • Entfernt: AppIndexQueryOptions, TextMatchOptions und ImageMatchOptions
  • Hinzugefügt: TextQueryOptions und ImageQueryOptions

• Die APIs im AppContentIndex-Namespace, die zuvor Arrays zurückgegeben haben, geben jetzt IVectorView für eine verbesserte Konsistenz und Leistung zurück.

• Die AppContentIndexer.WaitForIndexingIdleAsync Methode wurde aktualisiert, um einen TimeSpan Parameter anstelle einer ganzen Zahl zu akzeptieren, wodurch eine klarere und flexiblere Timeoutbehandlung bereitgestellt wird.

Die VideoScaler API bietet eine Verbesserung von Echtzeitvideos durch erweitertes KI-Upscaling, das für Streams optimiert ist, die Personen in Unterhaltungen zeigen. Es ermöglicht Entwicklern, schärfere, klarere visuelle Elemente über Konferenz-, Streaming- und Bearbeitungsplattformen hinweg bereitzustellen, auch unter schlechten Netzwerkbedingungen. Die API unterstützt die Anpassung von Ausgabeauflösung, Bildfrequenz und interessanten Regionen mit Kompatibilität für mehrere Videoformate, einschließlich BGR, RGB und NV12.

Mit der neuen RewriteCustomAsync-API können Sie eine Eingabezeichenfolge bereitstellen, die Phi Silica beim Umschreiben von ausgewähltem Text leitet. Sie können mit neuen kreativen Stilen wie "Goofy" oder "Pirate" experimentieren, um Ihre Inhalte sofort zu transformieren.

Die ImageGenerator Klasse nutzt stabile Diffusionsmodelle, um leistungsstarke Bildgenerierungsfunktionen bereitzustellen. Es unterstützt Szenarien mit mehreren Generationen:

• Text-zu-Bild: Generieren Sie Bilder aus beschreibenden Textaufforderungen.

• Bild-zu-Bild: Transformieren Sie vorhandene Bilder basierend auf Textbeschreibungen.

• Magische Füllung: Füllen Sie maskierte Bereiche von Bildern mit KI-generierten Inhalten.

• Farbbuchformat: Generieren Sie Bilder im Farbbuchstil.

• Neu entwerfen: Ändern Sie den künstlerischen Stil vorhandener Bilder, während Sie die Struktur beibehalten.

Alle generierten Bilder werden im RGB8-Format über ImageBuffer-Objekte zurückgegeben. Die API enthält integrierte Inhaltssicherheitsfilter und unterstützt anpassbare Generierungsparameter.

using Microsoft.Windows.AI.Imaging;
using Microsoft.Graphics.Imaging;
 
public async Task GenerateImageFromText()
{
    var readyState = ImageGenerator.GetReadyState();
    if (readyState != AIFeatureReadyState.Ready)
    {
        var progress = new Progress<double>(p => Console.WriteLine($"Download progress: {p:P}"));
        var result = await ImageGenerator.EnsureReadyAsync();
        if (result.Status != AIFeatureReadyResultState.Success)
        {
            Console.WriteLine("Failed to prepare models");
            return;
        }
    }
 
    using var generator = await ImageGenerator.CreateAsync();
 
    var options = new ImageGenerationOptions
    {
        MaxInferenceSteps = 6,
        Creativity = 0.8,
        Seed = 42
    };
 
    var result = generator.GenerateImageFromTextPrompt("A beautiful sunset over a mountain lake", options);
 
    if (result.Status == ImageGeneratorResultStatus.Success)
    {
        await SaveImageBufferAsync(result.Image, "generated_image.png");
    }
}

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0-experimental2:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem

Microsoft.Windows.AI.Imaging

    ImageFromImageGenerationOptions
    ImageFromImageGenerationStyle
    ImageFromTextGenerationOptions
    ImageFromTextGenerationStyle
    ImageGenerationOptions
    ImageGenerator
    ImageGeneratorContract
    ImageGeneratorResult
    ImageGeneratorResultStatus
    TextRecognizer
        RecognizeTextFromImage
        RecognizeTextFromImageAsync

    TextRecognizerOptions

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexer
        CreateImageQuery
        CreateTextQuery
        WaitForIndexingIdleAsync

    AppIndexImageQuery
    AppIndexTextQuery
    ImageQueryOptions
    TextQueryOptions

Microsoft.Windows.AI.Text

    TextRewriter
        RewriteCustomAsync

Microsoft.Windows.AI.Video

    ScaleFrameStatus
    VideoScaler
    VideoScalerOptions
    VideoScalerResult

• Korrektur der Berechnung des Begrenzungsrahmens bei gedrehtem Text. Unter bestimmten Umständen meldete der OCR-Textabgleich innerhalb von Bildern ungenaue oder leere Bereiche, wenn der Text gedreht wurde.

Die AppContentIndexer-APIs ermöglichen Entwicklern die effiziente Indizierung von App-Inhalten, einschließlich Text und Bildern für einen schnellen und relevanten Abruf. Diese APIs unterstützen sowohl lexikalische (schlüsselwortbasierte) als auch semantische (bedeutungsbasierte) Suchanfragen und ermöglichen Apps, schnelle und relevante Ergebnisse basierend auf Benutzerabsicht und Kontext zu liefern, anstatt nur auf genaue Schlüsselwörter.

Diese Funktion entsperrt die folgenden erweiterten Szenarien:

• Semantische Suche
  Apps können Ergebnisse basierend auf Absicht und Bedeutung und nicht auf exakten Schlüsselwortabgleichen zurückgeben.
  Beispiel: Eine Abfrage für "Projektzeitachse" kann Inhalte anzeigen, die "Terminplan" oder "Liefertermine" erwähnen, auch wenn diese genauen Wörter nicht verwendet wurden.
• Retrieval-Augmented Generation (RAG)
  Indizierte Inhalte können als Wissensbasis für generative KI-Modelle dienen. Wenn ein Benutzer eine Frage stellt, ruft die App die relevantesten Dokumente oder Codeausschnitte aus seinem Index ab und leitet sie in das Modell ein, wodurch präzise, kontextbezogene Antworten ermöglicht werden, die in realen Daten geerdet sind.

Die Windows ML-Modellkatalog-APIs ermöglichen Es Ihrer App oder Bibliothek, große KI-Modelldateien aus Ihren eigenen Onlinemodellkatalogen dynamisch zu ermitteln und herunterzuladen, sodass diese großen Dateien nicht direkt mit Ihrer App oder Bibliothek verpackt werden müssen. Der Modellkatalog trägt dazu bei, die Gerätekompatibilität zu gewährleisten, indem Modelle gefiltert werden, und nur jene heruntergeladen werden, die für das spezifische Windows-Gerät geeignet sind.

Das neueste Microsoft.Windows.Storage.Pickers Update optimiert die Datei- und Ordnerauswahl, indem Entwickler initiale und persistente Ordnerspeicherorte festlegen und Dateitypfilter mit klaren Bezeichnungen gruppieren, um die Navigation zu vereinfachen.

Die PopupAnchor API ermöglicht DesktopPopupSiteBridge jetzt die relative Positionierung durch Verankerung an das eigene Fenster oder die Insel, wobei die Einschränkung behoben wird, dass Popups nur absolut mithilfe von Bildschirmkoordinaten positioniert werden konnten.

Mit der InputUnderlyingWindowController API können Entwickler den Ziel-HWND für den Empfang von Eingabemeldungen festlegen, die ursprünglich an ein ContentIsland gesendet wurden, das von einem SystemVisual erstellt wurde (siehe ContentIsland.CreateForSystemVisual).

SystemBackdropHost ermöglicht das Platzieren eines Systemhintergrunds (Acryl/Glimmer) an einer beliebigen Stelle innerhalb der visuellen Struktur einer Anwendung.

Das WrapPanel ist ein WinUI-XAML-Layoutpanel, das untergeordnete Elemente in einer sequentiellen Reihenfolge von links nach rechts anordnet. Elemente, die die Zeile überlaufen, werden am Ende des Panels automatisch in die nächste Zeile umgebrochen. Es ist nützlich für reaktionsfähige Layouts.

Dies ist ein Port des bestehenden Windows Community Toolkit-Steuerelements.

Diese Version enthält die folgenden neuen und modifizierten experimentellen APIs im Vergleich zu 2.0-experimental1:

Microsoft.UI.Content

    PopupAnchor

Microsoft.UI.Input

    InputUnderlyingWindowController

Microsoft.UI.Xaml.Controls

    StretchChild
    SystemBackdropHost
    WrapPanel

Microsoft.Windows.AI.Imaging

    ImageForegroundExtractor
    ImageForegroundExtractorContract

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexQuery
    AppIndexQueryMatch
    AppIndexQueryOptions
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemReader
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageMatchOptions
    ImageQueryMatch
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextMatchOptions
    TextQueryMatch

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
    LanguageModelExperimentalContract
    LanguageModelOptionsExperimental
    LowRankAdaptation

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        SuggestedFolder
        SuggestedStartFolder

    FileSavePicker
        SuggestedStartFolder

    FolderPicker
        SuggestedFolder
        SuggestedStartFolder

• AppContentIndexer APIs sollten aus einem Hintergrundthread aufgerufen werden. Die Nutzung im UI-Thread kann zu einem Einfrieren oder langen Pausen führen, die das Benutzererlebnis beeinträchtigen.
• Abfrageergebnisse mit AppIndexQuery.GetNextTextMatches und AppIndexQuery.GetNextImageMatches sind null, wenn keine Übereinstimmungen vorliegen, anstatt eine leere Liste zurückzugeben.
• Bildübereinstimmungen mithilfe von AppManagedImageQueryMatch.Subregion basierend auf OCR-Werten können gelegentlich ungenau sein, insbesondere wenn der Text gedreht oder verzerrt ist.
• Bildabgleiche mit AppManagedImageQueryMatch.Subregion können manchmal Rechtecke von null Größe oder extrem kleine Rechtecke enthalten, was zu ungenauen Ergebnissen führt.
• Ein Leerabfrage von AppContentIndex.CreateQuery kann eine Ausnahme auslösen.

Mit den Windows ML Modellkatalog-APIs können Ihre App oder Bibliothek große KI-Modelldateien dynamisch aus Ihren eigenen Onlinemodellkatalogen herunterladen, ohne diese großen Dateien direkt mit Ihrer App oder Bibliothek zu versenden. Darüber hinaus hilft der Modellkatalog beim Filtern, welche Modelle mit dem Windows Gerät kompatibel sind, auf dem es ausgeführt wird, sodass das richtige Modell auf das Gerät heruntergeladen wird.

Wichtige Vorteile:

• Kataloge hinzufügen: Hinzufügen eines oder mehrerer Onlinekataloge
• Ermitteln kompatibler Modelle: Automatische Suche nach Modellen, die mit den Hardware- und Ausführungsanbietern des Benutzers funktionieren
• Herunterladen von Modellen: Herunterladen und Speichern von Modellen aus verschiedenen Quellen
• Freigeben von Modellen in allen Apps: Wenn mehrere Anwendungen dieselbe Katalogquelle verwenden, werden die Modelle auf dem Datenträger freigegeben, ohne Downloads zu duplizieren

• Es wurde ein Problem in DeploymentManager behoben, das dazu führte, dass PackageInstallRequired in einigen Fällen fälschlicherweise gemeldet wurde.

Diese Version enthält die folgenden neuen und geänderten experimentellen APIs:

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ChildSiteLink
        IsBelowContent

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    InputPopupController
    LightDismissReason
    PopupPointerMode
    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InfoBar
        Opened

    InfoBarOpenedEventArgs
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TeachingTip
        Opened

    TeachingTipOpenedEventArgs
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelSource
    CatalogModelStatus
    WinMLModelCatalog

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel