releaseopmerkingen voor Windows App SDK 2.0

U kunt kiezen tussen de stabiele, preview- en experimentele kanalen, afhankelijk van uw ontwikkelingsbehoeften, van betrouwbare productieversies tot vroege toegang tot toekomstige functies. Meer informatie over releasekanalen.

Zie Downloads voor de Windows App SDK voor de bijgewerkte runtime en MSIX.

Versie 2.5.1

Uitgebracht: 16 september 2026

ondersteuning voor Windows foutrapportage

Er is ondersteuning toegevoegd voor de windows.diagnosticServiceModule pakketmanifestextensie. Zelfstandige .NET MSIX-apps kunnen deze extensie gebruiken om diagnostische modules te declareren, zodat Windows Foutrapportage ze kan laden en actie-bare crashdumps kan verzamelen.

AppContentSearch-API's met beperkte toegang

Nieuwe AppContentIndex API's zijn nu beschikbaar als een functie voor beperkte toegang (LAF) voor apps die een LAF-token hebben verkregen. Met deze API's kunnen apps tekst- en afbeeldingsinhoud bieden voor het indexeren en opvragen van die inhoud met lexicale overeenkomsten en, op ondersteunde apparaten met NPU's, semantische overeenkomsten. AppContentIndex ondersteunt scenario's voor semantisch zoeken en retrieval-augmented generation (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

Bugfixes
  • Er is een crash opgelost in de invoerafhandeling van pop-upvensters wanneer een focus- of aanwijzergebeurtenis werd verwerkt nadat het eiland van de pop-up was verwijderd. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
  • Een crash in NavigationView verholpen waarbij het wijzigen van het formaat van het besturingselement een negatief deelvenster MaxHeight kon opleveren. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
  • Er is een probleem opgelost waarbij de eigenschappenset die door ElementCompositionPreview.GetPointerPositionPropertySet wordt geretourneerd, niet meer werd bijgewerkt terwijl de aanwijzer ingedrukt werd gehouden. (RuntimeCompatibilityChange: PointerPositionPropertySet_UpdateWhilePressed)
  • Een crash in NavigationView verholpen die optrad wanneer de flyout van een uitgevouwen item werd weergegeven nadat het item was samengevouwen of gerecycled. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
  • Er is een fail-fast opgelost die optrad wanneer een KeyboardAccelerator een OEM- of leestekentoets gebruikte, zoals een komma, puntkomma of haakje, en het label van de acceleratorsneltoets weergaf. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
  • Er is een onherstelbare procesafsluiting opgelost die kon optreden tijdens het afsluiten van XAML in apps die WinUI 3 hosten op meer dan één UI-thread. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
  • Er is een probleem opgelost waarbij een CommandBar zonder secundaire opdrachten een lege overloopknop kon weergeven bij fractionele beeldschalen, zoals 175%. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
  • Er is een probleem opgelost waardoor apps die de System Composition Engine gebruiken VisualInteractionSource.CreateFromIVisualElement niet konden aanroepen. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Problemen met effectgrafieken en SceneLighting rendering opgelost voor apps die gebruikmaken van de System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Probleem opgelost waarbij InputPointerSource.ActivationBehavior geen rekening hield met NoActivate bij het gebruik van de System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Het selectiegedrag voor null-invoer en no-op selecties is opgelost CompositionEngine . (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Probleem met cursoraanpassing voor lifted input opgelost bij gebruik van de System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Er zijn ICompositionObject query's opgelost voor verzamelingen met kleurovergangsstop bij gebruik van de systeemsamenstellingsengine. (RuntimeCompatibilityChange: N/A, oplossing voor de samenstelling van het besturingssysteem)
  • Vaste ContentExternalOutputLink rand- en achtergrondgedrag bij het gebruik van de systeemsamenstellingsengine. (RuntimeCompatibilityChange: N/A, oplossing voor de samenstelling van het besturingssysteem)
  • Toegang tot VisualReferenceController is hersteld bij gebruik van de engine voor systeemsamenstelling. (RuntimeCompatibilityChange: N/A, oplossing voor de samenstelling van het besturingssysteem)
  • Er is een registratieprobleem opgelost dat zich kon voordoen bij het installeren van de Windows App SDK. (RuntimeCompatibilityChange: N/A, oplossing voor implementatieregistratie)
  • Er is een probleem opgelost waarbij Video Super Resolution kon mislukken tijdens de initialisatie of deductie met de bijgewerkte ONNX Runtime-afhankelijkheid. (RuntimeCompatibilityChange: N/A, compatibiliteitsupdate voor afhankelijkheden)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's vergeleken met de release 2.4.0:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

Versie 2.4.0

Uitgebracht: 13 augustus 2026

Uitgebreide ondersteuning voor invoer

WinUI 3-apps ondersteunen nu haptische feedback voor touchpad en muis van het besturingssysteem via Windows.Devices.Haptics, evenals pannen met één vinger op het touchpad, indien ondersteund door het besturingssysteem en de hardware. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

Bugfixes
  • Een crash verholpen die kon optreden wanneer een aanraak- of pencontact een scrollbaar gebied op een precies moment verliet. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
  • Er is een probleem opgelost waarbij de opslagkiezers (FileOpenPicker, FileSavePicker en FolderPicker) het aanroepende WinUI-appvenster zonder toetsenbordfocus achterlieten nadat het bestandsdialoogvenster was gesloten. De app herstelt nu de vorige focus nadat het dialoogvenster is gesloten. Zie GitHub probleem #6505 voor meer informatie. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
  • Er is een regressie opgelost waarbij MrmGetFilePathFromNameERROR_FILE_NOT_FOUND retourneerde wanneer het PRI-bestand niet bestond, in plaats van het gedocumenteerde terugvalpad te retourneren. Zie GitHub probleem #5940 voor meer informatie. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
  • Er is een probleem opgelost waarbij MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY kon worden overgenomen door onderliggende processen, waardoor MRT Core en cataloguszoekopdrachten werden verstoord. Zie GitHub probleem #5987 voor meer informatie. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
  • Er is een probleem opgelost waarbij LanguageModel een algemene Error status werd geretourneerd voor niet-ondersteunde talen of niet-overeenkomende invoer- en uitvoertalen. Deze voorwaarden retourneren nu LanguageModelResponseStatus.UnsupportedLanguage en LanguageModelResponseStatus.LanguageMismatch, respectievelijk. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
  • Er is een crash opgelost bij apps die gebruikmaken van de systeemsamenstellingsengine VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, oplossing voor de samenstellingsbrug van het besturingssysteem)
  • De toegangsspecificatie van de gegenereerde C#-entrypointhulp is gecorrigeerd wanneer DISABLE_XAML_GENERATED_MAIN is gedefinieerd. Zie GitHub probleem #11245 voor meer informatie. (RuntimeCompatibilityChange: N/A, aanpassing van build-time tooling)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de release 2.3.1:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Versie 2.3.1

Uitgebracht: 16 juli 2026

Gestructureerde JSON-uitvoer-API

De Structured JSON Output-API (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync) toegevoegd, waarmee reacties van het taalmodel worden gegenereerd die worden beperkt door een door de aanroeper opgegeven JSON-schema. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

XamlOptionalChanges-API

De XamlOptionalChanges-API toegevoegd, waarmee apps kunnen kiezen voor optionele wijzigingen die fouten veroorzaken vóór de initialisatie van XAML. Zie GitHub PR microsoft/microsoft-ui-xaml#11110 voor meer informatie. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Het gedrag van de DISABLE_XAML_GENERATED_MAIN preprocessor-constante is gewijzigd, zodat deze, wanneer gedefinieerd, de gegenereerde main()-methode nu hernoemt (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) in plaats van deze volledig te verwijderen. Hiermee kan een aangepaste main() methode de standaard implementatie aanroepen.

CompositionEngine-API

De CompositionEngine-API is toegevoegd als een instabiele functie met beperkte toegang (LAF), waarmee apps ervoor kunnen kiezen het besturingssysteem te gebruiken als engine voor de Composition-API's. (RuntimeCompatibilityChange: CompositionEngine_API)

Verbeteringen in Video Super Resolution

Er is een probleem opgelost met NPU-detectie, extra CPU-ondersteuning en verbeterde prestaties voor Video Super Resolution. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

Windows ML
  • Opsomming van uitvoeringsprovider in bepaalde scenario's opgelost. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
  • Er is ARM64EC ondersteuning toegevoegd voor Windows ML.
Documentatie voor AI-pakketten

IntelliSense-documentatie toegevoegd voor stabiele API's in het Microsoft.WindowsAppSDK.AI NuGet-pakket.

Prestatieverbeteringen

Verschillende van de onderstaande optimalisaties zijn opt-in. Als u deze wilt inschakelen, stelt u de opgegeven XamlChangeId in zoals vermeld in elk item.

  • Nieuwe geoptimaliseerde XamlControlsResources stijlen toegevoegd, inclusief een geoptimaliseerde ScrollBar sjabloon. Gebruik de DefaultStyleOptimizations XamlChangeId om u aan te geven voor deze stijlen. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
  • FontIcon en BitmapIcon vermijd het invoegen van een extra Grid in hun visuele structuur voor apps die zich aanmelden met de IconNoGridOptimization XamlChangeId. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
  • Gestopt met het laden van Style eigenschapssetters die geen waarde toepassen. Gebruik de OptimizeApplyStyles XamlChangeId om deel te nemen. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
  • Vertraagd toepassen FrameworkElement en Control stijlen totdat het element zich in de structuur bevindt. Gebruik de OptimizeApplyStyles XamlChangeId om deel te nemen. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
  • Initialisatie van CommandBar geoptimaliseerd door niet langer de volledige status van de Visual State Manager te laden. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
  • Verbeterde prestaties bij het toevoegen aan CommandBarFlyout's PrimaryCommands en SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
  • Gebruikt een meer presterende hash-tabel voor ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
  • Het kopiëren en vergelijken van een tekenreeks met een resourcesleutel bij het laden van uitgestelde resources is geoptimaliseerd en daardoor niet langer nodig. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
  • Verbeterde prestaties van ThemeResource opzoekacties door tekenreeksvergelijkingen te verminderen. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
  • Verbeterde CPU-prestaties tijdens het opzoeken van XAML-themaresources door de hash-overhead van resourcesleutels te verminderen. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
  • Verbeterde CPU-prestaties voor veelvoorkomende interne XAML-typecontroles op UIElement en FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
  • Verbeterde CPU-prestaties in interne opzoekroutes van de activeringsfactory. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
  • Verbeterde prestaties van het decoderen van gehele getallen die zijn opgeslagen in XBF-bestanden. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
  • Verminderde heap-toewijzingen op opstartpaden en bij boomtraversal door geheugen voor vectoren te reserveren en een RAII-helper te optimaliseren. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
  • Verbeterde prestaties door ruimte te reserveren in trackerverzamelingen voordat u meerdere items toevoegt. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
  • Geoptimaliseerde bindingen voor XamlUICommand eigenschapsbindingen. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
  • Verbeterde prestaties bij bindingen XamlUICommanddie geen toetsenbordversnellers definiëren. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
  • Initialiseerde de TintLuminosityOpacity eigenschap in markeringen voor standaardobjecten AcrylicBrush in plaats van in code, waardoor geforceerde realisatie wordt vermeden. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
  • Vermijd onnodige standaard ContextFlyout initialisatie op TextBlock en RichTextBlock bij het invoeren of verlaten van de elementstructuur. Gebruik de DeferContextFlyoutInit XamlChangeId om deel te nemen. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
  • Verminderde opstartwachttijden bij vergrendelingsconflicten in Direct3D door XAML's D3D-gebeurtenis voor apparaatverwijdering te registreren tijdens het op de achtergrond aanmaken van het apparaat, in plaats van later op de UI-thread. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
  • Er is een redundante registratie voor voedingsmeldingen uit RefreshRateInfo verwijderd, wat de opstartoverhead vermindert. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
  • Er is een redundante version.dll afhankelijkheid verwijderd uit het WinUI-opstartpad door de vastgelegde runtimeversie tijdens het compileren te berekenen. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)
