viktig information om Windows App SDK 2.0

Stöd för tillägget windows.diagnosticServiceModule package-manifest har lagts till. Fristående .NET MSIX-appar kan använda det här tillägget för att deklarera diagnostikmoduler, vilket gör att Windows Felrapportering kan läsa in dem och samla in åtgärdsbara kraschdumpar.

Nya AppContentIndex API:er är nu tillgängliga som en funktion med begränsad åtkomst (LAF) för appar som har fått en LAF-token. Med dessa API:er kan appar tillhandahålla text- och bildinnehåll för indexering och fråga efter innehållet med hjälp av lexikal matchning och, på NPU-aktiverade enheter som stöds, semantisk matchning. AppContentIndex stöder scenarier för semantisk sökning och hämtningsförhöjd generering (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Åtgärdade en krasch i hanteringen av indata för popup-fönsterläge när en fokus- eller pekarhändelse bearbetades efter att popup-fönstrets island hade avvecklats. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Åtgärdade en krasch i NavigationView som kunde uppstå när storleksändring av kontrollen orsakade en negativ panel MaxHeight. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Åtgärdade ett problem där egenskapsuppsättningen som returnerades av ElementCompositionPreview.GetPointerPositionPropertySet slutade uppdateras medan pekaren var nedtryckt. (RuntimeCompatibilityChange: PointerPositionPropertySet_UpdateWhilePressed)
• Åtgärdade en krasch i NavigationView när ett expanderat objekts utfällning visades efter att objektet hade kollapsats eller återanvänts. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Åtgärdade ett snabbt felavbrott som uppstod när en KeyboardAccelerator använde en OEM- eller skiljeteckenstangent, till exempel komma, semikolon eller hakparentes, och acceleratorns kortkommandoetikett visades. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Åtgärdade ett fel som kunde orsaka ett fatalt processavslut vid avstängning av XAML i appar som kör WinUI 3 på fler än en UI-tråd. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Åtgärdade ett problem där en CommandBar utan sekundära kommandon kunde visa en tom spillknapp i bråkskala, till exempel 175%. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Ett problem som hindrade appar med hjälp av systemsammansättningsmotorn från att anropa VisualInteractionSource.CreateFromIVisualElementhar åtgärdats. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Grafer för fasta effekter och SceneLighting-rendering för appar som använder systemkompositionsmotorn. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Åtgärdade att InputPointerSource.ActivationBehavior inte respekterade NoActivate vid användning av System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Markeringsbeteendet för null-indata och no-op val har åtgärdats CompositionEngine . (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Åtgärdade ett problem med anpassning av markören för upphöjda indata vid användning av systemkompositionsmotorn. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Frågor om toningsstoppsamlingar har åtgärdats ICompositionObject när systemsammansättningsmotorn används. (RuntimeCompatibilityChange: N/A, korrigering av operativsystemsammansättning)
• Åtgärdade beteendet för ContentExternalOutputLink kant och bakgrund vid användning av systemkompositionsmotorn. (RuntimeCompatibilityChange: N/A, korrigering av operativsystemsammansättning)
• Åtgärdade åtkomsten till VisualReferenceController vid användning av System Composition Engine. (RuntimeCompatibilityChange: N/A, korrigering av operativsystemsammansättning)
• Ett registreringsproblem som kan uppstå vid installation av Windows App SDK har åtgärdats. (RuntimeCompatibilityChange: N/A, korrigering av distributionsregistrering)
• Åtgärdade ett problem där Video Super Resolution kunde misslyckas vid initiering eller inferens med det uppdaterade ONNX Runtime-beroendet. (RuntimeCompatibilityChange: N/A, uppdatering av beroendekompatibilitet)

Den här versionen innehåller följande nya API:er jämfört med 2.4.0-versionen:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

WinUI 3-appar har nu stöd för styrplatte- och mushaptik via Windows.Devices.Haptics, tillsammans med enfingerspanorering på styrplattan, när det stöds av operativsystemet och maskinvaran. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• En krasch som kunde inträffa när en touch- eller pennkontakt lämnade ett rullningsbart område vid en exakt tidpunkt har åtgärdats. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Ett problem har åtgärdats där lagringsväljare (FileOpenPicker, FileSavePickeroch FolderPicker) lämnade det anropande WinUI-appfönstret utan tangentbordsfokus när fildialogrutan stängdes. Appen återställer nu sitt tidigare fokus när dialogrutan har stängts. Mer information finns i GitHub problem #6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Åtgärdade en regression där MrmGetFilePathFromName returnerade ERROR_FILE_NOT_FOUND när PRI-filen inte fanns, i stället för den dokumenterade reservsökvägen. Mer information finns i GitHub problem #5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Ett problem där MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY kunde ärvas av underordnade processer, vilket störde MRT Core och kataloguppslag, har åtgärdats. Mer information finns i GitHub problem #5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Ett problem har åtgärdats där LanguageModel en allmän Error status returnerades för språk som inte stöds eller felmatchade indata- och utdataspråk. Dessa villkor returnerar LanguageModelResponseStatus.UnsupportedLanguage nu respektive LanguageModelResponseStatus.LanguageMismatch. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Åtgärdade en krasch när appar som använde System Composition Engine anropade VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, korrigering av operativsystemets kompositionsbrygga)
• Korrigerade åtkomstmodifieraren för den genererade hjälpmetoden för C#-startpunkten när DISABLE_XAML_GENERATED_MAIN har definierats. Mer information finns i GitHub problem #11245. (RuntimeCompatibilityChange: N/A, ändring av build-time-verktyg)

Den här versionen innehåller följande nya API:er jämfört med 2.3.1-versionen:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Har lagt till Structured JSON Output API (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync), som genererar svar från språkmodellen som följer ett JSON-schema som anroparen tillhandahåller. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

API:t XamlOptionalChanges har lagts till, vilket gör det möjligt för appar att aktivera valfria icke bakåtkompatibla ändringar före XAML-initialisering. Mer information finns i GitHub PR microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Ändrade beteendet för förprocessorkonstanten DISABLE_XAML_GENERATED_MAIN så att den, när den definieras, nu byter namn på den genererade main() metoden (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) i stället för att ta bort den helt. På så sätt kan en anpassad main() metod anropa standardimplementeringen.

CompositionEngine-API:et har lagts till som en instabil funktion med begränsad åtkomst (LAF), vilket gör det möjligt för appar att välja att använda operativsystemet som motor för kompositions-API:erna. (RuntimeCompatibilityChange: CompositionEngine_API)

NPU-identifiering har åtgärdats, cpu-stöd har lagts till och prestanda för Video Super Resolution har förbättrats. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Åtgärdade uppräkningen av provider för körning i vissa scenarier. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• ARM64EC stöd för Windows ML har lagts till.

IntelliSense-dokumentationen har lagts till för stabila API:er i Microsoft.WindowsAppSDK.AI NuGet-paketet.

Flera av optimeringarna nedan måste aktiveras uttryckligen. Om du vill aktivera dem anger du det angivna XamlChangeId som anges i varje objekt.

• Nya optimerade XamlControlsResources stilar har lagts till, inklusive en optimerad mall för ScrollBar. DefaultStyleOptimizations Använd XamlChangeId för att välja dessa formatmallar. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon och BitmapIcon undviker att infoga ett extra Grid i det visuella trädet för appar som väljer att använda IconNoGridOptimization XamlChangeId. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Slutade läsa in Style egenskapsuppsättningar som inte tillämpar något värde. OptimizeApplyStyles Använd XamlChangeId för att anmäla dig. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• Fördröjde tillämpningen av stilarna FrameworkElement och Control tills elementet är i trädet. OptimizeApplyStyles Använd XamlChangeId för att anmäla dig. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Optimerad CommandBar initiering genom att inte längre läsa in hela tillståndshanteraren för visuella objekt. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Förbättrad prestanda vid tillägg i CommandBarFlyoutPrimaryCommands och SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Använde en mer högpresterande hash-tabell för ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Optimerade bort en resursnyckelsträngskopiering och jämförelse vid inläsning av uppskjutna resurser. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Förbättrade prestanda för ThemeResource sökningar genom att minska strängjämförelserna. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Förbättrad CPU-prestanda vid uppslagning av XAML-temaresurser genom att minska omkostnaderna för hashning av resursnycklar. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Förbättrad CPU-prestanda för vanliga interna XAML-typkontroller på UIElement och FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Förbättrad CPU-prestanda i interna sökvägar i aktiveringsfabriken. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Förbättrad prestanda för avkodnings heltal som lagras i XBF-filer. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Minskade heap-allokeringar vid uppstart och trädtraversering genom att reservera minne för vektorer och optimera en RAII-hjälpfunktion. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Förbättrade prestanda genom att reservera utrymme i spårningssamlingar innan du lägger till flera objekt. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Optimerade bindningar för egenskaper i XamlUICommand. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Bättre prestanda vid bindningar XamlUICommandsom inte definierar tangentbordsacceleratorer. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• Initierade egenskapen TintLuminosityOpacity i markeringen för AcrylicBrush-objekt med standardstil i stället för i kod, vilket undviker framtvingad materialisering. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Undvik onödig standardinitiering ContextFlyout på TextBlock och RichTextBlock när du anger eller lämnar elementträdet. DeferContextFlyoutInit Använd XamlChangeId för att anmäla dig. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Minskade väntetider vid start på grund av Direct3D-låskonflikter genom att registrera XAML:s händelse för borttagning av D3D-enhet under skapandet av en bakgrundsenhet i stället för senare på UI-tråden. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Tog bort en onödig registrering av strömaviseringar från RefreshRateInfo, vilket minskar belastningen vid uppstart. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Tog bort ett överflödigt version.dll beroende från WinUI-startvägen genom att beräkna den loggade körningsmiljöversionen vid kompileringstillfället. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Åtgärdade en "use-after-free"-krasch i CPopupRoot::ReplayPointerUpdate när ett popup-fönster stängs synkront under uppspelning av pekarhändelser. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Åtgärdade en åtkomstöverträdelse i CXamlIslandRoot::GetScreenOffset som utlöstes av återinträdesfrågor från UI Automation under nedmontering av XAML-island. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Åtgärdade en krasch i ModernCollectionBasePanel där en viewport-spårad container eller sidhuvud som återanvändes av en layoutomgång i ett syskonelement kunde lämna en inaktuell ankarreferens som utlöste en fail-fast-mekanism vid nästa mätning. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Åtgärdade ett snabbt felavbrott i CPopup::RemoveChild när en ToolTip-stängning pumpade meddelanden och återinträdde i stängningsvägen. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• En krasch vid återinträde har åtgärdats i CXcpDispatcher när en Popup-destruktor utlöste UIADisconnectAllProviders med aktiva UI Automation-klienter. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Åtgärdade en krasch när en kaskadmeny eller AutoSuggestBox en timer för fördröjd öppning utlöstes efter att den associerade ön eller dispatchern hade börjat avvecklas. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Åtgärdade en potentiell krasch av typen use-after-free vid avladdning av DLL när COM-pekare i anpassade metadatatyper inte frigjordes korrekt. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Åtgärdade en krasch vid öppning av en Popup från ett CompositionTarget.Rendering-återanrop på grund av återinträde i dispatchern vid fokusändringar. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Åtgärdade en krasch i MediaPlayerPresenter när GPU-enheten kopplas från under hantering av medieuppspelningshändelser. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Åtgärdade ett potentiellt åtkomstfel i Direct2D:s textåtergivning vid återställning efter enhetsbortfall under uppbyggnad av en glyfkörningstextur. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Åtgärdade en krasch i CFocusRectManager::FindFocusRectHost när fokus hamnar på en kontroll som finns inline via InlineUIContainer i RichTextBlock eller TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Åtgärdade en krasch som upprepade gånger kunde få backgroundTaskHost.exe att krascha när en bakgrundsaktivitet inte hade något lagrat CLSID, och lade till smidig hantering när CoCreateInstance misslyckas. Mer information finns i GitHub problem #5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Fasta utfällbara fönster och utfällbara fönster som verkar feljusterade (ungefär en objekthöjd ovanför det överordnade objektet) för sidoplaceringar när de öppnas uppåt nära skärmens nederkant. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• En krasch (null-dereference LayoutState ) har åtgärdats i UniformGridLayout och FlowLayout som kan inträffa när en samlingsändring aktiverades på en ItemsRepeater som inte längre lästes in. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Åtgärdade ApplicationData.GetForUnpackaged().LocalSettings() att en registernyckel öppnades på fel sökväg (HKCU\SOFTWARE\publisher\product i stället för HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product), vilket är en roaming-plats snarare än en lokal plats på datorn. Mer information finns i GitHub problem #6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Ett kapplöpningstillstånd i hanteringen av modifierartillstånd för tangentbord som kunde krascha appar vid samtidig inmatning från flera UI-trådar har åtgärdats. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• En AppxSvc-krasch som kan inträffa under paketinstallation, uppdatering eller avinstallation har åtgärdats. (RuntimeCompatibilityChange: N/A, korrigering för krasch i tjänstvärden)

Den här versionen innehåller följande nya API:er jämfört med 2.2.0-versionen:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

API:et Microsoft.Windows.AI.Video.VideoScaler ger videoförbättringar i realtid genom avancerad AI-skalning, optimerad för strömmar med personer i konversation. Det gör det möjligt för utvecklare att tillhandahålla skarpare, tydligare visuella objekt på konferens-, direktuppspelnings- och redigeringsplattformar, även under dåliga nätverksförhållanden. API:et stöder anpassning av utdataupplösning, bildfrekvens och intressanta regioner, med kompatibilitet för flera videoformat, inklusive BGR, RGB och NV12.

VideoScaler är disponibel och innehåller en funktionskontroll så att appar kan verifiera VSR-stöd vid körning. Explicit Windows ML-initiering krävs inte.

Ett nytt Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged()-API ger uppackade appar en förstklassig WinRT-startpunkt till programdata per användare/per dator, vilket matchar den yta som tidigare endast var tillgänglig för paketerade appar. Detta förenklar framtida paketerad↔uppackad migrering och tar bort behovet av Registry-API lösningar.

Lade till överlagringar för att ange värden utan boxing i XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) och exponerade beroendeegenskapen Setter.ValueProperty.

• Åtgärdade en krasch i RenderTargetBitmap när målelementet lämnar det visuella trädet (till exempel om ett popup-fönster stängs) innan PreCommit slutförs. RenderAsync returnerar nu E_ABORT i stället för att krascha. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Åtgärdade en krasch på grund av use-after-free i ScrollView när kontrollen förstörs medan timerns tick för att dölja indikatorer fortfarande väntar. Mer information finns i GitHub problem #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• En potentiell krasch i Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate som orsakades av försök att komma åt ett objekt som schemalagts att friges har åtgärdats. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Åtgärdade ett problem där Microsoft.UI.System.ThemeSettings kunde krascha en app om den förstördes i en bakgrundstråd (till exempel när den förstördes av .NET skräpinsamlare). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Åtgärdade en krasch som kunde inträffa på vissa enheter när aktiva beröringspunkter avbröts av inmatningsenheten, till exempel när penninmatning tar över. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
• Åtgärdade ett problem där glesa paketerade appar inte kunde identifiera modulspecifika PRI-filer. Mer information finns i GitHub problem #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• En bugg för strängägarskap har åtgärdats när Flat-C Windows ML-katalog-API:et används. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Ett potentiellt problem har åtgärdats i Windows ML under processens avstängning. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Åtgärdade potentiella problem med COM-initiering och avslutning i Windows ML. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

Den här versionen innehåller följande nya API:er jämfört med 2.1.3-versionen:

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

Förbättrar hur TitleBar avgör vilka delar av TitleBar.Content som kan dras och lägger till API:er som ger utvecklare explicit kontroll över dra regioner. Se PR microsoft/microsoft-ui-xaml#10936 och spårningsproblem #10421.

Vad har ändrats

• Nytt standardbeteende – Ramverket går nu rekursivt i det visuella trädet och utesluter automatiskt endast interaktiva kontroller från dragregionen. Tomma luckor och icke-interaktiva visuella objekt kan dras som standard, utan att det krävs några markeringsändringar.
• Nya API:er för explicit kontroll:
  • TitleBar.IsDragRegion — kopplad nullable boolesk variabel för att markera ett element som dragbart (True), klickbart (False) eller avgörs av ramverket (inte angiven).
  • TitleBar.AutoRefreshDragRegions — när True, uppdateras dragregioner automatiskt vid layoutuppdateringar.
  • TitleBar.RecomputeDragRegions() — Omberäknar dra regioner manuellt när dynamiskt innehåll har ändrats.

Varför

Anpassade namnlister blandar ofta interaktiva kontroller med icke-interaktiva visuella objekt i Grid/StackPanel layouter. Den tidigare metoden att "stansa ut hål i hela innehållsområdet" lämnade oväntade icke-dragbara luckor i layouter med tomma ytor, ojämna mellanrum eller dynamiska användargränssnitt.

Visuell jämförelse

Standardbeteende (tidigare) – ej dragbara mellanrum:

Det tomma mittområdet kan inte dras.

Aktuellt (nytt) beteende – luckor som kan dras, interaktiva kontroller exkluderas:

Det tomma utrymmet kan dras. interaktiva kontroller är korrekt exkluderade. (RuntimeCompatibilityChange: TitleBar_ContentDragRegions)

Low-Rank Adapter-API:et (LoRA) för Phi Silica har nu blivit stabilt.

Med LoRA kan utvecklare finjustera phi silica-språkmodellen på enheten med sina egna anpassade data och justera utdata för specifika scenarier som ekonomi, medicin och utbildning. Läs in en adapter med LanguageModelLowRankAdapter.CreateFromPath och skicka den via LanguageModelOptions.LowRankAdapter när du anropar GenerateResponseAsync. Mer information finns i Phi Silica LoRA .

Med ett nytt API för AICapabilities.HasAICapability kan program från tredje part avgöra om enheten är en Copilot+ PC.

Versionen av ONNX Runtime har uppdaterats till 1.24.6. Mer information finns i ONNX Runtime-versioner .

• Stöd har lagts till för flera körningsleverantörer i ett och samma MSIX-paket. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Stöd har lagts till för att upptäcka exekveringsproviders som levereras som ramverkspaket. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Läge för val av exekveringsprovider har lagts till för flexibla driftsättningskonfigurationer. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Åtgärdade en minnesläcka i ItemsRepeater där återanvända element aldrig skräpsamlades på grund av en referenscykel via RecyclePool, vilket också kunde orsaka krascher i InvalidateChildrenMeasure. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Åtgärdade en krasch där en implicit återanropsfunktion för slutförandet av en visa/dölj-animering kunde få åtkomst till en förstörd CUIElement, vilket orsakade en åtkomstöverträdelse. Återanropet använder nu en svag referens för att på ett säkert sätt hantera situationen där elementet förstörs innan animeringen slutförs. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
• Ett problem har åtgärdats där popup-fönsterinnehåll som öppnades i en XAML-ö inte följde OverrideScale, vilket ledde till att innehållet var överdimensionerat och klippt. Mer information finns i GitHub problem #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• Åtgärdade en felsnabb krasch som orsakades av återutskick under com-lanseringsåtgärder mellan lägenheter i UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: Fast tvetydig modulsökning när flera moduler med samma namn läses in i samma process. GetModuleHandleW har ersatts med GetModuleHandleExW så att rätt modul löses upp via adress. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Åtgärdade en krasch på grund av heltalsdivision med noll i UniformGridLayout::GetMajorSize när en ItemsRepeater läggs ut inom en tillgänglig bredd som är smalare än ett objekts sekundära steg. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• En potentiell krasch har åtgärdats när ett paket har avinstallerats innan det bearbetades. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Ett problem har åtgärdats där GetReadyState felaktiga felkoder (till exempel DisabledByUser eller NotSupportedOnCurrentSystem) kunde returneras när nödvändiga paket ännu inte har distribuerats. API:et rapporterar NotReady nu korrekt i det här scenariot, vilket förbättrar diagnostisk klarhet. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Förbättrad intern prestandadiagnostik för LanguageModel.GenerateResponseAsync att bättre identifiera svarstidskällor innan den första token returneras. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Åtgärdade ett problem där XAML-kompilatorfel försvann utan meddelande vid användning av dotnet build, som bara visar MSB3073: exited with code 1 i stället för de faktiska felmeddelandena. Mer information finns i GitHub problem #9813. (RuntimeCompatibilityChange: N/A, ändring i XAML-kompilatorverktygen vid kompilering)
• Åtgärdade ett problem där Microsoft.Windows.Workloads.dll inte kunde läsas in på Windows versioner före 22000 på grund av statisk import av API:er för dynamiska beroenden som inte var tillgängliga för dessa OS-versioner. Funktionerna löses nu dynamiskt, så fel på os-versioner som inte stöds visas som vanligt HRESULT i stället för en dialogruta med inläsningsfel. (RuntimeCompatibilityChange: N/A, ingen inkapsling)

Den här versionen innehåller följande nya API:er jämfört med 2.0.1-versionen:

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Windows App SDK 2.0 är den första versionen av det nya Windows App SDK versionsschemat, som är standardiserat på Semantic Versioning 2.0.0. Det här är också första gången vi ökar huvudversionsnumret.

Det nya schemat förenklar versionshantering genom att justera Windows App SDK version med NuGet-paketversionen. Att referera till Windows App SDK 2.0 i projektet innebär nu att du använder motsvarande NuGet-version, utan något separat datumbaserat versionsnummer för att spåra:

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

Paketfamiljenamnet överensstämmer också med huvudversionen i stället för delversionen, så nästa sida vid sida-version av Windows App SDK blir version 3.0.0. Under SemVer tillåts icke-bakåtkompatibla ändringar endast i större versionsuppdateringar (se Windows App SDK distributionsarkitektur).

NuGet-paketet Microsoft.WindowsAppSDK.ML har omstrukturerats, vilket lägger till ett nytt basberoende. Det befintliga ML NuGet-paketets funktioner förblir desamma, men de grundläggande Windows ML-funktionerna har omstrukturerats till ett baspaket som heter Microsoft.Windows.AI.MachineLearning. Det här nya paketet innehåller en minimal uppsättning beroenden. stöd för appar ned till Windows 10 v1903. Om du behöver stöd för Windows 10 v1809 fortsätter du att använda det befintliga Microsoft.WindowsAppSDK.ML-paketet.

ONNX Runtime. Versionen av ONNX Runtime som ingår i Windows ML har uppdaterats till 1.24.5. Mer information finns i ONNX Runtime-versioner . Den här versionen innehåller också en additiv ORT API-ändring för att stödja modellkompilering med hjälp av grafer som skapats av API:et OrtModelEditor (ett funktionsgap i den tidigare OrtCompileApi ytan). Ändringen är som inte bryter och har gjorts för att avblockera kommande WebNN-webbläsarscenarier; se den relevanta ONNX Runtime PR #27332 för mer information.

Licensiering Licensavtalet för Windows ML har förenklats med tydligare villkor för ISV:er:

• Omstrukturerade avsnitt för installation, data och distribuerbar kod för tydlighetens skull.
• Ett nytt avsnitt om efterlevnadsmeddelande för exekveringsleverantör (EP) klargör utvecklarnas ansvar när det gäller maskinvaruaccelererade exekveringsleverantörer.
• Direktlänkar till leverantörslicensavtal för NVIDIA TensorRT, Intel OpenVINO och Qualcomm QNN (Qualcomm Neural Network SDK).

• Phi Silica-API:er tillämpas nu som en del av en funktion för begränsad åtkomst (LAF). Mer information finns i Phi Silica .
• Har lagt till nya tillstånd till AIFeatureReadyState för att hjälpa appar att förklara tillfälliga och varaktiga fel under AI-modellens förvärvsprocess: CapabilityMissing, NotCompatibleWithSystemHardware och OSUpdateNeeded. Appar kan använda dessa tillstånd för att ge användarna användbar vägledning i stället för att behandla varje "inte redo"-villkor som ett allmänt fel.
• Kontroller har lagts till för olika nätverks- och Windows Update fel under AI-modellinstallationen, vilket flaggar varaktiga fel så att användarna kan förstå varför modellpaketen inte kunde installeras.
• Förbättrad diagnosbarhet för API:er för textinformation som används i Windows AI-scenarier.

Aktiverat dra-stöd för WebView2-innehåll som finns i WinUI 3-program. Den här funktionen stöds tidigare inte och är nu tillgänglig utan att nya offentliga API:er introduceras. Det var redan möjligt att släppa till en WebView2-kontroll från externa källor.

Scenarier som stöds:

• Standardinnehåll för dra och släpp. Det finns stöd för att dra text, HTML, bilder och URL:er. Om du drar en bild utanför appen resulterar det för närvarande i ett standardfilnamn (till exempel download.jpg) när den släpps i Utforskaren.
• Avbryt dra-åtgärd Annullering på begäran av en aktiv dragåtgärd stöds, så en app kan villkorligt blockera dragåtgärder för begränsat eller tillfälliga innehåll efter att dra har initierats.
• Anpassade dragvisualiseringar. Anpassat dra-användargränssnitt, till exempel ikoner eller förhandsversioner, stöds för att hjälpa användarna att tydligt identifiera innehållet som dras.
• Anpassningsbara dra data. Du kan redigera och anpassa dragningsdata, vilket stöder appspecifika scenarier som att dra meddelanden inom appen eller bifoga kontextuella metadata (till exempel "Från <appnamn>") som målpunkt kan läsa vid släpp.

Limitations:

• Vissa ytterligare dra-och-släpp-datatyper stöds inte för närvarande, inklusive DownloadURL.

Krav:

• Minsta WebView2 Runtime-version (Edge Beta-kanal): 144.0.3719.11.

API:et Microsoft.Windows.Storage.Pickers (introducerades i Windows App SDK 1.8) har utökats för att effektivisera fil- och mappval genom att låta utvecklare ange inledande och beständiga mappplatser och gruppera filtypfilter med tydliga etiketter för enklare navigering.

• FileOpenPicker lägger till FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFolderoch Title.
• FileSavePicker lägger till InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, SuggestedStartFolderoch Title.
• FolderPicker lägger till PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, SuggestedStartFolderoch Title.

• Relativ placering av popupfönster. Det nya PopupAnchor API:et gör det möjligt DesktopPopupSiteBridge att stödja relativ positionering genom att förankra till sitt ägande fönster eller sin egen ö, vilket tar itu med begränsningen där popup-fönster bara kunde placeras absolut med hjälp av skärmkoordinater. Nya DesktopPopupSiteBridge.AnchoringBehavior egenskaper och DesktopPopupSiteBridge.AnchoringPixelAlignment egenskaper styr förankringsbeteendet.
• Vägledning för tangentbordsindikationer. Den nya InputFocusController.ShouldShowKeyboardCues egenskapen vägleder utvecklare om de vill visa tangentbordssignaler direkt efter skapandet av en ContentIsland.
• Bekvämlighets-API för PointerPoint. Med den nya PointerPoint.GetCurrentPoint metoden kan utvecklare hämta aktiva PointerPoint data från en angivet pointerId.

Den nya Microsoft.UI.Xaml.Controls.SystemBackdropElement är en lätt FrameworkElement som gör att appar kan placera en systembakgrund som Mica eller Akryl var som helst i XAML-layouten, med en egenskap CornerRadius för rundade bakgrundsområden. Det stänger ett långvarigt WinUI 3-mellanrum, där akryleffekter i appen (tidigare okomplicerade i WinUI 2 via AcrylicBrush.BackgroundSource) inte hade någon direkt motsvarighet.

Namnområdet Microsoft.Windows.Management.Deployment lägger till ett ramverk för paketverifiering och ett PackageVolume API för hantering av lagringsvolymerna som paketen mellanlagras till.

• Validerare. Nytt IPackageValidator gränssnitt plus tre inbyggda validatorer (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator) som kan kopplas tillAddPackageOptions / StagePackageOptionsvia den nya PackageValidators egenskapen. PackageValidationEventArgs, PackageValidationEventSource och PackageValidationHandler hanterar valideringshändelser; IsPackageValidationSupported och GetValidationEventSourceForUri låter anropare sondera stöd innan distributionen anropas.
• PackageVolume. Ny PackageVolume typ med GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, , SetOnlineAsyncoch IsFeatureSupported för körningsfunktionsidentifiering (PackageVolumeFeature).

Det nya IXamlCondition gränssnittet gör det möjligt för utvecklare att definiera anpassade villkor som integreras med XAML:s syntax för villkorsstyrd namnrymd och utvärderas vid XAML-parsningstid. Detta ersätter det experimentella IXamlPredicate gränssnittet. Anpassade villkor möjliggör villkorsstyrda XAML-scenarier baserat på programspecifika faktorer som funktionsflaggor, enhetsfunktioner, affärslogik, konfigurationsinställningar och andra körningsvillkor.

• Ett problem har åtgärdats där installationsprogrammet för WindowsAppSDK inte visade några framsteg under installationen, vilket gjorde att det verkade ha stannat. Installationsprogrammet ger nu tydligare feedback om förloppet.
• Förbättrad felhantering för scenarier där WindowsAppSDKSelfContained är aktiverat för klassbibliotek.
• MSB8027 och LNK4042 kompileringsvarningar orsakade av duplicerade ClCompile objekt i Windows App SDK NuGet .targets filer genom att flytta förprocessordefinitioner från <Target> block till <ItemDefinitionGroup>. En undantagslösning (WindowsAppSDK_Arm64EcCompilerWorkaround) ingår för ARM64EC+LTCG-versioner för att undvika ett känt internt MSVC-kompilatorfel.
• En ListView-krasch som kunde inträffa under tangentbordsnavigering (Tab/Skift+Tab) efter att objektlistan uppdaterades har åtgärdats.
• Åtgärdade ett problem där WinUI 3 kunde krascha om fokus flyttades till CoreWebView2Controller medan kontrollanten inte var synlig.
• Förbättrad DeleteIndex tillförlitlighet så att den inte längre misslyckas med ERROR_SHARING_VIOLATION i vissa scenarier (appinnehållssökning, förblir i den experimentella kanalen).
• Fasta OCR-avgränsningsrutor som returnerar negativa värden i vissa gränsfall.
• Åtgärdade en Windows ML-bugg där anrop av RegisterCertifiedAsync igen i samma process felaktigt returnerade 0 körningsproviders (EP).

Den här versionen innehåller en refaktorisering av nuget transitiva referenser. Om du vill uppgradera ett befintligt C++-projekt rekommenderar vi att du använder verktyg (nuget.exe eller Visual Studio) för att ta bort den befintliga Windows App SDK paketreferensen och lägga till den nya referensen. Det här handlar om uppgraderingsproblem med packages.config-baserade projekt.

Uppgradera från 2.0 Experimental7. Det experimentella Microsoft.WindowsAppSDK.ML-paketet levererade med ett högre patchnummer än 2.0.0 stabil, vilket kan orsaka ett NuGet-nedgraderingsfel (särskilt i C++-projekt). Om du var på Experimental7 följer du nuGet-avinstallationsguiden för att ta bort det experimentella paketet innan du refererar till 2.0.0.

• Appinnehållssökning är fortfarande experimentellt. API-ytan Microsoft.Windows.Search.AppContentIndex (appinnehållssökning) togs bort i 2.0-Preview2 för att förbättra grunderna och säkerställa framtida kompatibilitet. Den ingår inte i stabil version 2.0.1. Om du vill experimentera med det fortsätter du att använda experimentella versioner. Om du tidigare har installerat det experimentella Microsoft.Windows.Search-paketet avinstallerar du det via NuGet Uninstall guide innan du går över till 2.0.1 stabilt.
• API:er som redan levererats i 1.8-service. Vissa experimentella funktioner som förhandsgranskades under 2.0-cykeln befordrades till stabila API:er i 1,8 serviceversioner och är därför inte nya i 2.0.1. De inkluderar ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) och SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer (1.8.6). Mer information finns i versionsanteckningarna för 1.8.