Bugfixes
  • Een use-after-free-crash in CPopupRoot::ReplayPointerUpdate is opgelost wanneer een pop-up synchroon gesloten wordt tijdens het opnieuw afspelen van pointer-events. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
  • Er is een toegangsfout in CXamlIslandRoot::GetScreenOffset opgelost die werd veroorzaakt door re-entrante UI Automation-query’s tijdens het afbreken van het XAML-eiland. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
  • Er is een crash in ModernCollectionBasePanel verholpen waarbij een door de viewport bijgehouden container of header die door een sibling-layoutpass werd gerecycled, een verouderd anker kon achterlaten dat bij de volgende meting een fail-fast veroorzaakte. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
  • Een fail-fast in CPopup::RemoveChild verholpen wanneer een ToolTip-sluiting berichten verwerkte en het sluitpad opnieuw binnenging. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
  • Er is een reentrancy-crash opgelost CXcpDispatcher toen een Popup destructor werd geactiveerd UIADisconnectAllProviders met actieve UI Automation-clients. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
  • Een crash verholpen wanneer een cascademenu of de timer voor vertraagd openen van AutoSuggestBox werd geactiveerd nadat de afbouw van het bijbehorende island of de dispatcher al was begonnen. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
  • Een mogelijke crash door use-after-free tijdens het ontladen van een DLL is opgelost wanneer COM-pointers in aangepaste metadatatypen niet correct werden vrijgegeven. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
  • Er is een crash verholpen bij het openen van een Popup vanuit een CompositionTarget.Rendering-callbackfunctie door re-entrantie van de dispatcher tijdens focuswijzigingen. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
  • Een crash in MediaPlayerPresenter verholpen wanneer het GPU-apparaat uitvalt tijdens het verwerken van gebeurtenissen bij het afspelen van media. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
  • Een mogelijke toegangsschending in de Direct2D-tekstweergave is verholpen wanneer herstel na apparaatverlies optrad tijdens het opbouwen van glyph-run-texturen. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
  • Een crash verholpen in CFocusRectManager::FindFocusRectHost wanneer de focus terechtkomt op een inline gehoste besturing via InlineUIContainer in RichTextBlock of TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
  • Een crash opgelost die backgroundTaskHost.exe herhaaldelijk kon laten crashen wanneer een achtergrondtaak geen opgeslagen CLSID had, en correcte afhandeling toegevoegd voor wanneer CoCreateInstance mislukt. Zie GitHub probleem #5870 voor meer informatie. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
  • Een probleem opgelost waarbij fly-outs met en zonder venster verkeerd werden uitgelijnd (ongeveer één itemhoogte boven het bovenliggende item) bij plaatsing aan de zijkant, wanneer ze omhoog werden geopend nabij de onderkant van het scherm. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
  • Er is een crash opgelost (null-verwijzing LayoutState) in UniformGridLayout en FlowLayout die kon optreden wanneer een verzamelingswijziging werd geactiveerd op een ItemsRepeater dat niet langer was geladen. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
  • Probleem opgelost met het openen van een registersleutel op het verkeerde pad (ApplicationData.GetForUnpackaged().LocalSettings() in plaats van HKCU\SOFTWARE\publisher\product), wat een roaminglocatie is in plaats van een lokale locatie op de machine. Zie GitHub probleem #6559 voor meer informatie. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
  • Er is een raceconditie opgelost in de afhandeling van de status van modificatietoetsen, waardoor apps konden crashen bij gelijktijdige invoer op de UI-thread. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
  • Een crash van AppxSvc die kan optreden tijdens het installeren, bijwerken of verwijderen van een pakket, is opgelost. (RuntimeCompatibilityChange: N/A, crashoplossing voor servicehost)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's vergeleken met de release 2.2.0:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType
Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges
Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Versie 2.2.0

Uitgebracht: 9 juni 2026

Video Super Resolution AI API

De Microsoft.Windows.AI.Video.VideoScaler API biedt realtime videoverbetering via geavanceerde AI-upscaling, geoptimaliseerd voor streams met mensen in gesprek. Hiermee kunnen ontwikkelaars scherpere, duidelijkere visuals bieden voor vergader-, streaming- en bewerkingsplatformen, zelfs onder slechte netwerkomstandigheden. De API ondersteunt aanpassing van uitvoerresolutie, framesnelheid en interessegebieden, met compatibiliteit voor meerdere video-indelingen, waaronder BGR, RGB en NV12.

VideoScaler is wegwerpbaar en bevat een mogelijkheidscontrole zodat apps vsR-ondersteuning tijdens runtime kunnen valideren. Expliciete Windows ML-initialisatie is niet vereist.

Nieuwe ApplicationData-API voor uitgepakte apps

Een nieuwe Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged()-API biedt uitgepakte apps een eersteklas WinRT-ingangspunt voor toepassingsgegevens per gebruiker/per machine, die overeenkomen met het oppervlak dat eerder alleen beschikbaar was voor verpakte apps. Dit vereenvoudigt toekomstige migratie tussen verpakte en onverpakte apps en maakt tijdelijke oplossingen via de Registry-API overbodig.

Nieuwe XamlBindingHelper-API's

Er zijn overbelastingen voor het instellen van waarden zonder boxing toegevoegd aan XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) en de afhankelijkheidseigenschap Setter.ValueProperty beschikbaar gemaakt.

Bugfixes
  • Een crash in RenderTargetBitmap is opgelost wanneer het doelelement de visuele structuur verlaat (bijvoorbeeld wanneer een pop-up wordt gesloten) voordat PreCommit is voltooid. RenderAsync geeft nu E_ABORT terug in plaats van te crashen. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
  • Een use-after-free-crash in ScrollView is opgelost wanneer het besturingselement werd vernietigd terwijl de tick van de timer voor het verbergen van indicatoren nog in behandeling was. Zie GitHub probleem #10514 voor meer informatie. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
  • Er is een mogelijke crash opgelost in Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate veroorzaakt door een poging om toegang te krijgen tot een object dat is gepland om te worden vrijgemaakt. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
  • Er is een probleem opgelost waarbij Microsoft.UI.System.ThemeSettings een app kon laten crashen als deze werd vernietigd vanuit een achtergrondthread (bijvoorbeeld wanneer dit gebeurde door de .NET garbage collector). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
  • Er is een crash verholpen die op bepaalde apparaten kon optreden wanneer actieve aanraakpunten door de invoerhardware werden beëindigd, bijvoorbeeld wanneer peninvoer deze overneemt. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
  • Er is een probleem opgelost waarbij sparse-verpakte apps geen modulespecifieke PRI-bestanden konden detecteren. Zie GitHub probleem #6375 voor meer informatie. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
  • Er is een bug met betrekking tot het eigenaarschap van tekenreeksen opgelost bij het gebruik van de Flat-C Windows ML Catalog-API. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
  • Er is een mogelijk probleem opgelost in Windows ML tijdens het afsluiten van het proces. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
  • Mogelijke com-initialisatie- en teardownproblemen in Windows ML opgelost. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's vergeleken met de versie 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

Versie 2.1.3

Uitgebracht: 21 mei 2026

Aangepaste sleepgebieden voor titelbalkinhoud

Verbetert hoe TitleBar bepaalt welke delen van TitleBar.Content versleepbaar zijn, en voegt API's toe die ontwikkelaars expliciete controle geven over sleepgebieden. Zie PR microsoft/microsoft-ui-xaml#10936 en traceringsprobleem #10421.

Wat is er veranderd?

  • Nieuw standaardgedrag — Het framework doorloopt nu recursief de visuele boomstructuur en sluit automatisch alleen interactieve bedieningselementen uit van de sleepregio. Lege ruimtes en niet-interactieve visuele elementen zijn standaard versleepbaar, zonder dat er wijzigingen in de opmaak nodig zijn.
  • Nieuwe API's voor expliciet beheer:
    • TitleBar.IsDragRegion — een gekoppelde nullable bool om een element te markeren als sleepbaar (True), klikbaar (False) of door het framework bepaald (niet ingesteld).
    • TitleBar.AutoRefreshDragRegions — wanneer True, worden sleepgebieden automatisch vernieuwd bij layoutupdates.
    • TitleBar.RecomputeDragRegions() — berekent sleepgebieden handmatig opnieuw na dynamische inhoudswijzigingen.

Waarom

Aangepaste titelbalken combineren vaak interactieve besturingselementen met niet-interactieve visuals in Grid/StackPanel indelingen. De vorige benadering, waarbij gaten uit het volledige inhoudsgebied werden gesneden, liet in lay-outs met lege ruimte, ongelijke tussenruimten of een dynamische UI onverwachte niet-sleepbare gaten achter.

Visuele vergelijking

Standaardgedrag (eerder) — niet-versleepbare tussenruimten:

Standaardgedrag — niet-versleepbare tussenruimtes

Het lege middelste gebied kan niet worden gesleept.

Huidig (nieuw) gedrag: hiaten die kunnen worden gesleept, interactieve besturingselementen uitgesloten:

Huidig gedrag — vaste sleepgebieden

De lege ruimte kan worden gesleept; interactieve besturingselementen worden correct uitgesloten. (RuntimeCompatibilityChange: TitleBar_ContentDragRegions)

LoRA API gepromoveerd naar stabiel

De Low-Rank Adapter (LoRA) API voor Phi Silicium is gepromoveerd tot stabiel.

Met LoRA kunnen ontwikkelaars het on-device Phi Silicium-taalmodel verfijnen met hun eigen aangepaste gegevens, waarbij de uitvoer wordt afgestemd op specifieke scenario's zoals financiën, medische en onderwijs. Laad een adapter met LanguageModelLowRankAdapter.CreateFromPath en geef deze via LanguageModelOptions.LowRankAdapter door bij het aanroepen van GenerateResponseAsync. Zie PhiSilium LoRA voor meer informatie.

Nieuwe AICapabilities-API

Met een nieuwe AICapabilities.HasAICapability-API kunnen toepassingen van derden bepalen of het apparaat een Copilot+ PC is.

ONNX Runtime bijgewerkt

De versie van ONNX Runtime is bijgewerkt naar 1.24.6. Zie ONNX Runtime-versies voor meer informatie.

Windows ML
  • Er is ondersteuning toegevoegd voor meerdere uitvoeringsproviders binnen één MSIX-pakket. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
  • Er is ondersteuning toegevoegd voor het detecteren van uitvoeringsproviders die als frameworkpakketten worden geleverd. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
  • De selectiemodus van de uitvoeringsprovider is toegevoegd voor flexibele implementatieconfiguraties. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)
Bugfixes
  • Er is een geheugenlek in ItemsRepeater opgelost waarbij gerecyclede elementen nooit door de garbage collector werden opgeruimd door een referentiecyclus via de RecyclePool, wat ook crashes in InvalidateChildrenMeasure kon veroorzaken. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
  • Er is een crash opgelost waarbij een impliciete callback voor het weergeven/verbergen van animatie-voltooiing toegang kon krijgen tot een vernietigde CUIElement, waardoor een toegangsschending werd veroorzaakt. De callbackfunctie gebruikt nu een zwakke verwijzing om het geval veilig te verwerken waarin het element wordt vernietigd voordat de animatie is voltooid. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
  • Er is een probleem opgelost waarbij venster pop-upinhoud die werd geopend in een XAML-eiland niet respecteerde OverrideScale, waardoor de inhoud te groot werd weergegeven en werd bijgesneden. Zie GitHub probleem #11000 voor meer informatie. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
  • Er is een fail-fast crash opgelost die werd veroorzaakt door herhaalde dispatching tijdens cross-apartment COM-releasebewerkingen in UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
  • WinUI: Er is een probleem opgelost met dubbelzinnige modulezoekacties wanneer meerdere modules met dezelfde naam in hetzelfde proces worden geladen. GetModuleHandleW is vervangen door GetModuleHandleExW zodat de juiste module op basis van het adres wordt gevonden. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
  • Een crash door deling door nul met gehele getallen in UniformGridLayout::GetMajorSize is opgelost wanneer een ItemsRepeater wordt ingedeeld binnen een beschikbare breedte die kleiner is dan de minor stride van één item. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
  • Er is een mogelijke crash opgelost wanneer een pakket is verwijderd voordat het werd verwerkt. (RuntimeCompatibilityChange: PackageManager_FixCrash)
  • Er is een probleem opgelost waarbij GetReadyState onjuiste foutcodes (bijvoorbeeld DisabledByUser of NotSupportedOnCurrentSystem) konden worden geretourneerd wanneer vereiste pakketten nog niet zijn geïmplementeerd. De API rapporteert NotReady nu correct in dit scenario, waardoor diagnostische duidelijkheid wordt verbeterd. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
  • Verbeterde interne prestatiediagnose voor LanguageModel.GenerateResponseAsync het beter identificeren van bronnen van latentie voordat het eerste token wordt geretourneerd. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
  • Er is een probleem opgelost waarbij XAML-compilerfouten stilletjes verloren gingen bij het gebruik van dotnet build, waarbij alleen MSB3073: exited with code 1 werd getoond in plaats van de werkelijke foutberichten. Zie GitHub probleem #9813 voor meer informatie. (RuntimeCompatibilityChange: N/A, wijziging in hulpprogramma's voor de XAML-compiler tijdens het bouwen)
  • Er is een probleem opgelost waarbij Microsoft.Windows.Workloads.dll niet kon worden geladen op Windows builds vóór 22000 vanwege statische import van dynamische afhankelijkheden-API's die niet beschikbaar waren in deze besturingssysteemversies. De functies worden nu dynamisch opgelost, zodat fouten in niet-ondersteunde besturingssysteemversies als normaal HRESULT worden weergegeven in plaats van een dialoogvenster met een loaderfout. (RuntimeCompatibilityChange: N/B, geen insluiting)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de versie 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

Versie 2.0 stabiel (2.0.1)

Uitgebracht: 29 april 2026

Windows App SDK 2.0 worden nieuwe API's en verbeteringen geleverd op het platform: XAML-voorwaarden, moderne opslagkiezers, uitgebreide pop-up- en anker-API's in Microsoft. UI. Inhoud, nieuwe API's voor pakketimplementatie en validatie, een geherstructureerde Windows ML-stack en toevoegingen aan het Windows AI-oppervlak. Het is ook de eerste release in het nieuwe Semantic Versioning-schema en de eerste primaire versie-update sinds Windows App SDK 1.0 (november 2021).

Semantische versiebeheer

Windows App SDK 2.0 is de eerste release van het nieuwe versiebeheerschema voor Windows App SDK, gestandaardiseerd op Semantische versiebeheer 2.0.0. Dit is ook de eerste keer dat we het primaire versienummer verhogen.

Het nieuwe schema vereenvoudigt versiebeheer door de Windows App SDK versie uit te lijnen met de NuGet-pakketversie. Als u verwijst naar Windows App SDK 2.0 in uw project, gebruikt u nu de bijbehorende NuGet-versie, zonder afzonderlijk buildnummer op basis van datums om bij te houden:

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

De naam van de pakketfamilie is ook afgestemd op de hoofdversie in plaats van de secundaire versie, dus de volgende parallelle release van Windows App SDK zal versie 3.0.0 zijn. Onder SemVer zijn belangrijke wijzigingen alleen toegestaan voor belangrijke versie-updates (zie Windows App SDK implementatiearchitectuur).

Windows ML

Het Microsoft.WindowsAppSDK.ML NuGet-pakket is geherstructureerd, waarbij een nieuwe basisafhankelijkheid wordt toegevoegd. De functionaliteit van het bestaande ML NuGet-pakket blijft hetzelfde, maar de kernfuncties Windows ML zijn geherstructureerd in een basispakket met de naam Microsoft.Windows.AI.MachineLearning. Dit nieuwe pakket bevat een minimale set afhankelijkheden; ondersteunende apps tot Windows 10 v1903. Als u ondersteuning voor Windows 10 v1809 nodig hebt, kunt u het bestaande Microsoft.WindowsAppSDK.ML-pakket blijven gebruiken.

ONNX Runtime. De versie van ONNX Runtime die is opgenomen in Windows ML is bijgewerkt naar 1.24.5. Zie ONNX Runtime-versies voor meer informatie. Deze release bevat ook een additieve ORT-API-wijziging ter ondersteuning van modelcompilatie met behulp van grafieken die door de OrtModelEditor API worden geproduceerd (een functie-kloof in het vorige OrtCompileApi oppervlak). De wijziging is niet belangrijk en is genomen om toekomstige webNN-browserscenario's te deblokkeren; zie de onderliggende ONNX Runtime PR #27332 voor meer informatie.

Licenties De Windows ML-licentieovereenkomst is vereenvoudigd met duidelijkere voorwaarden voor ISV's:

  • Secties voor herstructureerde installatie, gegevens en distribueerbare code voor duidelijkheid.
  • In een nieuwe sectie Nalevingsmelding voor uitvoeringsproviders (EP) worden de verantwoordelijkheden van ontwikkelaars met betrekking tot hardwareversnelde uitvoeringsproviders verduidelijkt.
  • Directe koppelingen naar licentieovereenkomsten van leveranciers voor NVIDIA TensorRT, Intel OpenVINO en Azure QNNN (AzureM Neural Network SDK).
Windows AI-API's
  • PhiSilium-API's worden nu afgedwongen als onderdeel van een functie voor beperkte toegang (LAF). Zie PhiSilium voor meer informatie.
  • Er zijn nieuwe statussen toegevoegd aan AIFeatureReadyState om apps te helpen bij het uitleggen van tijdelijke en blijvende fouten tijdens het aankoopproces van het AI-model: CapabilityMissing, NotCompatibleWithSystemHardware, en OSUpdateNeeded. Apps kunnen deze statussen gebruiken om gebruikers bruikbare richtlijnen te geven in plaats van elke 'niet gereed'-voorwaarde te behandelen als een algemene fout.
  • Er zijn controles toegevoegd voor verschillende netwerk- en Windows Update-fouten tijdens de installatie van het AI-model, waarbij duurzame fouten worden gemarkeerd, zodat gebruikers kunnen begrijpen waarom modelpakketten niet konden worden geïnstalleerd.
  • Verbeterde diagnosebaarheid voor Text Intelligence-API's die worden gebruikt in Windows AI-scenario's.
Ondersteuning voor slepen van WebView2 (WinUI 3)

Ondersteuning voor slepen is ingeschakeld voor WebView2-inhoud die wordt gehost in WinUI 3-toepassingen. Deze mogelijkheid werd eerder niet ondersteund en is nu beschikbaar zonder nieuwe openbare API's te introduceren. (Invoegen in een WebView2-besturingselement vanuit externe bronnen wordt al ondersteund.)

Ondersteunde scenario's:

  • Standaardinhoud voor slepen-en-neerzetten. Het slepen van tekst, HTML, afbeeldingen en URL's wordt ondersteund. Als u een afbeelding buiten de app sleept, krijgt deze momenteel een standaardbestandsnaam (bijvoorbeeld download.jpg) als hij in Verkenner wordt neergezet.
  • Annulering van slepen. Annuleren op aanvraag van een actieve sleepbewerking wordt ondersteund, zodat een app sleepbewerkingen voor beperkte of tijdelijke inhoud kan blokkeren op voorwaardelijke basis nadat de sleepbewerking is gestart.
  • Aangepaste visuals slepen. Aangepaste gebruikersinterface voor slepen, zoals pictogrammen of voorbeeldweergaven, wordt ondersteund om gebruikers te helpen de inhoud die wordt gesleept duidelijk te identificeren.
  • Aanpasbare gegevens slepen. Het bewerken en aanpassen van het slepen van gegevens wordt ondersteund, waardoor app-specifieke scenario's mogelijk zijn, zoals het slepen van berichten in de app of het bijvoegen van contextuele metadata (bijvoorbeeld "Van <app-naam>") die de bestemming kan lezen bij het neerzetten.

Limitations:

  • Sommige extra gegevenstypen voor slepen worden momenteel niet ondersteund, waaronder DownloadURL.

Vereisten:

  • Minimale WebView2 Runtime-versie (Edge Beta-kanaal): 144.0.3719.11.
Updates voor opslagkiezers

De Microsoft.Windows.Storage.Pickers-API (geïntroduceerd in Windows App SDK 1.8) is uitgebreid om de selectie van bestanden en mappen te stroomlijnen door ontwikkelaars de eerste en permanente maplocaties en groepsbestandstypefilters met duidelijke labels te laten instellen voor eenvoudigere navigatie.

  • FileOpenPicker voegt FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder, en Title toe.
  • FileSavePickervoegt InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, en SuggestedStartFolderTitle.
  • FolderPickervoegt PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, en SuggestedStartFolderTitle.
Microsoft. UI. Toevoegingen van inhoud
  • Relatieve popup-positionering. Met de nieuwe PopupAnchor API kunt DesktopPopupSiteBridge relatieve positionering ondersteunen door het te verankeren aan het eigen venster of eiland, waardoor de beperking wordt aangepakt waarbij pop-ups alleen absoluut kunnen worden gepositioneerd d.m.v. schermcoördinaten. Nieuwe DesktopPopupSiteBridge.AnchoringBehavior en DesktopPopupSiteBridge.AnchoringPixelAlignment eigenschappen bepalen het ankergedrag.
  • Richtlijnen voor toetsenbordsignalen. De nieuwe InputFocusController.ShouldShowKeyboardCues eigenschap begeleidt ontwikkelaars bij het bepalen of toetsenbord aanwijzingen moeten worden getoond direct nadat een ContentIsland is gemaakt.
  • PointerPoint handige API. Met de nieuwe PointerPoint.GetCurrentPoint methode kunnen ontwikkelaars de actieve PointerPoint gegevens ophalen uit een opgegeven pointerId.
Microsoft. UI. Xaml.Controls.SystemBackdropElement

De nieuwe Microsoft.UI.Xaml.Controls.SystemBackdropElement is een lichtgewicht FrameworkElement waarmee apps een systeemachtergrond zoals Mica of Acryl overal in de XAML-indeling kunnen plaatsen, met een CornerRadius eigenschap voor afgeronde achtergrondgebieden. Het sluit een langstaande WinUI 3-kloof, waarbij de in-app acryl effecten (voorheen eenvoudig in WinUI 2 via AcrylicBrush.BackgroundSource) geen directe equivalent hadden.

Pakketimplementatie en -validatie

De Microsoft.Windows.Management.Deployment-naamruimte voegt een pakketvalidatieframework en een PackageVolume-API toe voor het beheren van de opslagvolumes waarop pakketten zijn gefaseerd.

  • Verificatoren. Nieuwe IPackageValidator-interface plus drie ingebouwde validators (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator) die kunnen worden gekoppeld aan AddPackageOptions / StagePackageOptions via de nieuwe PackageValidators-eigenschap. PackageValidationEventArgs, PackageValidationEventSourceen PackageValidationHandler voer validatie-gebeurtenissen uit; IsPackageValidationSupported en GetValidationEventSourceForUri laat bellers ondersteuning testen voordat ze implementatie aanroepen.
  • Pakketvolume. Nieuw PackageVolume type metGetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, , , RemoveAsync, GetAvailableSpaceAsyncIsOffline, , SetDefault, SetOfflineAsync, , en SetOnlineAsyncIsFeatureSupported voor runtime-mogelijkheidsdetectie (PackageVolumeFeature).
Aangepaste XAML-voorwaardelijke voorwaarden (IXamlCondition)