• AICapabilities saknas från 2.0.1. Microsoft.Windows.AI.AICapabilities och AICapabilityCategory.CopilotPlusPCCapable (en Copilot+ PC-funktionskontroll) släpptes i 1.8.7 men inkluderades inte i 2.0.1. Vi planerar att återställa dem i majversionen.

Den här versionen innehåller följande nya API:er jämfört med den stabila versionen 1.8.7:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Controls

    SystemBackdropElement

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

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

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

NuGet-paketet Microsoft.WindowsAppSDK.ML har omstrukturerats och lagt till ett nytt basberoende. Det befintliga ML NuGet-paketets funktioner förblir desamma, men de grundläggande Windows ML-funktionerna har omstrukturerats till ett basberoende paket som heter Microsoft.Windows. AI. MachineLearning. Det här nya paketet innehåller en minimal uppsättning beroenden, men på C#/WinRT eller C++/WinRT stöder det bara ned till Windows 10 18362. Om du behöver stöd för Windows 10 17763 använder du det befintliga Microsoft.WindowsAppSDK.ML-paketet.

För nya transitiva beroenden rekommenderar vi att du använder verktyg för att uppgradera paketet (nuget.exe eller VS). Se även: Windows App SDK 1.6 versionsanteckningar.

Versionen av ONNX Runtime har uppdaterats till 1.24.4. Mer information finns i ONNX Runtime-versioner .

Tvingade fram att Phi Silica-API:er ska vara en del av en funktion för begränsad åtkomst.

Kontroller har lagts till för olika nätverks- och Windows Update fel under AI-modellinstallationen, vilket flaggar varaktiga fel så att användarna kan förstå varför modellpaketen inte kunde installeras.

Förbättrad diagnosbarhet för API:er för textinformation som används i Windows AI-scenarier.

Appinnehållssökning har tagits bort från förhandsversionen av 2.0 medan vi arbetar för att förbättra grunderna och säkerställa framtida kompatibilitet när de underliggande AI-modellerna ändras. Under tiden fortsätter du att använda den experimentella kanalen för att prova de senaste ändringarna.

Aktiverat dra-stöd för WebView2-innehåll som finns i WinUI 3-program. Den här funktionen stöds tidigare inte och är nu tillgänglig utan att nya offentliga API:er introduceras. Obs! Släpp i WebView2 från externa källor stöds redan.

Scenarier som stöds

• Standardinnehåll för dra och släpp Det finns stöd för att dra text, HTML, bilder och URL:er. Om du drar bilder utanför appen visas ett standardfilnamn (till exempel download.jpg) när de släpps i Utforskaren baserat på det aktuella beteendet. Exempelscenario: En användare väljer text eller en bild i WebView2 och drar den antingen i appen eller till ett annat mål, till exempel Utforskaren.