Met de nieuwe IXamlCondition interface kunnen ontwikkelaars aangepaste voorwaarden definiëren die kunnen worden geïntegreerd met de syntaxis van de VOORWAARDELIJKE naamruimte van XAML en worden geëvalueerd op XAML-parseringstijd. Hierdoor wordt de experimentele IXamlPredicate interface vervangen. Aangepaste voorwaarden maken XAML-scenario's mogelijk op basis van toepassingsspecifieke factoren, zoals functievlagmen, apparaatmogelijkheden, bedrijfslogica, configuratie-instellingen en andere runtimevoorwaarden.

Bugfixes
  • Er is een probleem opgelost waarbij het WindowsAppSDK-installatieprogramma geen voortgang liet zien tijdens de installatie, waardoor het leek alsof het vastliep. Het installatieprogramma biedt nu duidelijkere voortgangsfeedback.
  • Verbeterde foutafhandeling voor scenario's waarin WindowsAppSDKSelfContained is ingeschakeld voor klassebibliotheken.
  • Opgelost MSB8027 en LNK4042 buildwaarschuwingen veroorzaakt door dubbele ClCompile items in Windows App SDK NuGet .targets bestanden door preprocessordefinities te verplaatsen van <Target> blokken naar <ItemDefinitionGroup>. Er is een tijdelijke oplossing voor afmelden (WindowsAppSDK_Arm64EcCompilerWorkaround) opgenomen voor ARM64EC+LTCG-builds om een bekende interne MSVC-compilerfout te voorkomen.
  • Er is een crash van ListView opgelost die kon optreden tijdens toetsenbordnavigatie (Tab/Shift+Tab) nadat de lijst met items is bijgewerkt.
  • Er is een probleem opgelost waarbij WinUI 3 kon vastlopen als de focus naar de CoreWebView2Controller controller werd verplaatst terwijl de controller niet zichtbaar was.
  • Verbeterde betrouwbaarheid van DeleteIndex, zodat het niet meer faalt in sommige scenario's met ERROR_SHARING_VIOLATION (App Content Search; blijft in het experimentele kanaal).
  • Vaste OCR-begrenzingsvakken die negatieve waarden retourneren in sommige edge-gevallen.
  • Er is een Windows ML-fout opgelost waarbij het aanroepen van RegisterCertifiedAsync opnieuw in hetzelfde proces ten onrechte 0 uitvoeringsproviders (EP) heeft geretourneerd.
Upgraden naar 2.0

Deze release bevat een herstructurering van transitieve verwijzingen naar nuget. Als u een bestaand C++-project wilt bijwerken, raden we u aan om hulpprogramma's (nuget.exe of Visual Studio) te gebruiken om de bestaande Windows App SDK pakketverwijzing te verwijderen en de nieuwe verwijzing toe te voegen. Dit omzeilt upgradeproblemen met packages.config-gebaseerde projecten.

Upgraden van 2.0 Experimenteel7. Het experimentele Microsoft.WindowsAppSDK.ML pakket, dat is verzonden met een hoger patchnummer dan 2.0.0 stabiele versie, kan resulteren in een NuGet-downgradefout, vooral in C++-projecten. Als u Experimenteel7 gebruikt, volgt u de NuGet Uninstall-handleiding om het experimentele pakket te verwijderen voordat u naar 2.0.0 verwijst.

Notities over eerdere preview-inhoud
  • App Content Search blijft experimenteel. Het Microsoft.Windows.Search.AppContentIndex API-oppervlak (App Content Search) is verwijderd in 2.0-Preview2 om de basisprincipes te verbeteren en toekomstige compatibiliteit te garanderen. Het is niet opgenomen in 2.0.1 stabiele versie. Om ermee te experimenteren, blijft u experimentele releases gebruiken. Als u eerder het experimentele Microsoft.Windows.Search-pakket hebt geïnstalleerd, verwijdert u het via de handleiding NuGet Uninstall voordat u overgaat naar 2.0.1 stabiel.
  • API's zijn al uitgebracht in de 1.8-service-update. Sommige experimentele functies die tijdens de 2.0-cyclus werden bekeken, werden gepromoveerd naar stabiele API's in 1.8 onderhoudsreleases en zijn daarom niet nieuw in 2.0.1. Ze omvatten ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) en SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer (1,8.6). Zie de opmerkingen bij release 1.8 voor meer informatie.
Bekende problemen
  • AICapabilities ontbreekt in 2.0.1. Microsoft.Windows.AI.AICapabilities en AICapabilityCategory.CopilotPlusPCCapable (een Copilot+ PC capaciteitscontrole) uitgebracht in 1.8.7 maar niet in 2.0.1. We zijn van plan ze te herstellen in de meirelease.
Nieuwe API's voor 2.0.1

Deze release bevat de volgende nieuwe API's in vergelijking met de stabiele versie 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
Nieuwe API's vergeleken met 2.0-Preview2
Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Versie 2.0 Preview 2 (2.0.0-Preview2)

Uitgebracht: 31 maart 2026

Windows ML

Het NuGet-pakket Microsoft.WindowsAppSDK.ML is geherstructureerd en voegt een nieuwe basisafhankelijkheid toe. De functionaliteit van het bestaande ML NuGet-pakket blijft hetzelfde, maar de kernfuncties Windows ML zijn geherstructureerd in een basisafhankelijk pakket met de naam Microsoft.Windows. AI. MachineLearning. Dit nieuwe pakket bevat een minimale set afhankelijkheden, maar op C#/WinRT of C++/WinRT ondersteunt het alleen tot Windows 10 18362. Als u ondersteuning voor Windows 10 17763 nodig hebt, gebruikt u het bestaande pakket Microsoft.WindowsAppSDK.ML.

Voor nieuwe transitieve afhankelijkheden raden we u aan om hulpprogramma's te gebruiken om het pakket (nuget.exe of VS) te upgraden. Zie ook: releaseopmerkingen Windows App SDK 1.6.

ONNX Runtime bijgewerkt

De versie van ONNX Runtime is bijgewerkt naar 1.24.4. Zie ONNX Runtime-versies voor meer informatie.

Windows AI-API's

Afgedwongen PhiSilium-API's om deel uit te maken van een functie voor beperkte toegang.

Er zijn controles toegevoegd voor verschillende netwerk- en Windows Update-fouten tijdens de installatie van het AI-model, waarbij duurzame fouten worden gemarkeerd, zodat gebruikers kunnen begrijpen waarom modelpakketten niet konden worden geïnstalleerd.

Verbeterde diagnosebaarheid voor Text Intelligence-API's die worden gebruikt in Windows AI-scenario's.

App-inhoud zoeken

App Content Search is verwijderd uit 2.0 preview, terwijl we werken aan het verbeteren van de basisprincipes en ervoor zorgen dat toekomstige compatibiliteit wordt gegarandeerd wanneer de onderliggende AI-modellen veranderen. In de tussentijd kunt u het experimentele kanaal blijven gebruiken om de meest recente wijzigingen uit te proberen.

WebView2 (WinUI 3)

Ondersteuning voor slepen is ingeschakeld voor WebView2-inhoud die wordt gehost in WinUI 3-toepassingen. Deze mogelijkheid werd eerder niet ondersteund en is nu beschikbaar zonder nieuwe openbare API's te introduceren. Opmerking: Ondersteuning voor het slepen en neerzetten naar WebView2 vanuit externe bronnen is al beschikbaar.

Ondersteunde scenario’s

  • Standaard inhoud voor slepen en neerzetten Het slepen van tekst, HTML, afbeeldingen en URL's wordt ondersteund. Op basis van het huidige gedrag leidt het slepen van afbeeldingen buiten de app tot een standaardbestandsnaam (bijvoorbeeld download.jpg) wanneer deze wordt neergezet in Verkenner. Voorbeeldscenario: Een gebruiker selecteert tekst of een afbeelding in WebView2 en sleept deze binnen de app of naar een andere locatie, zoals Verkenner.

  • Annulering van slepen Annulering op aanvraag van een actieve sleepbewerking wordt ondersteund. Voorbeeldscenario: Een app blokkeert voorwaardelijke slepenbewerkingen voor bepaalde inhoudstypen (zoals beperkte of tijdelijke inhoud) door de slepen te annuleren nadat deze is gestart.

  • Aangepaste visuals slepen Aangepaste gebruikersinterface voor slepen, zoals pictogrammen of voorbeeldweergaven, wordt ondersteund om gebruikers te helpen de inhoud die wordt gesleept duidelijk te identificeren. Voorbeeldscenario: Een app geeft een miniatuurvoorbeeld of pictogram weer terwijl een gebruiker media-inhoud sleept, zodat duidelijk wordt welk item momenteel wordt verplaatst.

  • Aanpasbare gegevens slepen Het bewerken en aanpassen van gegevens voor slepen wordt ondersteund, waardoor app-specifieke scenario's mogelijk zijn, zoals het slepen van berichten in de app (bijvoorbeeld als een alternatieve interactie voor het doorsturen van berichten). Voorbeeldscenario: Een app past de sleepinhoud aan om contextuele metagegevens op te nemen, zoals de naam van de oorsprongstoepassing. Wanneer de inhoud wordt verwijderd, kan de bestemming informatie zoals 'Van <app-naam>' weergeven of verwerken om de bron van de gesleepte inhoud aan te geven.

Beperkingen

  • Ondersteuning voor aanvullende gegevensformaten voor slepen en neerzetten is beperkt. De volgende indelingen worden momenteel niet ondersteund:
    • DownloadURL

Requirements

  • Minimale WebView2 Runtime-versie (Edge Beta-kanaal): 144.0.3719.11
Aangepaste XAML-voorwaardelijke voorwaarden (IXamlCondition)

Met de IXamlCondition interface kunnen ontwikkelaars aangepaste voorwaarden definiëren die kunnen worden geïntegreerd met de syntaxis van de VOORWAARDELIJKE naamruimte van XAML en worden geëvalueerd op XAML-parseringstijd. Dit is een hernoeming en de voltooiing van de experimentele IXamlPredicate interface. Aangepaste voorwaarden maken XAML-scenario's mogelijk op basis van toepassingsspecifieke factoren, zoals functievlagmen, apparaatmogelijkheden, bedrijfslogica, configuratie-instellingen en andere runtimevoorwaarden.

Bugfixes
  • Er zijn MSB8027- en LNK4042-buildwaarschuwingen opgelost, veroorzaakt door dubbele ClCompile-items in Windows App SDK NuGet .targets-bestanden, door de preprocessordefinities van <Target>-blokken naar <ItemDefinitionGroup> te verplaatsen. Er is een tijdelijke oplossing voor afmelden (WindowsAppSDK_Arm64EcCompilerWorkaround) opgenomen voor ARM64EC+LTCG-builds om een bekende interne MSVC-compilerfout te voorkomen.
  • Er is een crash van ListView opgelost die kon optreden tijdens toetsenbordnavigatie (Tab/Shift+Tab) nadat de lijst met items is bijgewerkt.
  • Er is een probleem opgelost waarbij WinUI 3 kon vastlopen als de focus werd verplaatst naar de CoreWebView2Controller terwijl de controller niet zichtbaar was.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en gewijzigde API's in vergelijking met 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

Versie 2.0 Preview 1 (2.0.0-Preview1)

Uitgebracht: 13 februari 2026

Windows ML
  • De versie van ONNX Runtime in Windows ML is bijgewerkt naar 1.24 RC
  • Er is een fout opgelost waarbij, als RegisterCertifiedAsync opnieuw wordt aangeroepen in hetzelfde proces, niet correct 0 uitvoeringsproviders (EP) retourneert
Microsoft.UI.Content
  • Nieuwe InputFocusController.ShouldShowKeyboardCues eigenschap om ontwikkelaars te begeleiden bij het bepalen of toetsenbordaanwijzingen moeten worden weergegeven vlak na het maken van een ContentIsland.
  • Nieuwe handige API PointerPoint.GetCurrentPoint, zodat ontwikkelaars de actieve PointerPoint gegevens van de opgegeven pointerIdgegevens kunnen ophalen.