• Avbryt dragning På begäran stöds avbrytning av en aktiv dragåtgärd. Exempelscenario: En app blockerar villkorligt dragåtgärder för vissa innehållstyper (till exempel begränsat eller tillfälliga innehåll) genom att avbryta dra när den har initierats.

• Anpassade visuella dra-objekt Anpassat dra-användargränssnitt, till exempel ikoner eller förhandsversioner, stöds för att hjälpa användarna att tydligt identifiera innehållet som dras. Exempelscenario: En app visar en miniatyrförhandsgranskning eller ikon medan en användare drar medieinnehåll, vilket gör det tydligt vilket objekt som för närvarande flyttas.

• Anpassningsbara dra data Du kan redigera och anpassa dra data, vilket möjliggör appspecifika scenarier som att dra meddelanden i appen (till exempel som en alternativ interaktion för vidarebefordran av meddelanden). Exempelscenario: En app anpassar dra nyttolasten så att den innehåller kontextuella metadata, till exempel det ursprungliga programnamnet. När innehållet tas bort kan målet visa eller bearbeta information som "Från <appnamn>" för att ange källan till det dragna innehållet.

Begränsningar

• Stöd för ytterligare dragningsdatatyper är begränsat. Följande format stöds inte för närvarande:
  • DownloadURL

Requirements

• Minsta WebView2 Runtime-version (Edge Beta-kanal): 144.0.3719.11

Gränssnittet IXamlCondition gör det möjligt för utvecklare att definiera anpassade villkor som integreras med XAML:s syntax för villkorsstyrd namnrymd och utvärderas vid XAML-parsningstid. Det här är en namnändring och ett slutförande av det experimentella IXamlPredicate gränssnittet. Anpassade villkor möjliggör villkorsstyrda XAML-scenarier baserat på programspecifika faktorer som funktionsflaggor, enhetsfunktioner, affärslogik, konfigurationsinställningar och andra körningsvillkor.

• MSB8027 och LNK4042 kompileringsvarningar som orsakats av duplicerade ClCompile-objekt i Windows App SDK NuGet .targets-filer har åtgärdats genom att förprocessordefinitioner flyttas från <Target> block till <ItemDefinitionGroup>. En undantagslösning (WindowsAppSDK_Arm64EcCompilerWorkaround) ingår för ARM64EC+LTCG-versioner för att undvika ett känt internt MSVC-kompilatorfel.
• En ListView-krasch som kunde inträffa under tangentbordsnavigering (Tab/Skift+Tab) efter att objektlistan uppdaterades har åtgärdats.
• Åtgärdade ett problem där WinUI 3 kunde krascha om fokus flyttades till CoreWebView2Controller medan kontrollanten inte var synlig.

Den här versionen innehåller följande nya och ändrade API:er jämfört med 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• Versionen av ONNX Runtime i Windows ML har uppdaterats till 1.24 RC
• En bugg har åtgärdats där RegisterCertifiedAsync, om den anropas igen i samma process, felaktigt returnerar 0 utförandeleverantörer (EP).