App-inhoud zoeken
  • Verbeterde DeleteIndex betrouwbaarheid. Soms zou DeleteIndex kunnen mislukken met ERROR_SHARING_VIOLATION.

  • Oplossing voor OCR-grensvakken die in bepaalde randgevallen negatieve waarden retourneren.

  • App-inhoud zoeken maakt deel uit van een afzonderlijk Microsoft.Windows.Search-pakket in plaats van deel te uitmaken van Microsoft.Windows.AI package.

  • Oplossing voor het zoeken naar voorvoegsels werkt niet met korte queryreeksen.

  • Nieuwe API's en hernoemingen op basis van officiële API-beoordeling.

    • AppContentIndexer
      • GetContentItemsRequiringReindexing
      • Verwijderen -> VerwijderContentItem
      • VerwijderMeerdere -> VerwijderInhoudelementen
      • VerwijderAlleInhoudItems
      • GetContentIndexingStatus -> GetContentItemStatus
      • GetMultipleContentIndexingStatus -> GetContentItemStatuses
      • GetContentItems
    • AppContentIndexListener
      • StatusIndexeringGewijzigd -> ItemStatusGewijzigd
    • AppIndexTextQuerySession
      • Query bijwerken -> Zoekfrase bijwerken
      • MeestRecenteResultaat -> ResultaatOphalen
      • RecenteResultaatVeranderd -> ResultaatVeranderd
    • AppIndexImageQuerySession
      • Query bijwerken -> Zoekfrase bijwerken
      • MeestRecenteResultaat -> ResultaatOphalen
      • RecenteResultaatVeranderd -> ResultaatVeranderd
    • AppManagedImageQueryMatch
      • Subregio -> RegionOfInterest
    • ContentItemStatusResult
      • ReindexingStatus * ContentItemReindexingStatus (Status van de herindexering van de inhoud)
    • TextQuerySessionResult
      • IsGeldig
    • ImageQuerySessionResult
      • IsGeldig
    • QueryContentItemsFilterVlaggen
Bugfixes
  • Er is een probleem opgelost waarbij het WindowsAppSDK-installatieprogramma geen voortgang liet zien tijdens de installatie, waardoor het leek alsof het vastliep. Het installatieprogramma biedt nu duidelijkere voortgangsfeedback.
  • Verbeterde foutafhandeling van scenario's waarbij WindowsAppSDKSelfContained is ingeschakeld voor klassebibliotheken.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's in vergelijking met 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

Versie 2.5 Experimenteel (2.5.4-Experimenteel)

Uitgebracht: 29 september 2026

Deze experimentele release volgt Windows App SDK 2.5.1 stabiel en brengt over het algemeen de wijzigingen uit die release over. Zie de stabiele opmerkingen bij 2.5.1 voor deze details. In de volgende secties worden de experimentele toevoegingen beschreven.

Windows AI-updates
  • Met nieuwe AIComputeDevice-API's kunnen apps het standaard-, CPU- of NPU-uitvoeringsapparaat selecteren bij het maken van een TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice biedt dezelfde apparaatvoorkeur voor OCR die wordt uitgevoerd tijdens het indexeren van afbeeldingen van app-inhoudsindex.
  • AI Speech maakt nu gebruik van SpeechRecognitionModelFactory en SpeechRecognitionModelFactoryOptions om spraakherkenningsmodellen te configureren en te maken. Audio-invoermethoden accepteren nu 16-bits voorbeeldbuffers, continue herkenning stopt asynchroon en streamingherkenningsgebeurtenissen stellen providerspecifieke eigenschappen beschikbaar.
  • Met LanguageModel.ModelName, LanguageModel.ModelVersion en LanguageModelLowRankAdapterStatus kunnen apps het geïnstalleerde taalmodel identificeren en het compatibiliteitsresultaat controleren bij het laden van een adapter met lage rang.
  • LanguageModelResponseStatus.BlockedByGameMode en LanguageModelResponseStatus.LowOnVram identificeren antwoorden die niet konden worden voltooid omdat de gamemodus actief was of het beschikbare videogeheugen laag was.
API voor het binden van themabronnen

Met de nieuwe experimentele FrameworkElement.SetThemeResourceBinding-API kunnen apps het equivalent van een {ThemeResource} binding maken op basis van code. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

DataTemplate gedelegeerde constructie

Een nieuwe experimentele DataTemplate-constructor accepteert een door de app geleverde gemachtigde die de substructuur van het element van de sjabloon maakt. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

TableView-besturingselement

Het experimentele besturingselement TableView is nu beschikbaar in de openbare WinMD's. Het ondersteunt groepering met gegroepeerde groepskoppen, sorteren en filteren met indicatoren voor sorteren van kolomkoppen, aanwijzer en toetsenbordkolomgrootte en optionele knopinfo voor cellen en kolomkoppen. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Grafiekbesturingselement

Deze release voegt een experimenteel WinUI 3-diagrambesturingselement toe voor het weergeven van cartesiaanse gegevens als lijn-, gebieds- en staafreeksen. Het besturingselement ondersteunt configureerbare assen, legenda's, gegevenslabels en gegevensmarkeringen. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

Updates voor handschrift
  • InkPresenter.ActivateCustomDrying en InkSynchronizer toegevoegd, waarmee apps doorgevoerde inkt zelf kunnen renderen met behulp van BeginDry en EndDry.
  • Er is een toegangsschending verholpen die kon optreden bij het lezen van InkPresenter.StrokeContainer terwijl aangepast drogen actief was.
  • Grootteprobleem met de InkCanvas-presentator bij een RenderTransform opgelost.
  • De experimentele InkToolbar-API is afgestemd op het beoordeelde ontwerp. De werkbalk richt zich nu rechtstreeks op een InkPresenter zonder dat hiervoor een InkCanvas is vereist. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)
Bugfixes
  • Er is een probleem opgelost met het bijhouden van WinUI-resources waardoor het geheugengebruik kon toenemen wanneer apps herhaaldelijk storyboards met visuele status maakten of om statische of themaresources op te lossen. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
  • Verbeterde opschoning van onbereikbare native WinUI-objecten in .NET-apps na het verwijderen van een tabblad of pagina. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en bijgewerkte API's in vergelijking met de experimentele versie 2.4 :

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

Versie 2.4 Experimenteel (2.4.1-Experimenteel)

Uitgebracht: 25 augustus 2026

Deze experimentele release volgt Windows App SDK 2.4.0 stabiel en brengt over het algemeen de wijzigingen van die release over. Zie de stabiele opmerkingen bij 2.4.0 voor deze details. In de volgende secties worden de experimentele toevoegingen beschreven.

Ondersteuning voor inkt

In deze release wordt inktondersteuning toegevoegd voor WinUI 3 tot en met InkCanvas, InkToolbar en InkPresenter, waaronder pen- en aanraakinvoer, ondersteuning voor klembord, ondersteuning voor hoog contrast, stroke-invoer en niet-verwerkte invoer. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de 2.3 Experimentele A-release :

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

Versie 2.3 Experimenteel A (2.3.2-ExperimentalA)

Uitgebracht: 30 juli 2026

Deze experimentele release bouwt voort op Windows App SDK 2.3.1 stabiel. Zie de stabiele opmerkingen bij 2.3.1 voor de wijzigingen in die release. In de volgende secties worden de experimentele toevoegingen beschreven.

Window.Width en Window.Height

Nieuwe experimentele eigenschappen Window.Width en Window.Height bieden apps een DPI-bewuste manier om de grootte van een venster in logische (client)pixels rechtstreeks vanuit code of markup op te halen en in te stellen, zonder via Window.AppWindow te hoeven gaan en handmatig een logische-naar-fysieke DPI-conversie uit te voeren. De eigenschappen Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth en Window.MaxHeight beperken de grootte van het venster. We verwelkomen uw feedback.

Updates voor spraakherkenning

De experimentele SpeechAudioProvider (gebruikt voor het pushen van 16 kHz, 16-bits pcM-audio met één kanaal naar spraakherkenning) implementeert nu IClosable, zodat apps de provider deterministisch kunnen vrijgeven met Close/Dispose wanneer ze klaar zijn met het streamen van audio.

Updates voor app-inhoudsindex

De experimentele API's voor app-inhoudsindex voegen nieuwe indexeringsmogelijkheden en aanzienlijke betrouwbaarheids- en prestatieverbeteringen toe in deze release:

  • Snellere batchindexering. Met een nieuwe AppContentIndexer.BatchAddOrUpdate-API kunnen meerdere items samen worden geïndexeerd. De indexeringspijplijn is ook opnieuw ontworpen ter ondersteuning van parallelle uitvoering van fasen en efficiëntere batchverwerking.
  • Verbeterde meertalige tokenisatie. App Content Index maakt nu gebruik van een op ICU gebaseerde woordonderbreker, waardoor de tokenisatie correctheid in verschillende talen wordt verbeterd terwijl een afhankelijkheid van WinRT WordsSegmenter wordt verwijderd.
  • Verbeterde indexering en queryprestaties. Indexupdates vermijden nu onnodige lexicale herschrijvingen, voeren batchopschoontaken efficiënter uit en cachen indexmogelijkheden tussen query’s, waardoor de overhead in veelvoorkomende query- en indexeringstrajecten aanzienlijk afneemt.
  • Stabielere lexicale rangschikking. BM25-scores houden nu afzonderlijk statistieken over documentlengte bij, waardoor de rangschikking consistent blijft wanneer content incrementeel wordt bijgewerkt of verwijderd.
  • Automatisch herstel van beschadigingen. App Content Index detecteert beschadiging van de database en incompatibele schemawijzigingen bij het openen van een index en herstelt automatisch door een herindex in teitiëren in plaats van de index onbruikbaar te maken. GetOrCreateIndexStatus.RecoveredFromCorruption geeft aan wanneer het herstel is opgetreden.
  • Boosts voor statische rangschikking. Met nieuwe API's kunnen apps individuele contentitems of regio's een hogere ranking geven, waardoor resultaten kunnen worden beïnvloed met door de app aangeleverde signalen. Gebruik statische boosts wanneer uw app kennis heeft over het relatieve belang van inhoud die niet wordt vastgelegd door de inhoud zelf, bijvoorbeeld om een document weer te geven dat met name belangrijk of vaak door uw gebruikers wordt gezocht.
  • Indexering van afbeeldingsinhoud. Apps kunnen nu rechtstreeks bitmap- of afbeeldingsstreaminhoud indexeren, met opties voor het beheren van OCR-extractie en semantische indexering van geëxtraheerde tekst. Gebruik indexering van afbeeldingen wanneer zinvolle doorzoekbare informatie is opgenomen in een afbeelding in plaats van al beschikbaar als tekst, zoals schermopnamen, gescande documenten of andere visuele inhoud.
  • Semantisch indexeringsbeheer voor tekst. Met een nieuwe eigenschap ContentRegionTextOptions.AllowSemanticIndexing kunnen apps afzonderlijke tekstregio's uit semantische indexering kiezen. Dit is handig voor tekst die lexicaal doorzoekbaar moet blijven, maar waarschijnlijk geen baat heeft bij semantische overeenkomsten, waardoor apps meer controle krijgen over welke inhoud deelneemt aan het semantische ophalen.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de 2.2 Experimentele 9-release :

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

Versie 2.2 Experimenteel 9 (2.2.2-Experimenteel9)

Uitgebracht: 9 juni 2026

Deze experimentele release wordt geleverd naast Windows App SDK 2.2.0 stabiele en brengt over het algemeen de wijzigingen van die release over; zie de 2.2.0 stabiele opmerkingen voor deze details. In de volgende secties worden de experimentele toevoegingen beschreven.

Language Model API's op GPU [experimenteel]

De Language Model-API's worden nu uitgevoerd op niet-Copilot+ PCs uitgerust met een ondersteunde GPU, waardoor mogelijkheden voor lokale taalmodellen worden toegevoegd aan een breder scala aan Windows 11 apparaten. Ondersteunde hardware omvat NVIDIA GeForce RTX 30-serie en hoger met 6+ GB vRAM. Gpu-deductie vereist dat de ontwikkelaarsmodus is ingeschakeld en een Windows Insider Experimental Channel-build.