• Ny InputFocusController.ShouldShowKeyboardCues egenskap som vägleder utvecklare om de vill visa tangentbordssignaler direkt efter skapandet av en ContentIsland.
• Nytt bekvämlighets-API PointerPoint.GetCurrentPointför att göra det möjligt för utvecklare att hämta aktiva PointerPoint data från den angivna pointerId.

• Förbättrad DeleteIndex tillförlitlighet. Ibland kunde DeleteIndex misslyckas med "ERROR_SHARING_VIOLATION".

• Åtgärd för OCR-avgränsningsrutor som returnerar negativa värden i vissa gränsfall.

• Appinnehållssökning är en del av ett separat Microsoft.Windows.Search-paket i stället för att ingå i Microsoft.Windows.AI package.

• Korrigering för att prefixsökning inte fungerar med korta frågesträngar.

• Nya API:er och namnbyten baserat på officiell API-granskning.

  • AppContentIndexer
    • HämtaInnehållsobjektSomKräverOmintextering
    • Ta bort –> RemoveContentItem
    • Ta bort flera –> Ta bort innehållsposter
    • RemoveAllContentItems
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppContentIndexListener
    • IndexeringsstatusÄndrad –> InnehållsObjektStatusÄndrad
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • SenasteResultatÄndrats –> ResultatÄndrat
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • SenasteResultatÄndrats –> ResultatÄndrat
  • AppManagedImageQueryMatch
    • Underregion –> Intresseområde
  • InnehållsPostStatusResultat
    • Omintexeringsstatus * Innehållsobjektets omintexeringsstatus
  • TextFrågeSessionResultat
    • IsValid
  • BildförfrågningssessionResultat
    • IsValid
  • QueryContentItemsFilterFlags

• Ett problem har åtgärdats där installationsprogrammet för WindowsAppSDK inte visade några framsteg under installationen, vilket gjorde att det verkade ha stannat. Installationsprogrammet ger nu tydligare feedback om förloppet.
• Förbättrad felhantering av scenarier där WindowsAppSDKSelfContained är aktiverat för klassbibliotek.

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 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

• Med nya API:er för AIComputeDevice kan appar välja standardenheten, CPU eller NPU när de skapar en TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice anger samma enhetspreferens för OCR som utförs vid bildindexering i App Content Index.
• AI Speech använder nu SpeechRecognitionModelFactory och SpeechRecognitionModelFactoryOptions för att konfigurera och skapa taligenkänningsmodeller. Ljudindatametoder accepterar nu 16-bitars exempelbuffertar, kontinuerlig igenkänning stoppas asynkront och händelser för direktuppspelningsigenkänning exponerar providerspecifika egenskaper.
• LanguageModel.ModelName, LanguageModel.ModelVersion och LanguageModelLowRankAdapterStatus låter appar identifiera den installerade språkmodellen och inspektera kompatibilitetsresultatet när de läser in ett kort med låg rangordning.
• LanguageModelResponseStatus.BlockedByGameMode och LanguageModelResponseStatus.LowOnVram identifierar svar som inte kunde slutföras eftersom spelläget var aktivt eller tillgängligt videominne var lågt.

Med det nya experimentella FrameworkElement.SetThemeResourceBinding-API :et kan appar skapa motsvarigheten till en {ThemeResource} bindning från kod. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

En ny experimentell DataTemplate-konstruktor accepterar en apptilldelad delegat som skapar mallens elementunderträd. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

Den experimentella TableView-kontrollen är nu tillgänglig i de offentliga WinMD:erna. Den stöder gruppering med mallade grupprubriker, sortering och filtrering med kolumnhuvudsorteringsindikatorer, storleksändring av pekare och tangentbordskolumner samt valfria knappbeskrivningar för celler och kolumnrubriker. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Den här versionen lägger till en experimentell WinUI 3-diagramkontroll för att presentera kartesiska data som rad-, områdes- och stapelserier. Kontrollen stöder konfigurerbara axlar, förklaringar, dataetiketter och datamarkörer. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• InkPresenter.ActivateCustomDrying och InkSynchronizer har lagts till, vilket gör att appar själva kan återge incheckade pennanteckningar med hjälp av BeginDry och EndDry.
• En åtkomstöverträdelse som kunde inträffa vid läsning av InkPresenter.StrokeContainer när anpassad torkning var aktiv har åtgärdats.
• InkCanvas-presentatörsstorleken har korrigerats under en RenderTransform.
• Anpassade det experimentella InkToolbar-API:et till den granskade designen. Verktygsfältet riktar sig nu direkt mot en InkPresenter utan att kräva en InkCanvas. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Åtgärdade ett problem med WinUI-resursspårning som kan leda till att minnesanvändningen ökar när appar upprepade gånger har skapat storyboards för visuellt tillstånd eller löst statiska resurser eller temaresurser. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• Förbättrad rensning av oåtkomliga ursprungliga WinUI-objekt i .NET-appar efter nedmontering av flikar eller sidor. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

Den här versionen innehåller följande nya och uppdaterade API:er jämfört med den experimentella versionen 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

Den här versionen lägger till inmatningsstöd för WinUI 3 via InkCanvas, InkToolbar och InkPresenter, inklusive penn- och touchinmatning, Stöd för Urklipp, stöd för högkontrast, strokeindata och obearbetade indata. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Den här versionen innehåller följande nya API:er jämfört med 2.3 Experimental A-versionen :

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

Nya experimentella egenskaper för Window.Width och Window.Height ger appar ett DPI-medvetet sätt att hämta och ange ett fönsters storlek i logiska bildpunkter (klient) direkt från kod eller markering, utan att nå genom Window.AppWindow och utföra manuell logisk till fysisk DPI-konvertering. Egenskaperna Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth och Window.MaxHeight begränsar fönstrets storlek. Vi välkomnar din feedback.

Den experimentella SpeechAudioProvider (som används för att skicka 16 kHz, 16-bitars PCM-ljud med en kanal till taligenkänning) implementerar nu IClosable, så att appar deterministiskt kan släppa providern med Close/Dispose när de är klara med strömmande ljud.

De experimentella API:erna för appinnehållsindex lägger till nya indexeringsfunktioner och betydande förbättringar av tillförlitlighet och prestanda i den här versionen:

• Snabbare indexering i batchar. Med ett nytt AppContentIndexer.BatchAddOrUpdate-API kan flera objekt indexeras tillsammans. Indexeringspipelinen har också gjorts om för att stödja parallell faskörning och effektivare batchbearbetning.
• Förbättrad flerspråkig tokenisering. Appinnehållsindex använder nu en ICU-baserad ordbrytare, vilket förbättrar tokeniseringskorrigeringen mellan språk samtidigt som ett beroende av WinRT WordsSegmenter tas bort.
• Förbättrad indexering och frågeprestanda. Indexuppdateringar undviker nu onödiga lexikala omskrivningar, batchrensning fungerar effektivare och cachelagrar indexfunktioner mellan frågor, vilket avsevärt minskar kostnaderna för vanliga sökvägar för frågor och indexering.
• Stabilare lexikal rangordning. BM25-poängsättning hanterar nu dokumentlängdsstatistik separat, vilket bevarar en konsekvent rangordning när innehåll uppdateras eller tas bort stegvis.
• Automatisk återställning efter korruption. Appinnehållsindex identifierar databasfel och inkompatibla schemaändringar när ett index öppnas och återställs automatiskt genom att initiera en omindexering i stället för att göra indexet oanvändbart. GetOrCreateIndexStatus.RecoveredFromCorruption anger när återställningen inträffade.
• Statiska rankningsförstärkningar. Med nya API:er kan appar tillämpa rankningsökningar på enskilda innehållsobjekt eller regioner, vilket gör att resultaten kan vara partiska med hjälp av programbaserade signaler. Använd statiska ökningar när din app har kunskap om den relativa betydelsen av innehåll som inte fångas upp av själva innehållet, till exempel för att hjälpa till att visa upp ett dokument som är särskilt viktigt eller ofta söks av användarna.
• Indexering av bildinnehåll. Appar kan nu indexera bitmapps- eller bildströminnehåll direkt, med alternativ som styr OCR-extrahering och semantisk indexering av extraherad text. Använd bildindexering när meningsfull sökbar information finns i en bild i stället för att redan vara tillgänglig som text, till exempel skärmbilder, skannade dokument eller annat visuellt innehåll.
• Semantisk indexeringskontroll för text. Med en ny ContentRegionTextOptions.AllowSemanticIndexing-egenskap kan appar välja enskilda textregioner från semantisk indexering. Detta är användbart för text som bör förbli sökbar lexikalt men som sannolikt inte kommer att dra nytta av semantisk matchning, vilket ger appar mer kontroll över vilket innehåll som deltar i semantisk hämtning.

Den här versionen innehåller följande nya API:er jämfört med 2.2 Experimental 9-versionen :

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

Api:erna för språkmodeller körs nu på icke-Copilot+ PCs utrustade med en GPU som stöds, vilket ger funktioner för lokala språkmodeller till ett bredare utbud av Windows 11 enheter. Maskinvara som stöds inkluderar NVIDIA GeForce RTX 30-serien och nyare med 6+ GB vRAM. GPU-slutsatsdragning kräver att utvecklarläget är aktiverat och en Windows Insider Experimental Channel-version.

GPU-modellen är inte förinstallerad. Den laddas ned på begäran via EnsureReadyAsync via Windows Update. Appar bör kontrollera GetReadyState och visa en dialogruta för medgivande innan nedladdningen utlöses. Användare kan hantera modellen på Inställningar > System > AI-komponenter.