Het GPU-model is niet vooraf geïnstalleerd. Het wordt op aanvraag via EnsureReadyAsync door Windows Update gedownload. Apps moeten GetReadyState controleren en een toestemmingsdialoogvenster weergeven voordat de download wordt gestart. Gebruikers kunnen het model beheren bij Instellingen > systeem > AI-onderdelen.

Zie de nieuwe Transparantienotitie: Language Model-API's op niet-Copilot+ PCs voor verantwoorde AI-richtlijnen.

Spraakherkennings-API's [experimenteel]

Nieuwe spraakherkennings-API's op het apparaat in Microsoft.Windows.AI.Speech maken zowel batch- als streaming-spraak-naar-tekstconversie mogelijk. BatchRecognition herkent een volledige audiobron in één gesprek en StreamingRecognition genereert Recognizing en Recognized gebeurtenissen. Audio kan afkomstig zijn van een apparaat (), bestand (AudioConfiguration.FromAudioDeviceFromFile), invoerstroom (FromStream) of door de beller worden gepusht via SpeechAudioProvider (16 kHz, 16-bits, PCM met één kanaal). Het model op het apparaat wordt beheerd via SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, waarbij de voortgang van downloaden en laden wordt gerapporteerd via SpeechRecognitionModelProgress.

Nieuwe NpuType-API

Met een nieuwe Microsoft.Windows.Workloads.NpuType enum wordt de NPU-klasse op het huidige apparaat weergegeven (bijvoorbeeld Qnn, Lnl, Stx, Win365, Unknown, None), zodat apps en de infrastructuur voor workloads AI-workloads naar het juiste uitvoeringspad kunnen routeren.

Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de 2.1 Experimental 8-release :

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

Versie 2.1 Experimenteel 8 (2.1.4-Experimenteel8)

Uitgebracht: 21 mei 2026

Deze experimentele release wordt geleverd naast Windows App SDK 2.1.3 stabiele en brengt over het algemeen de wijzigingen van die release over; zie de 2.1.3 stabiele opmerkingen voor deze details. In de volgende secties worden de experimentele toevoegingen beschreven.

Sterk getypt resultaat en status voor gestructureerde JSON-antwoorden [Experimenteel]

LanguageModelExperimental.GenerateStructuredJsonResponseAsync (geïntroduceerd in 2.0 Experimenteel 7) retourneert nu een toegewezen GenerateStructuredJsonResponseResult type met een GenerateStructuredJsonResponseStatus eigenschap, in plaats van het algemene LanguageModelResponseResult / LanguageModelResponseStatus paar. De nieuwe statusenum is specifiek voor schema-beperkte generatie: deze bevat de waarde ResponseInvalidJson voor het geval dat de uitvoer van het model niet voldoet aan het gevraagde JSON-schema, afzonderlijk van algemene fouten in reacties van het taalmodel.

Als onderdeel van deze splitsing is de ResponseInvalidJson waarde verwijderd uit de stabiele LanguageModelResponseStatus enum (waar deze eerder was toegevoegd ter ondersteuning van gestructureerde JSON-uitvoer). Apps die ResponseInvalidJson van LanguageModelResponseStatus afhandelden, moeten die afhandeling verplaatsen naar de nieuwe GenerateStructuredJsonResponseStatus die wordt teruggegeven door GenerateStructuredJsonResponseAsync. Andere aanroepen van LanguageModelResponseStatus hoeven niet langer rekening te houden met een JSON-specifieke foutwaarde.

Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe API's in vergelijking met de 2.0 Experimental 7-release :

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]

Versie 2.0 Experimenteel 7 (2.0.0-Experimenteel7)

Uitgebracht: 21 april 2026

CMake Support [Experimenteel]

Windows App SDK 2.0.0-experimenteel7 introduceert experimentele CMake-ondersteuning (onder actieve ontwikkeling), waardoor C++-ontwikkelaars Windows App SDK NuGet-pakketten van CMake-projecten kunnen gebruiken.

De CMake-integratie is gebouwd op NuGetCMakePackage, een opensource CMake-module die de kloof tussen NuGet-pakketbeheer en de systeemeigen find_package() werkstroom van CMake overbrugt. NuGetCMakePackage verwerkt het downloaden en herstellen van NuGet-pakketten tijdens de configuratie via, add_nuget_packages()test elk pakket voor een ingesloten cmake-configuratie (op) build/cmake/<package>-config.cmakeen toont de headers van het pakket, importbibliotheken, runtime-DLL's en WinRT-metagegevens als standaard-CMake-doelen.

Elk Windows App SDK NuGet-onderdeel en afhankelijk pakket sluit nu een CMake-configuratiebestand in onder build/cmake/, dat met behulp van de NuGetCMakePackage-bibliotheek, CMake's find_package() automatisch doelen, headers, bibliotheken en runtime-DLL's kan detecteren zonder handmatige padconfiguratie. Dit omvat alle onderdeelpakketten, waaronder Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML en WinUI, evenals afhankelijkheden zoals Base en Runtime.

Zie de CMake-landingspagina voor een overzicht van het CMake-verbruiksmodel en een beginnershandleiding.

Deze functie is experimenteel en wordt vroeg uitgerold om feedback van de community te verzamelen. De doelnaamconventies en configuratiepatronen kunnen worden gewijzigd op basis van de invoer van ontwikkelaars. Omdat dit een vroege vlucht is, is er een aantal ceremonies en installatie betrokken. Raadpleeg de CMake-voorbeeldtoepassingen die end-to-end configuratie en gebruik illustreren voor alle vier implementatiescenario's (SelfContained|FrameworkDependent x Packaged|Unpackaged).

We horen graag van u! Als u een scenario tegenkomt dat momenteel niet wordt behandeld, suggesties hebt voor het verbeteren van de ontwikkelaarservaring of problemen ondervindt, kunt u feedback indienen op het tabblad Issues op het tabblad Windows App SDK opensource-opslagplaats of een gesprek starten in Discussions. Uw invoer geeft rechtstreeks vorm aan de actieve ontwikkeling van deze functie.

Wijzigingen die zijn doorgevoerd vanuit het preview-kanaal

Deze experimentele release bevat de wijzigingen en fixes die zijn verzonden in 2.0-Preview1 en 2.0-Preview2. Items die naar voren zijn gebracht, worden hieronder samengevat; raadpleeg de gekoppelde releaseopmerkingen voor de Preview voor volledige details.

Vanaf 2.0-Preview1:

  • Windows ML: Oplossing voor RegisterCertifiedAsync retourneert 0 uitvoeringsproviders wanneer deze opnieuw worden aangeroepen in hetzelfde proces.
  • Microsoft. UI. Inhoud: nieuwe eigenschap InputFocusController.ShouldShowKeyboardCues en nieuwe handige API PointerPoint.GetCurrentPoint.
  • Microsoft.Windows. Management.Deployment: Nieuwe API's van PackageVolume voor pariteit+ met Windows.Management.Deployment (inclusief AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported en meer). Nieuw IPackageValidator uitbreidbaarheidspunt aan AddPackageOptions en StagePackageOptions, met drie ingebouwde validators: PackageCertificateEkuValidator, PackageFamilyNameValidatoren PackageMinimumVersionValidator.
  • Microsoft.Windows. Storage.Pickers:
    • Nieuwe Title-eigenschappen voor FileOpenPicker, FileSavePicker, en FolderPicker, waarmee aangepaste dialoogvenstertitels mogelijk worden gemaakt.
    • Nieuwe SettingsIdentifier-eigenschappen op FileOpenPicker, FileSavePicker en FolderPicker, waardoor instantiespecifieke status van de kiezer mogelijk wordt gemaakt in verschillende sessies.
    • Nieuwe InitialFileTypeIndex-eigenschappen op FileOpenPicker en FileSavePicker, waarmee ontwikkelaars het standaardfilter voor geselecteerde bestandstypen kunnen instellen op index (beginnend bij 0).
    • Nieuwe ShowOverwritePrompt eigenschap op FileSavePicker. Het staat standaard in op true en bepaalt of de kiezer waarschuwt voor overschrijven wanneer de gebruiker een bestaand bestand via FileSavePicker selecteert.
    • Het standaardgedrag van FileSavePicker is gewijzigd: vanaf WindowsAppSDK 2.0 zal FileSavePicker geen leeg bestand creëren wanneer de gebruiker een niet-bestaand bestand selecteert, waardoor ontwikkelaars de flexibiliteit hebben om te bepalen wanneer het bestand moet worden gemaakt.
    • Nieuwe methode PickMultipleFoldersAsync op FolderPicker voor het selecteren van meerdere mappen in één enkele handeling.
  • Opgeloste fouten: voortgangsrapportage van het installatieprogramma; verbeterde foutafhandeling voor WindowsAppSDKSelfContained klassebibliotheken.