Vägledning om ansvarsfull AI finns i det nya transparensmeddelandet: API:er för språkmodeller på datorer utan Copilot+.

Nya API:er för taligenkänning på enheten i Microsoft.Windows.AI.Speech möjliggör både batchbearbetning och strömmande tal-till-text. BatchRecognition känner igen en fullständig ljudkälla i ett enda anrop och StreamingRecognition genererar Recognizing och Recognized händelser. Ljud kan hämtas från en enhet (AudioConfiguration.FromAudioDevice), en fil (FromFile), en indataström (FromStream) eller skickas av anroparen via SpeechAudioProvider (16 kHz, 16-bitars enkanals-PCM). Modellen på enheten hanteras via SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, och status för nedladdning och inläsning rapporteras via SpeechRecognitionModelProgress.

En ny Microsoft.Windows.Workloads.NpuType enum exponerar NPU-klassen för den aktuella enheten (till exempel Qnn, Lnl, Stx, Win365, Unknown, None), så att appar och arbetsbelastningsinfrastruktur kan dirigera AI-arbetslaster till rätt körväg.

Den här versionen innehåller följande nya API:er jämfört med 2.1 Experimental 8-versionen :

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Speech

    AudioConfiguration
    BatchRecognition
    SpeechAudioProvider
    SpeechContract
    SpeechRecognitionModel
    SpeechRecognitionModelProgress
    SpeechRecognitionModelProgressStatus
    SpeechRecognitionModelResult
    StreamingRecognition
    StreamingRecognizedEventArgs
    StreamingRecognizingEventArgs

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        CompressPromptAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync

    LanguageModelOptionsExperimental
        PreferredRetentionRatio

Microsoft.Windows.Workloads

    NpuType

LanguageModelExperimental.GenerateStructuredJsonResponseAsync (introducerades i 2.0 Experimental 7) returnerar nu en dedikerad GenerateStructuredJsonResponseResult typ med en GenerateStructuredJsonResponseStatus egenskap, i stället för det generiska LanguageModelResponseResult / LanguageModelResponseStatus paret. Den nya statusuppräkningen är specifik för schemabegränsad generering: den innehåller ett ResponseInvalidJson värde för det fall där modellutdata inte uppfyllde det begärda JSON-schemat, separat från allmänna svarsfel för språkmodeller.

Som en del av den här uppdelningen ResponseInvalidJson har värdet tagits bort från den stabila LanguageModelResponseStatus uppräkningen (där det tidigare hade lagts till för att stödja strukturerade JSON-utdata). Appar som hanterade ResponseInvalidJson från LanguageModelResponseStatus bör flytta hanteringen till den nya GenerateStructuredJsonResponseStatus som returneras av GenerateStructuredJsonResponseAsync. Andra anropare av LanguageModelResponseStatus behöver inte längre ta hänsyn till ett JSON-specifikt felvärde.

Den här versionen innehåller följande nya API:er jämfört med 2.0 Experimental 7-versionen :

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Microsoft.Windows.AI.Text.Experimental

    GenerateStructuredJsonResponseResult

    GenerateStructuredJsonResponseStatus

    LanguageModelOptionsExperimental
        LowRankAdapter [Experimental]

Windows App SDK 2.0.0-experimental7 introducerar experimentellt CMake-stöd (under aktiv utveckling), vilket möjliggör för C++-utvecklare att använda Windows App SDK:s NuGet-paket från CMake-baserade projekt.

CMake-integreringen bygger på NuGetCMakePackage, en CMake-modul med öppen källkod som överbryggar klyftan mellan NuGet-pakethantering och CMake:s interna find_package() arbetsflöde. NuGetCMakePackage hanterar nedladdning och återställning av NuGet-paket vid konfigurationstillfället via add_nuget_packages(), avsöker varje paket för en inbäddad cmake-konfiguration (på build/cmake/<package>-config.cmake) och exponerar paketets huvuden, importbibliotek, körnings-DLL:er och WinRT-metadata som CMake-standardmål.

Varje Windows App SDK NuGet-komponent och beroende paket bäddar nu in en CMake-konfigurationsfil under build/cmake/, som med hjälp av NuGetCMakePackage-biblioteket gör att CMakes find_package() automatiskt identifierar mål, huvuden, bibliotek och körnings-DLL:er utan manuell sökvägskonfiguration. Detta omfattar alla komponentpaket, inklusive Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML och WinUI, samt beroenden som Base och Runtime.

En översikt över CMake-förbrukningsmodellen och vägledning för att komma igång finns på CMake-landningssidan.