Vanaf 2.0-Preview2:

  • Windows AI-API's: Phi Silicium-API's worden afgedwongen als een functie voor beperkte toegang; nieuwe AIFeatureReadyState waarden duiden op problemen met modelverwerving, zoals ontbrekende mogelijkheden, incompatibele hardware en vereiste besturingssysteemupdates; duurzame problemen met netwerk-/Windows Update-installaties worden nu gemarkeerd; verbeterde mogelijkheden voor diagnose voor Text Intelligence-API's.
  • Aangepaste XAML-voorwaarden: IXamlCondition finaliseert en hernoemt de experimentele IXamlPredicate interface, waarmee aangepaste voorwaarden worden ingeschakeld die tijdens de XAML-parsering worden geëvalueerd.
  • WebView2 (WinUI 3): ondersteuning voor slepen voor inhoud die wordt gehost in WebView2 (tekst, HTML, afbeeldingen, URL's), annulering van slepen, aangepaste sleepvisuals en aanpasbare sleepgegevens. Hiervoor is WebView2 Runtime 144.0.3719.11 of hoger vereist. (DownloadURL nog niet ondersteund.)
  • Opgeloste fouten: MSB8027/LNK4042 buildwaarschuwingen van dubbele ClCompile-items in .targets bestanden (met een opt-out mogelijkheid WindowsAppSDK_Arm64EcCompilerWorkaround voor ARM64EC+LTCG); ListView crash tijdens toetsenbordnavigatie na het bijwerken van de lijst met items; WinUI 3 crash wanneer de focus is verplaatst naar een niet-zichtbare CoreWebView2Controller.
Video Super Resolutie
  • API-hernoemingsbewerking voor duidelijkheid en consistentie.
    • ScaleFrameStatus → VideoScalerStatus
    • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
    • VideoScaler.ScaleFrame en VideoScaler.Scale → VideoScaler.ScaleImageBuffer
  • Verschillende bugfixes en kwaliteitsverbeteringen in VSR.
Windows AI-taalmodel
  • Nieuwe LanguageModelExperimental.GenerateStructuredJsonResponseAsync-API onder Microsoft.Windows.AI.Text.Experimental voor het genereren van gestructureerde JSON-uitvoer van een taalmodel.
  • Nieuwe LanguageModelResponseStatus.ResponseInvalidJson statuswaarde om aan te geven dat een model een antwoord heeft geretourneerd dat niet als geldige JSON is geparseerd.
Inhoudsindexeerfunctie voor apps
  • Nieuwe AppContentIndexer.GetExistingIndexes API's en AppContentIndexer.IsContentKindSupported API's.
  • Nieuw AppManagedOcrTextQueryMatch type en QueryMatchContentKind.AppManagedOcrText waarde ter ondersteuning van het raadplegen van app-inhoud via OCR-afgeleide tekst.
  • Nieuw GetOrCreateIndexOptions.CreateAlways om het maken van een nieuwe index af te dwingen.
  • Nieuwe ContentItemErrorDetail.InsufficientDiskSpace om schijfruimtegebreken tijdens het indexeren aan het licht te brengen.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's in vergelijking met 2.0.0-experimenteel6:

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

Versie 2.0 Experimenteel 6 (2.0.0-Experimenteel6)

Uitgebracht: 13 maart 2026

Windows ML CMake-ondersteuning

Windows ML kan nu worden gebruikt vanuit C++-projecten met CMake. Zie de pagina Aan de slag voor meer informatie.

ONNX Runtime bijgewerkt

De versie van ONNX Runtime is bijgewerkt naar 1.24.2. Zie ONNX Runtime-versies voor meer informatie.

Windows AI-taalmodel
  • NPUPowerMode is afgeschaft ten gunste van nieuwere energiebeheer-API's.
  • GetReadyState retourneert NotSupported nu probleemloos wanneer de sessiebroker niet beschikbaar is, in plaats van een uitzondering te genereren.
Video Super Resolutie
  • Ondersteuning voor NV12-uitvoerindeling toegevoegd voor Video Super Resolution.
App-inhoud zoeken
  • Verbeterde DeleteIndex betrouwbaarheid. Soms zou DeleteIndex kunnen mislukken met ERROR_SHARING_VIOLATION.

  • Oplossing voor OCR-grensvakken die in bepaalde randgevallen negatieve waarden retourneren.

  • App-inhoud zoeken maakt deel uit van een afzonderlijk Microsoft.Windows.Search-pakket in plaats van deel te uitmaken van Microsoft.Windows.AI package.

  • Oplossing voor het zoeken naar voorvoegsels werkt niet met korte queryreeksen.

  • Nieuwe API's en hernoemingen op basis van officiële API-beoordeling.

    • AppContentIndexer
      • GetContentItemsRequiringReindexing
      • Verwijderen -> VerwijderContentItem
      • VerwijderMeerdere -> VerwijderInhoudelementen
      • VerwijderAlleInhoudItems
      • GetContentIndexingStatus -> GetContentItemStatus
      • GetMultipleContentIndexingStatus -> GetContentItemStatuses
      • GetContentItems
    • AppCOntentIndexListener
      • StatusIndexeringGewijzigd -> ItemStatusGewijzigd
    • AppIndexTextQuerySession
      • Query bijwerken -> Zoekfrase bijwerken
      • MeestRecenteResultaat -> ResultaatOphalen
      • RecenteResultaatVeranderd -> ResultaatVeranderd
    • AppIndexImageQuerySession
      • Query bijwerken -> Zoekfrase bijwerken
      • MeestRecenteResultaat -> ResultaatOphalen
      • RecenteResultaatVeranderd -> ResultaatVeranderd
    • AppManagedImageQueryMatch
      • Subregio -> RegionOfInterest
    • ContentItemStatusResult
      • ReindexingStatus * ContentItemReindexingStatus (Status van de herindexering van de inhoud)
    • TextQuerySessionResult
      • IsGeldig
    • ImageQuerySessionResult
      • IsGeldig
    • QueryContentItemsFilterVlaggen
Bugfixes
  • Opgelost ImageDescription.DescribeAsync dat InternalError faalde vanwege een race condition.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's vergeleken met 2.0.0-experimenteel5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

Versie 2.0 Experimenteel 5 (2.0.0-Experimenteel5)

Uitgebracht: 13 februari 2026

Windows ML Licensingvereenvoudiging
  • Vereenvoudigde licentieovereenkomst met duidelijkere voorwaarden voor ISV's die toepassingen bouwen met Windows ML.
  • Geherstructureerde secties met betrekking tot installatie, gegevens en distribueerbare code met verbeterde duidelijkheid.
  • In de sectie Nalevingsmelding voor nieuwe uitvoeringsproviders (EP) worden de verantwoordelijkheden van ontwikkelaars met betrekking tot hardwareversnelde uitvoeringsproviders verduidelijkt.
  • Directe koppelingen naar licentieovereenkomsten van leveranciers voor NVIDIA TensorRT, Intel OpenVINO en Azure QNNN (AzureM Neural Network SDK).

Versie 2.0 Experimenteel 4 (2.0.0-Experimenteel4)

Uitgebracht: 13 januari 2026

ONNX Runtime-uitlijning en stabiliteit van uitvoeringsprovider
  • Windows ML experimentele builds zijn afgestemd op de mainlineversie 1.24 van ONNX Runtime om de compatibiliteit en stabiliteit te verbeteren.
  • Stabiele ABI-uitvoeringsproviders (Application Binary Interface) worden afgedwongen om voorspelbaar gedrag op apparaten te garanderen, waarbij niet-stabiele uitvoeringsproviders uitgesloten zijn van overname.
    • Alleen de OpenVINO-uitvoeringsprovider wordt ondersteund, met extra uitvoeringsproviders die in de loop van de tijd moeten worden toegevoegd als ze voldoen aan de stabiliteitsvereisten.
  • De grootte van Microsoft.Windows.AI.MachineLearning.dll is met ongeveer 160 kB verminderd.
App-inhoud zoeken
  • Nieuwe experimentele API's voor opzoekstatistieken van items die worden geïndexeerd. Dit biedt inzicht in wat er in de index gebeurt.
  • Ondersteuning voor het annuleren van query's, zodat apps een query kunnen uitvoeren en bijwerken als er een nieuwe query is voordat de huidige query wordt voltooid. Hierdoor kunt u sneller reageren op de zoekopdracht terwijl een gebruiker de opdracht invoert.
  • Ondersteuning voor voorvoegselkoppeling voor korte tekenreeksen om de resultaten te verbeteren terwijl de gebruiker typt.
Verbeteringen in video superresolutie
  • VideoScaler is nu wegwerpbaar, waardoor resourcebeheer en levenscyclusbeheer worden verbeterd.
  • Het VSR-model is nu gecompileerd en in de cache opgeslagen om de prestaties te verbeteren en herhaalde initialisatiekosten te verlagen.
  • Er is een mogelijkheidscontrole toegevoegd om VSR-ondersteuning te valideren voordat u deze gebruikt.
  • Expliciete WinML-initialisatie is niet meer vereist bij het gebruik van Video Super Resolution.
Verbeteringen van de WinUI FlowLayout-afstand
  • Het FlowLayout besturingselement maakt nu gebruik van de terminologie ItemSpacing en LineSpacing in plaats van horizontale en verticale afstandseigenschappen. De uitgelijnde naamgeving verbetert de duidelijkheid en consistentie met moderne indelingspatronen in ui-frameworks.
Verbeteringen WinUI WrapPanel
  • Het WrapPanel besturingselement maakt nu gebruik van de nomenclatuur ItemSpacing en LineSpacing in plaats van de vorige horizontale en verticale afstandseigenschappen.
Aangepaste XAML-predicaten en IXamlPredicate-integratie
  • Implementeerde de IXamlPredicate interface om aangepaste predicaten te definiëren die naadloos kunnen worden geïntegreerd met de syntaxis van de voorwaardelijke naamruimte van XAML en worden geëvalueerd op XAML-parseringstijd.
  • Aangepaste predicaten maken voorwaardelijke XAML-scenario's mogelijk op basis van toepassingsspecifieke factoren, zoals:
    • Functievlaggen
    • Apparaatmogelijkheden
    • Bedrijfslogica
    • Configuratie-instellingen
    • Andere runtime voorwaarden
Verbeteringen van WinUI Open-Source
  • Bijgewerkte pakketten om externe bruikbaarheid mogelijk te maken, waaronder wijzigingen in:
    • Microsoft.UI.DCPP.Afhankelijkheden.Minimal
    • Microsoft.UI.DCPP.Afhankelijkheden.Edge
    • ExpPointerPointStatics
  • Build-ondersteuning toegevoegd voor Visual Studio 2026
  • Hulpprogramma's en scripts geïntroduceerd voor gebruik door externe ontwikkelaars om WinUI te bouwen en te testen.
Afschaffing en hernoeming van WinUI-API
  • [verouderd] DependencyObject.Dispatcher
  • [verouderd verklaard] Window.Current
  • [afgeschaft] FocusManager.GetFocusedElement
  • [hernoemd] SystemBackdropHost naar SystemBackdropElement
WinAI-API-naamruimte hernoemen
  • [hernoemd] Microsoft.Windows.AI.Search.Experimental.AppContentIndex naar Microsoft.Windows.Search.AppContentIndex
Bugfixes
  • Er zijn fouten met 'Klasse niet geregistreerd' opgelost bij het gebruik van zelfstandige implementatie met Windows ML. Ontwikkelaars die gebruikmaken van zelfstandige implementatie hoeven niet langer alle activeringsklassen van het Foundation-pakket te registreren die intern zijn gebruikt.
  • Er is een mogelijke crash opgelost bij het afsluiten van processen bij het gebruik van Windows ML.
  • ImageForegroundExtractor Het API-routeringspad is opgelost, zodat aanroepen het juiste eindpunt bereiken.
  • Ervoor gezorgd dat de installatie- en downloadvoortgang van de uitvoeringsprovider correct wordt doorgestuurd naar apps tijdens de pakketimplementatie.
  • Een crash in SystemBackdrop is opgelost wanneer de verbinding met het doel wordt verbroken door het beveiligen tegen ongeldige verbroken paden.
  • Er is een probleem opgelost waardoor Windows AI-API's niet beschikbaar konden zijn voor sommige toepassingen.
Nieuwe of bijgewerkte API's

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's in vergelijking met 2.0.0-experimenteel3:

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
Bekende problemen
  • Een ONNX Runtime-regressie zorgt ervoor dat Video Super Resolution mislukt op Qualcomm-apparaten. Een aanstaande update van de Qualcomm NPU-uitvoeringsprovider lost dit probleem op.

Versie 2.0 Experimenteel 3 (2.0.0-Experimenteel3)

Uitgebracht: 17 november 2025

Nieuw controle SplitMenuFlyoutItem

Het nieuwe experimentele besturingselement SplitMenuFlyoutItem is ontworpen om een ervaring met een gesplitste knop te bieden binnen een menu-flyout. Met dit besturingselement kunnen ontwikkelaars een standaard primaire actie beschikbaar maken, terwijl ze ook extra opties bieden via een submenu, ideaal voor het beperken van complexe functionaliteit tot een kleinere footprint en het besparen van de totale menulengte.

Naast de mogelijkheden van MenuFlyoutItem en MenuFlyoutSubItem wordt het besturingselement geleverd met twee andere eigenschappen: SubMenuPresenterStyle en SubMenuItemStyle, waarmee het submenu kan worden aangepast, zoals het gebruik van GridView voor de presentator van het submenu.

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

Naam van typen gewijzigd

  • Naam van WinMLCatalogModel gewijzigd in ModelCatalog
  • Naam van CatalogModelSource gewijzigd in ModelCatalogSource

Methodeupdates

  • CatalogModelInfo: Hernoemd GetInstance naar GetInstanceAsync
  • ModelCatalogSource: Hernoemd CreateFromUri naar CreateFromUriAsync
  • ModelCatalog: Hernoemd FindModel naar FindModelAsync
  • ModelCatalog: Hernoemd FindAllModels naar FindAllModelsAsync

Eigenschapswijzigingen

  • Bijgewerkt CatalogModelInfo.Size naar CatalogModelInfo.ModelSizeInBytes

Gedragsupdates

  • Exemplaar ophalen van CatalogModelInstanceResult met behulp van .GetInstance()
  • CatalogModelStatus retourneert nu Ready of NotReady op basis van lokale beschikbaarheid
  • Toegevoegd CatalogModelInstanceStatus om de exemplaarstatus te scheiden van de modelstatus

Verbeteringen van CatalogModelInfo

  • Naam van Alias gewijzigd in Name
  • Naam van Revision gewijzigd in Version
  • Publisher toegevoegd
  • Verwijderd DisplayName

JSON-wijzigingen

  • De naam is gewijzigd alias in id.
  • Verwijderd modelType en description.
  • De naam is gewijzigd executionProvider in executionProviders.
  • Bijgewerkt executionProviders als een matrix van JSON-objecten in plaats van een door komma's gescheiden lijst.

Aanvullende wijzigingen

  • ModelCatalog retourneert nu een lijst met uitvoeringsproviders (EPs) wanneer een exemplaar wordt gemaakt.
  • Ondersteuning toegevoegd voor Windows 10 (1809) en hoger.
  • Er is ondersteuning toegevoegd voor lokale bestanden, waaronder zowel gewone bestanden als MSIX-pakketten.
  • Vastgelopen crashes veroorzaakt door ongeldige catalogus-JSON.
AppContentIndexer
  • Het vorige AppIndexQuery type, waarbij GetNextTextMatches en GetNextImageMatches methoden zijn inbegrepen, is onderverdeeld in twee verschillende typen: AppIndexTextQuery en AppIndexImageQuery. De AppContentIndexer.CreateQuery methode is vervangen door: CreateTextQuery en CreateImageQuery.

  • Deze methoden retourneren AppIndexTextQuery nu respectievelijk AppIndexImageQuery . Ter vereenvoudiging van het gebruik zijn ook de optiestypen bijgewerkt:

    • Verwijderd: AppIndexQueryOptionsen TextMatchOptionsImageMatchOptions
    • Toegevoegd: TextQueryOptions en ImageQueryOptions
  • De API's in de AppContentIndex-naamruimte die eerder arrays retourneerden, retourneren nu IVectorView, wat zorgt voor verbeterde consistentie en prestaties.

  • De AppContentIndexer.WaitForIndexingIdleAsync methode is bijgewerkt om een TimeSpan parameter te accepteren in plaats van een geheel getal, waardoor de verwerking van time-outs duidelijker en flexibeler wordt.

Video Super Resolution AI API

De VideoScaler API biedt realtime videoverbetering via geavanceerde AI-upscaling, geoptimaliseerd voor streams met mensen in gesprek. Hiermee kunnen ontwikkelaars scherpere, duidelijkere visuals bieden voor vergader-, streaming- en bewerkingsplatformen, zelfs onder slechte netwerkomstandigheden. De API ondersteunt aanpassing van uitvoerresolutie, framesnelheid en interessegebieden, met compatibiliteit voor meerdere video-indelingen, waaronder BGR, RGB en NV12.

Windows AI Text Rewriter Tone

Met de nieuwe RewriteCustomAsync-API kunt u een invoertekenreeks opgeven waarmee Phi Silicium wordt begeleid bij het herschrijven van geselecteerde tekst. U kunt experimenteren met nieuwe creatieve stijlen, zoals 'Goofy' of 'Pirate', om uw inhoud direct te transformeren.

AI-beeldgeneratie

De ImageGenerator klasse maakt gebruik van Stable Diffusion-modellen om krachtige mogelijkheden voor het genereren van afbeeldingen te bieden. Het biedt ondersteuning voor scenario's met meerdere generaties:

  • Tekst naar afbeelding: Afbeeldingen genereren op basis van beschrijvende tekstprompts.

  • Afbeelding naar afbeelding: Bestaande afbeeldingen transformeren op basis van tekstbeschrijvingen.

  • Magic Fill: Gemaskeerde regio's van afbeeldingen vullen met door AI gegenereerde inhoud.

  • Kleurboekstijl: Kleurenboekstijlafbeeldingen genereren.

  • Herstyle: Wijzig de artistieke stijl van bestaande afbeeldingen met behoud van de structuur.

Alle gegenereerde afbeeldingen worden geretourneerd in RGB8-indeling via ImageBuffer-objecten . De API bevat ingebouwde filters voor inhoudsveiligheid en ondersteunt aanpasbare generatieparameters.

Eenvoudige generatie van tekst-naar-afbeelding
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");
    }
}
Nieuwe API's voor 2.0-experimenteel3

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's in vergelijking met 2.0-experimenteel2:

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
Bugfixes
  • De berekening van het begrenzingsvak is opgelost wanneer tekst wordt gedraaid. In sommige gevallen heeft de OCR-tekst die overeenkomt binnen afbeeldingen onnauwkeurige of lege regiogrenzen gerapporteerd toen de tekst werd geroteerd.

Versie 2.0 Experimenteel 2 (2.0.0-Experimenteel2)

Uitgebracht: 6 november 2025

Belangrijk

Als u eerder Windows App SDK 2.0 Experimenteel 1 hebt geïnstalleerd, volg de NuGet Uninstall-gids om het Microsoft.WindowsAppSDK NuGet-metapakket met versie 2.0.250930001-experimental1 uit uw project te verwijderen en de bijbehorende WinAppSDK-componentpakketten van die release te verwijderen voordat u deze nieuwe versie probeert, aangezien het eerder uitgebrachte experimentele pakket een hoger versienummer heeft dan de huidige.

App-inhoud zoeken

De AppContentIndexer-API's stellen ontwikkelaars in staat om app-inhoud efficiënt te indexeren, inclusief tekst en afbeeldingen voor snelle en relevante ophaalbewerking. Door zowel lexicale (trefwoorden) als semantische zoekopdrachten (op basis van betekenis) te ondersteunen, kunnen deze API's snelle, relevante resultaten leveren op basis van gebruikersintentie en context in plaats van alleen exacte trefwoorden.

Met deze mogelijkheid worden de volgende geavanceerde scenario's ontgrendeld:

  • Semantisch zoeken
    Apps kunnen resultaten retourneren op basis van intentie en betekenis in plaats van exacte trefwoordovereenkomsten.
    Voorbeeld: Een query voor 'projecttijdlijn' kan inhoud weergeven die 'planning' of 'leveringsdatums' vermeldt, zelfs als die exacte woorden niet zijn gebruikt.
  • Retrieval-Augmented Generation (RAG)
    Geïndexeerde inhoud kan fungeren als een knowledge base voor generatieve AI-modellen. Wanneer een gebruiker een vraag stelt, haalt de app de meest relevante documenten of fragmenten op uit de index en voert deze in het model in, waardoor nauwkeurige, contextbewuste reacties in echte gegevens worden ingeschakeld.
Windows ML-modelcatalogus

Met de Windows ML-modelcatalogus-API's kan uw app of bibliotheek grote AI-modelbestanden dynamisch detecteren en downloaden vanuit uw eigen online modelcatalogus, waardoor deze grote bestanden niet rechtstreeks met uw app of bibliotheek hoeven te worden verpakt. De modelcatalogus zorgt ervoor dat apparaatcompatibiliteit wordt gegarandeerd door modellen te filteren en alleen modellen te downloaden die van toepassing zijn op het specifieke Windows apparaat dat wordt gebruikt.

Permanente bestands- en maplocaties

De nieuwste Microsoft.Windows.Storage.Pickers-update stroomlijnt de selectie van bestanden en mappen door ontwikkelaars de eerste en permanente maplocaties te laten instellen en door bestandstypefilters met duidelijke labels te groeperen voor eenvoudigere navigatie.

Relatieve positie van pop-ups

De PopupAnchor API biedt DesktopPopupSiteBridge nu de mogelijkheid tot relatieve positionering door te verankeren aan het eigen venster of eiland, waardoor de beperking wordt verholpen dat pop-ups alleen absoluut konden worden gepositioneerd met schermcoördinaten.

Invoerroutering voor SystemVisual ContentIslands

Met InputUnderlyingWindowController de API kunnen ontwikkelaars de doel-HWND aanwijzen voor het ontvangen van invoerberichten die oorspronkelijk zijn verzonden naar een ContentIsland dat is gemaakt op basis van een SystemVisual (zie ContentIsland.CreateForSystemVisual).

Flexibele plaatsing van systeemachtergrond

SystemBackdropHost maakt het mogelijk om een systeemachtergrond (acryl/mica) overal binnen de visuele boom van een toepassing te plaatsen.

XAML-indeling sequentiële positionering

Het WrapPanel is een WinUI XAML-indelingspaneel dat onderliggende elementen in een opeenvolgende positie van links naar rechts rangschikt, items die de regel overlopen, worden automatisch onderbroken naar de volgende regel aan het einde van het deelvenster met de inhoud. Het is handig voor responsieve indelingen.

Dit is een overdracht van de bestaande Windows Community Toolkit-besturingselement.

Nieuwe API's voor 2.0-experimenteel2

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's in vergelijking met 2.0 experimentele1:

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
Bekende problemen
  • AppContentIndexer API's moeten worden aangeroepen vanuit een achtergrondthread. Het gebruik ervan in de UI-thread kan vastlopen of leiden tot lange pauzes die van invloed zijn op de gebruikerservaring.
  • Queryresultaten met AppIndexQuery.GetNextTextMatches en AppIndexQuery.GetNextImageMatches zijn null wanneer er geen overeenkomsten zijn, in plaats van een lege lijst.
  • Afbeeldingsovereenkomsten die gebaseerd zijn op OCR-waarden en AppManagedImageQueryMatch.Subregion gebruiken, kunnen af en toe onnauwkeurig zijn, met name wanneer de tekst wordt gedraaid of scheef is.
  • Afbeeldingsovereenkomsten met behulp van AppManagedImageQueryMatch.Subregion kunnen soms nul- of extreem kleine rechthoeken bevatten, wat leidt tot onnauwkeurige resultaten.
  • Een lege query van AppContentIndex.CreateQuery kan een uitzondering veroorzaken.

Versie 2.0 Experimenteel 1 (2.0.0-Experimenteel1)

Uitgebracht: 2 oktober 2025

Ai op apparaat gebruiken met Windows AI-API's

Belangrijk

Voor de onderliggende ML-modellen die vereist zijn voor deze API's, moet uw apparaat momenteel de nieuwste Windows 11 Insider Preview-build uitvoeren op het Dev-kanaal. Bovendien vereisen deze API's dat uw apparaat een Copilot+ PC is. Zie Copilot+ ontwikkelaarshandleiding voor pc's voor meer informatie over deze apparaten. API's genereren een uitzondering wanneer ze worden aangeroepen op apparaten die niet over de benodigde ondersteuning beschikken.

De Windows App SDK bevat geavanceerde Windows AI-mogelijkheden, waardoor ontwikkelaars intelligente functies naadloos kunnen integreren in hun toepassingen. Deze verbeteringen omvatten lokale AI-functies, zoals reageren op binnenkomende prompts, het herkennen van tekst in afbeeldingen, het beschrijven van de inhoud van afbeeldingen, het extraheren van objecten uit afbeeldingen en meer.

Raadpleeg de Ontwikkeling Verantwoordelijke AI-toepassingen en -functies op Windows richtlijnen voor informatie over verantwoorde ontwikkelprocedures die worden gebruikt tijdens het maken van de Windows AI-API's, die ook kunnen worden toegepast bij het maken van ai-ondersteunde functies.

Microsoft Windows ML

Met de Windows ML modelcatalogus-API's kan uw app of bibliotheek grote AI-modelbestanden dynamisch downloaden uit uw eigen online modelcatalogus zonder deze grote bestanden rechtstreeks met uw app of bibliotheek te verzenden. Daarnaast helpt de modelcatalogus te filteren welke modellen compatibel zijn met het Windows apparaat waarop het wordt uitgevoerd, zodat het juiste model naar het apparaat wordt gedownload.

Belangrijkste voordelen:

  • Catalogussen toevoegen: Een of veel online catalogi toevoegen
  • Compatibele modellen detecteren: automatisch modellen zoeken die werken met de hardware- en uitvoeringsproviders van de gebruiker
  • Modellen downloaden: Modellen downloaden en opslaan uit verschillende bronnen
  • Modellen delen tussen apps: als meerdere toepassingen dezelfde catalogusbron gebruiken, worden de modellen op schijf gedeeld zonder downloads te dupliceren
Bugfixes
  • Er is een probleem opgelost in DeploymentManager, waardoor packageInstallRequired in sommige gevallen onjuist werd gerapporteerd.
Nieuwe API's

Deze release bevat de volgende nieuwe en gewijzigde experimentele API's:

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