Den här funktionen är experimentell och skickas tidigt för att samla in feedback från communityn. Namngivningskonventionerna för mål och konfigurationsmönster kan komma att ändras baserat på utvecklarindata. Eftersom det här är en tidig flygning finns det en del ceremonier och installationer inblandade – se CMake-exempelprogrammen som illustrerar konfiguration och användning från slutpunkt till slutpunkt i alla fyra distributionsscenarier (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Vi vill gärna höra vad du har att säga! Om du stöter på ett scenario som för närvarande inte omfattas, har förslag på att förbättra utvecklarupplevelsen eller stöter på problem kan du lämna feedback under fliken Issues på Windows App SDK lagringsplats med öppen källkod eller starta en konversation i Discussions. Dina indata formar direkt den aktiva utvecklingen av den här funktionen.

Den här experimentella versionen samlar in ändringarna och korrigeringarna som levereras i 2.0-Preview1 och 2.0-Preview2. De tidigare nämnda objekten sammanfattas nedan. Se de länkade versionsanteckningarna för förhandsversionen för fullständig information.

Från 2.0-Preview1:

• Windows ML: Korrigering för att RegisterCertifiedAsync återvänder 0 exekveringsleverantörer när den anropas igen i samma process.
• Microsoft.UI.Content: Ny InputFocusController.ShouldShowKeyboardCues property och ny bekvämlighets-API PointerPoint.GetCurrentPoint.
• Microsoft.Windows.Management.Deployment: Nya API:er för att uppnå paritet+ med PackageVolume (inklusive Windows.Management.Deployment, AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline och mer). Ny IPackageValidator utökningspunkt på AddPackageOptions och StagePackageOptions, med tre inbyggda validatorer: PackageCertificateEkuValidator, PackageFamilyNameValidatoroch PackageMinimumVersionValidator.
• Microsoft.Windows. Storage.Pickers:
  • Nya Title egenskaper för FileOpenPicker, FileSavePickeroch FolderPicker, aktiverar anpassade dialogrutor.
  • Nya SettingsIdentifier egenskaper för FileOpenPicker, FileSavePickeroch FolderPicker, aktiverar instansspecifikt tillstånd för väljare mellan sessioner.
  • Nya InitialFileTypeIndex egenskaper för FileOpenPicker och FileSavePicker, vilket gör det möjligt för utvecklare att ange det valda standardfiltypfiltret efter index (0-baserat).
  • Ny ShowOverwritePrompt egenskap på FileSavePicker. Den använder som standard true och styr när väljaren varnar för överskrivning, när användaren väljer en befintlig fil via FileSavePicker.
  • Ändrade standardbeteendet FileSavePickerför : från och med WindowsAppSDK 2.0 FileSavePicker skapar inte en tom fil när användaren väljer en icke-befintlig fil, vilket gör att utvecklare kan bestämma när filen ska skapas.
  • Ny PickMultipleFoldersAsync metod för FolderPicker, vilket aktiverar val av flera mappar i en enda åtgärd.
• Felkorrigeringar: Installationsförloppsrapportering; förbättrad felhantering för WindowsAppSDKSelfContained klassbibliotek.

Från 2.0-Preview2:

• Windows AI-API:er: Phi Silica-API:er framtvingas som en funktion för begränsad åtkomst. Nya AIFeatureReadyState värden för problem med anskaffning av ytmodeller, till exempel saknade funktioner, inkompatibel maskinvara och nödvändiga OS-uppdateringar, varaktiga nätverks-/Windows Update installationsfel flaggas nu; förbättrad diagnostik för API:er för textinformation.
• Anpassade XAML-villkor: IXamlCondition graderar och byter namn på det experimentella IXamlPredicate gränssnittet, vilket möjliggör anpassade villkor som utvärderas vid XAML-parsningstid.
• WebView2 (WinUI 3): Dra och släpp-stöd för innehåll som finns i WebView2 (text, HTML, bilder, URL:er), avbrytande av drag, anpassade dra-visualiseringar samt anpassningsbara dragdata. Kräver WebView2 Runtime 144.0.3719.11 eller senare. (DownloadURL stöds inte ännu.)
• Felkorrigeringar: MSB8027/LNK4042 skapa varningar från duplicerade ClCompile-objekt i .targets filer (med en avanmälningslösning WindowsAppSDK_Arm64EcCompilerWorkaround för ARM64EC+LTCG); ListView kraschar under tangentbordsnavigering efter att objektlistan har uppdaterats. WinUI 3 kraschar när fokus flyttas till en icke-synlig CoreWebView2Controller.

• API-namnbytespass för tydlighet och konsekvens:
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame VideoScaler.Scale → och VideoScaler.ScaleImageBuffer
• Olika felkorrigeringar och kvalitetsförbättringar i VSR.

• Nytt LanguageModelExperimental.GenerateStructuredJsonResponseAsync API under Microsoft.Windows.AI.Text.Experimental för att generera strukturerade JSON-utdata från en språkmodell.
• Nytt LanguageModelResponseStatus.ResponseInvalidJson statusvärde som anger att en modell returnerade ett svar som inte tolkades som giltig JSON.

• Nya AppContentIndexer.GetExistingIndexes API:er och AppContentIndexer.IsContentKindSupported API:er.
• Ny AppManagedOcrTextQueryMatch typ och QueryMatchContentKind.AppManagedOcrText värde för att stödja att göra förfrågningar mot appinnehåll via text härledd från OCR.
• Nytt GetOrCreateIndexOptions.CreateAlways för att framtvinga skapandet av ett nytt index.
• Nytt ContentItemErrorDetail.InsufficientDiskSpace för att synliggöra fel vid brist på diskutrymme under indexering.

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 2.0.0-experimental6:

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

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

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

Windows ML kan nu användas från C++-projekt med CMake. Mer information finns på sidan Komma igång .

Versionen av ONNX Runtime har uppdaterats till 1.24.2. Mer information finns i ONNX Runtime-versioner .

• NPUPowerMode har blivit inaktuell till förmån för nyare API:er för energisparfunktioner.
• GetReadyState returnerar NotSupported nu korrekt när sessionskoordinatorn inte är tillgänglig, i stället för att utlösa ett undantag.

• Stöd för NV12-utdataformat har lagts till för Video Super Resolution.

• Förbättrad DeleteIndex tillförlitlighet. Ibland kunde DeleteIndex misslyckas med "ERROR_SHARING_VIOLATION".

• Åtgärd för OCR-avgränsningsrutor som returnerar negativa värden i vissa gränsfall.

• Appinnehållssökning är en del av ett separat Microsoft.Windows.Search-paket i stället för att ingå i Microsoft.Windows.AI package.

• Korrigering för att prefixsökning inte fungerar med korta frågesträngar.

• Nya API:er och namnbyten baserat på officiell API-granskning.

  • AppContentIndexer
    • HämtaInnehållsobjektSomKräverOmintextering
    • Ta bort –> RemoveContentItem
    • Ta bort flera –> Ta bort innehållsposter
    • RemoveAllContentItems
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppCOntentIndexListener
    • IndexeringsstatusÄndrad –> InnehållsObjektStatusÄndrad
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • SenasteResultatÄndrats –> ResultatÄndrat
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • SenasteResultatÄndrats –> ResultatÄndrat
  • AppManagedImageQueryMatch
    • Underregion –> Intresseområde
  • InnehållsPostStatusResultat
    • Omintexeringsstatus * Innehållsobjektets omintexeringsstatus
  • TextFrågeSessionResultat
    • IsValid
  • BildförfrågningssessionResultat
    • IsValid
  • QueryContentItemsFilterFlags

• Åtgärdat ImageDescription.DescribeAsync fel på InternalError på grund av ett kapplöpningstillstånd.

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Förenklat licensavtal med tydligare villkor för ISV:er som skapar program med Windows ML.
• Omstrukturerade avsnitt som omfattar installation, data och distribuerbar kod med förbättrad tydlighet.
• Meddeleande om efterlevnad för ny körleverantör (EP) klargör utvecklaransvaret för hårdvaruaccelererade körleverantörer.
• Direktlänkar till leverantörslicensavtal för NVIDIA TensorRT, Intel OpenVINO och Qualcomm QNN (Qualcomm Neural Network SDK).

• Windows ML experimentella versioner överensstämmer med ONNX Runtime mainline version 1.24 för att förbättra kompatibilitet och stabilitet.
• ABI-körningsproviders (Stable Application Binary Interface) tillämpas för att säkerställa förutsägbart beteende mellan enheter, med icke-stabila körningsproviders undantagna från förvärv.
  • Endast OpenVINO-utförandeleverantören stöds, med ytterligare utförandeleverantörer som ska läggas till över tid när de uppfyller stabilitetskraven.
• Storleken på Microsoft.Windows.AI.MachineLearning.dll minskade med cirka 160 kB.

• Nya experimentella API:er för uppslagsstatistik för objekt som indexeras. Detta ger insyn i vad som händer i indexet.
• Stöd för frågeavbokning så att appar kan köra en fråga och uppdatera den om det finns en ny fråga innan den aktuella har slutförts. Detta möjliggör ett snabbare svar på frågan när en användare skriver i frågesträngen.
• Stöd för prefixmatchning för korta strängar för att förbättra resultatet när användaren skriver.

• VideoScaler är nu disponibel, vilket förbättrar resurshantering och livscykelkontroll.
• VSR-modellen kompileras och cachelagras nu för att förbättra prestanda och minska kostnaderna för upprepad initiering.
• En funktionskontroll har lagts till för att verifiera VSR-stöd före användning.
• Explicit WinML-initiering krävs inte längre när du använder Video Super Resolution.

• Kontrollen FlowLayout använder nu terminologin ItemSpacing och LineSpacing i stället för vågräta och lodräta avståndsegenskaper. Den justerade namngivningen förbättrar tydligheten och konsekvensen med moderna layoutmönster i användargränssnittsramverk.

• Kontrollen WrapPanel använder nu Nomenklaturen ItemSpacing och LineSpacing i stället för de tidigare vågräta och lodräta avståndsegenskaperna.

• Det implementerade IXamlPredicate-gränssnittet för att definiera anpassade predikat som integreras sömlöst med XAML:s villkorsstyrda namnrymdssyntax och utvärderas vid XAML-tolkningstid.
• Anpassade predikat möjliggör villkorsstyrda XAML-scenarier baserat på programspecifika faktorer som:
  • Funktionsflaggor (Feature flags)
  • Enhetsfunktioner
  • Affärslogik
  • Konfigurationsinställningar
  • Andra körningsvillkor

• Uppdaterade paket för att möjliggöra extern användbarhet, vilket inkluderar ändringar i:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Byggstöd har lagts till för Visual Studio 2026
• Introducerade verktyg och skript för användning av externa utvecklare för att skapa och testa WinUI.

• [förolämpad] DependencyObject.Dispatcher
• [inaktuell] Window.Current
• [föråldrad] FocusManager.GetFocusedElement
• [har bytt namn] SystemBackdropHost till SystemBackdropElement

• [har bytt namn] Microsoft.Windows.AI.Search.Experimental.AppContentIndex till Microsoft.Windows.Search.AppContentIndex

• Felen "Klass inte registrerad" har åtgärdats vid användning av fristående distribution med Windows ML. Utvecklare som använder fristående distribution behöver inte längre registrera alla aktiveringsbara klasser för Foundation-paketet som användes internt.
• Åtgärdade en potentiell krasch vid processavstängning vid användning av Windows ML.
• Api-routningssökvägen ImageForegroundExtractor har åtgärdats så att anropen når rätt slutpunkt.
• Säkerställd att exekveringsleverantörens installations- och nedladdningsframsteg vidarebefordras korrekt till appar under paketdistributionen.
• Åtgärdade en krasch i SystemBackdrop när anslutningen kopplas från genom att skydda mot ogiltiga frånkopplingssökvägar.
• Ett problem som förhindrade Windows AI-API:er från att vara tillgängliga för vissa program har åtgärdats.

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 2.0.0-experimental3:

Microsoft.UI.Content

    ChildSiteLink
        IsHitTestVisible

Microsoft.UI.Xaml.Controls

    FlowLayout
        LineSpacing
        LineSpacingProperty
        MinItemSpacing
        MinItemSpacingProperty

    SystemBackdropElement
    WrapPanel
        ItemSpacing
        ItemSpacingProperty
        ItemsStretch
        ItemsStretchProperty
        LineSpacing
        LineSpacingProperty

    WrapPanelItemsStretch

Microsoft.UI.Xaml.Markup

    IXamlPredicate

Microsoft.Windows.AI.Video

    VideoScaler
        Dispose

Microsoft.Windows.Search.AppContentIndex

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

• En ONNX Runtime-regression gör att Video Super Resolution misslyckas på Qualcomm-enheter. En kommande uppdatering av Qualcomm NPU-körningsmotorn kommer att lösa det här problemet.

Den nya experimentella SplitMenuFlyoutItem-kontrollen är utformad för att ge en delad knappupplevelse i en utfällbar meny. Den här kontrollen gör det möjligt för utvecklare att exponera en primär standardåtgärd samtidigt som de erbjuder ytterligare alternativ via en undermeny, perfekt för att komprimera komplexa funktioner till ett mindre fotavtryck och spara övergripande menylängd.

Tillsammans med funktionerna i MenuFlyoutItem och MenuFlyoutSubItem levereras kontrollen med två andra egenskaper: SubMenuPresenterStyle och SubMenuItemStyle, som tillåter anpassning av undermenyn, som att använda GridView för undermenyns presentatör.

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

Namn på typer

• WinMLCatalogModel har bytt namn till ModelCatalog
• CatalogModelSource har bytt namn till ModelCatalogSource

Metoduppdateringar

• CatalogModelInfo: Har bytt GetInstance namn till GetInstanceAsync
• ModelCatalogSource: Har bytt CreateFromUri namn till CreateFromUriAsync
• ModelCatalog: Har bytt FindModel namn till FindModelAsync
• ModelCatalog: Har bytt FindAllModels namn till FindAllModelsAsync

Egenskapsändringar

• Uppdaterad CatalogModelInfo.Size till CatalogModelInfo.ModelSizeInBytes

Beteendeuppdateringar

• Hämta instansen från CatalogModelInstanceResult med .GetInstance()
• CatalogModelStatus returnerar nu Ready eller NotReady baserat på lokal tillgänglighet
• Har lagts CatalogModelInstanceStatus till för att separera instansstatus från modellstatus

CatalogModelInfo-förbättringar

• Alias har bytt namn till Name
• Revision har bytt namn till Version
• Publisher har lagts till
• Avlägsnad DisplayName

JSON-ändringar

• Har bytt alias namn till id.
• Borttagen modelType och description.
• Har bytt executionProvider namn till executionProviders.
• Har uppdaterats executionProviders till en matris med JSON-objekt i stället för en kommaavgränsad lista.

Ytterligare ändringar

• ModelCatalog returnerar nu en lista över utförandeleverantörer (EPs) vid instansskapande.
• Stöd har lagts till för Windows 10 (1809) och senare.
• Stöd har lagts till för lokala filer, inklusive både vanliga filer och MSIX-paket.
• Krascher orsakade av ogiltig katalog-JSON har åtgärdats.

• Den tidigare AppIndexQuery typen, som inkluderade GetNextTextMatches och GetNextImageMatches metoder, har delats upp i två olika typer: AppIndexTextQuery och AppIndexImageQuery. Metoden AppContentIndexer.CreateQuery har ersatts med: CreateTextQuery och CreateImageQuery.

• Dessa metoder returnerar AppIndexTextQuery nu respektive AppIndexImageQuery . För att förenkla användningen har alternativtyperna också uppdaterats:

  • Borttagen: AppIndexQueryOptions, TextMatchOptions och ImageMatchOptions
  • Har lagts till: TextQueryOptions och ImageQueryOptions

• API:erna i AppContentIndex-namnområdet returnerar nu IVectorView istället för matriser för bättre konsekvens och prestanda.

• Metoden AppContentIndexer.WaitForIndexingIdleAsync har uppdaterats för att acceptera en TimeSpan parameter i stället för ett heltal, vilket ger tydligare och mer flexibel timeouthantering.

API:et VideoScaler ger videoförbättringar i realtid genom avancerad AI-skalning, optimerad för strömmar med personer i konversation. Det gör det möjligt för utvecklare att tillhandahålla skarpare, tydligare visuella objekt på konferens-, direktuppspelnings- och redigeringsplattformar, även under dåliga nätverksförhållanden. API:et stöder anpassning av utdataupplösning, bildfrekvens och intressanta regioner, med kompatibilitet för flera videoformat, inklusive BGR, RGB och NV12.

Med det nya API:et RewriteCustomAsync kan du ange en indatasträng som vägleder Phi Silica när du skriver om markerad text. Du kan experimentera med nya kreativa stilar som "Goofy" eller "Pirate" för att omedelbart transformera ditt innehåll.

Klassen ImageGenerator använder stabila diffusionsmodeller för att tillhandahålla kraftfulla bildgenereringsfunktioner. Den stöder scenarier för flera generationer:

• Text till bild: Generera bilder från beskrivande textprompter.

• Bild-till-bild: Transformera befintliga bilder baserat på textbeskrivningar.

• Magisk fyllning: Fyll maskerade områden med bilder med AI-genererat innehåll.

• Färgboksformat: Generera bilder i färgboksformat.

• Ändra stil: Ändra den konstnärliga stilen för befintliga bilder samtidigt som strukturen bevaras.

Alla genererade avbildningar returneras i RGB8-format via ImageBuffer-objekt . API:et innehåller inbyggda säkerhetsfilter för innehåll och stöder anpassningsbara generationsparametrar.

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");
    }
}

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 2,0-experimental2:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem

Microsoft.Windows.AI.Imaging

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

    TextRecognizerOptions

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexer
        CreateImageQuery
        CreateTextQuery
        WaitForIndexingIdleAsync

    AppIndexImageQuery
    AppIndexTextQuery
    ImageQueryOptions
    TextQueryOptions

Microsoft.Windows.AI.Text

    TextRewriter
        RewriteCustomAsync

Microsoft.Windows.AI.Video

    ScaleFrameStatus
    VideoScaler
    VideoScalerOptions
    VideoScalerResult

• Beräkningen av avgränsningsrutan har fastställts när texten roteras. I vissa fall rapporterade OCR-textmatchningen i bilder felaktiga eller tomma regiongränsar när texten roterades.

Api:erna för AppContentIndexer gör det möjligt för utvecklare att effektivt indexera appinnehåll, inklusive text och bilder för snabb och relevant hämtning. Med stöd för både lexikala (nyckelordsbaserade) och semantiska (meningsbaserade) sökningar kan dessa API:er göra det möjligt för appar att leverera snabba, relevanta resultat baserat på användarens avsikt och kontext snarare än bara exakta nyckelord.

Den här funktionen låser upp följande avancerade scenarier:

• Semantisk sökning
  Appar kan returnera resultat baserat på avsikt och mening snarare än exakta nyckelordsmatchningar.
  Exempel: En fråga för "projekttidslinje" kan visa innehåll som nämner "schema" eller "leveransdatum", även om de exakta orden inte användes.
• Retrieval-Augmented Generation (RAG)
  Indexerat innehåll kan fungera som en kunskapsbas för generativa AI-modeller. När en användare ställer en fråga hämtar appen de mest relevanta dokumenten eller kodfragmenten från sitt index och matar in dem i modellen, vilket möjliggör korrekta, sammanhangsmedvetna svar som baseras på verkliga data.

Med api:erna för Windows ML-modellkatalog kan din app eller ditt bibliotek dynamiskt identifiera och ladda ned stora AI-modellfiler från dina egna onlinemodellkataloger, vilket eliminerar behovet av att paketera dessa stora filer direkt med din app eller ditt bibliotek. Modellkatalogen hjälper till att säkerställa enhetskompatibilitet genom att filtrera modeller och ladda ned endast de som gäller för den specifika Windows enhet som används.

Den senaste Microsoft.Windows.Storage.Pickers-uppdateringen effektiviserar valet av filer och mappar genom att låta utvecklare ange inledande och beständiga mappplatser och genom att gruppera filtypsfilter med tydliga etiketter för enklare navigering.

API:et PopupAnchor kan DesktopPopupSiteBridge nu stödja relativ positionering genom att förankra till sitt ägande fönster eller sin egen ö, vilket tar itu med begränsningen där popup-fönster bara kunde placeras absolut med hjälp av skärmkoordinater.

API:et InputUnderlyingWindowController gör det möjligt för utvecklare att ange mål-HWND för att ta emot indatameddelanden som ursprungligen skickades till ett ContentIsland som skapats från ett SystemVisual (se ContentIsland.CreateForSystemVisual).

SystemBackdropHost gör det möjligt att placera en systembakgrund (akryl/glimmer) var som helst i ett programs visuella träd.

WrapPanel är en layout-panel för WinUI XAML som arrangerar underliggande element i en sekventiell ordning från vänster till höger; objekt som överflödar raden bryts automatiskt till nästa rad i slutet av panelen. Det är användbart för dynamiska layouter.

Det här är en port för den befintliga kontrollen Windows Community Toolkit.

Den här versionen innehåller följande nya och modifierade experimentella API:er jämfört med 2,0-experimental1:

Microsoft.UI.Content

    PopupAnchor

Microsoft.UI.Input

    InputUnderlyingWindowController

Microsoft.UI.Xaml.Controls

    StretchChild
    SystemBackdropHost
    WrapPanel

Microsoft.Windows.AI.Imaging

    ImageForegroundExtractor
    ImageForegroundExtractorContract

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

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

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
    LanguageModelExperimentalContract
    LanguageModelOptionsExperimental
    LowRankAdaptation

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        SuggestedFolder
        SuggestedStartFolder

    FileSavePicker
        SuggestedStartFolder

    FolderPicker
        SuggestedFolder
        SuggestedStartFolder

• AppContentIndexer API:er ska anropas från en bakgrundstråd. Användning av den i användargränssnittstråden kan hänga eller orsaka långa pauser som påverkar användarupplevelsen.
• Frågeresultat som använder AppIndexQuery.GetNextTextMatches och AppIndexQuery.GetNextImageMatches kommer att vara null när det inte finns några matchningar i stället för en tom lista.
• Bildmatchningar som används AppManagedImageQueryMatch.Subregion baserat på OCR-värden kan ibland vara felaktiga, särskilt när texten roteras eller snedställs.
• Bildmatchningar som används AppManagedImageQueryMatch.Subregion kan ibland innehålla nollstorlekar eller extremt små rektanglar, vilket leder till felaktiga resultat.
• En tom fråga från AppContentIndex.CreateQuery kan utlösa ett undantag.

Med api:erna Windows ML modellkatalog kan din app eller ditt bibliotek dynamiskt ladda ned stora AI-modellfiler från dina egna onlinemodellkataloger utan att skicka dessa stora filer direkt till din app eller ditt bibliotek. Dessutom hjälper modellkatalogen till att filtrera vilka modeller som är kompatibla med den Windows enhet som den körs på, så att rätt modell laddas ned till enheten.

Viktiga fördelar:

• Lägg till kataloger: Lägg till en eller flera onlinekataloger
• Identifiera kompatibla modeller: Hitta automatiskt modeller som fungerar med användarens maskinvaru- och körningsleverantörer
• Ladda ned modeller: Ladda ned och lagra modeller från olika källor
• Dela modeller mellan appar: Om flera program använder samma katalogkälla delas modellerna på disken utan att dubblera nedladdningar

• Åtgärdade ett problem i DeploymentManager som resulterade i att packageInstallRequired rapporterades felaktigt i vissa fall.

Den här versionen innehåller följande nya och ändrade experimentella API:er:

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