Windows Uygulama SDK'sı 2.0 sürüm notları

Güvenilir üretim derlemelerinden erken erişime ve yaklaşan özelliklere kadar geliştirme gereksinimlerinize bağlı olarak Kararlı, Önizleme ve Deneysel kanallar arasında seçim yapabilirsiniz. Yayın kanalları hakkında daha fazla bilgi edinin.

Güncelleştirilmiş çalışma zamanı ve MSIX için Windows Uygulama SDK'sı için İndirmeler kısmına bakın.

Sürüm 2.5.1

Yayın tarihi: 16 Eylül 2026

hata raporlama desteği Windows

Paket bildirimi uzantısı için windows.diagnosticServiceModule destek eklendi. Kendi kendine yeten .NET MSIX uygulamaları, tanılama modüllerini tanımlamak için bu uzantıyı kullanabilir; böylece Windows Error Reporting bu modülleri yükleyebilir ve işleme alınabilir çökme dökümleri toplayabilir.

Sınırlı erişimli AppContentSearch API'leri

Yeni AppContentIndex API'leri, LAF belirteci edinmiş uygulamalar için artık sınırlı erişimli bir özellik (LAF) olarak kullanılabilir. Bu API'ler, uygulamaların sözcük temelli eşleştirme ve desteklenen NPU özellikli cihazlarda anlam eşleştirme kullanarak bu içeriği dizine almak ve sorgulamak için metin ve görüntü içeriği sağlamasına olanak tanır. AppContentIndex anlamsal arama ve erişimle zenginleştirilmiş üretim (RAG) senaryolarını destekler. (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

Hata düzeltmeleri
  • Açılır pencere adası kullanımdan kaldırıldıktan sonra bir odak veya işaretçi olayı işlendiğinde, pencereli açılır pencere girişinin işlenmesi sırasında oluşan kilitlenme düzeltildi. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
  • MaxHeight içinde, denetim yeniden boyutlandırıldığında negatif bir bölme NavigationView oluşturulabilmesi nedeniyle oluşan çökme düzeltildi. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
  • İşaretçi basılıyken ElementCompositionPreview.GetPointerPositionPropertySet tarafından döndürülen özellik kümesinin güncellenmeyi durdurduğu sorun düzeltildi. (Çalışma Zamanı Uyumluluk Değişikliği: İşaretçiKonumuÖzellikAyarı_BasılıykenGüncelle)
  • NavigationView içinde, genişletilmiş bir öğenin açılır penceresi, öğe daraltıldıktan veya yeniden kullanıldıktan sonra gösterildiğinde oluşan çökme düzeltildi. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
  • KeyboardAccelerator OEM veya noktalama tuşu (örneğin virgül, noktalı virgül ya da köşeli parantez) kullandığında ve hızlandırıcı kısayol etiketi görüntülendiğinde oluşan ani çökme düzeltildi. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
  • Birden fazla UI iş parçacığında WinUI 3 barındıran uygulamalarda, XAML’nin kapatılması sırasında meydana gelebilen ölümcül bir işlem sonlanması düzeltildi. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
  • İkincil komutları olmayan bir CommandBar öğesinin, 175% gibi kesirli görüntü ölçeklerinde boş bir taşma düğmesi görüntülemesine neden olan sorun düzeltildi. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
  • Sistem Kompozisyon Altyapısı'nı kullanan uygulamaların VisualInteractionSource.CreateFromIVisualElement çağırmasını engelleyen bir sorun düzeltildi. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Sistem Bileşim Altyapısı’nı kullanan uygulamalar için efekt grafikleri ve SceneLighting işleme düzeltildi. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Sistem Bileşimi Altyapısı kullanılırken InputPointerSource.ActivationBehavior öğesini dikkate almayan NoActivate sorunu düzeltildi. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Null girişler ve no-op seçimleri için seçim davranışı düzeltildi CompositionEngine . (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Sistem Oluşturma Altyapısı kullanılırken yükseltilmiş giriş için imleç özelleştirmesi düzeltildi. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
  • Sistem Oluşturma Altyapısı kullanılırken gradyan durdurma koleksiyonlarında sorgular düzeltildi ICompositionObject . (RuntimeCompatibilityChange: YOK, işletim sistemi oluşturma düzeltmesi)
  • Sistem Oluşturma Altyapısı kullanılırken kenarlık ve arka plan davranışı düzeltildi ContentExternalOutputLink . (RuntimeCompatibilityChange: YOK, işletim sistemi oluşturma düzeltmesi)
  • Sistem Bileşimi Altyapısı kullanılırken VisualReferenceController erişimi düzeltildi. (RuntimeCompatibilityChange: YOK, işletim sistemi oluşturma düzeltmesi)
  • Windows Uygulama SDK'sı yüklenirken oluşabilecek bir kayıt sorunu düzeltildi. (RuntimeCompatibilityChange: Yok, dağıtım kaydı düzeltmesi)
  • Video Süper Çözümleme'nin güncelleştirilmiş ONNX Çalışma Zamanı bağımlılığıyla başlatma veya çıkarım sırasında başarısız olmasına neden olan bir sorun düzeltildi. (RuntimeCompatibilityChange: Yok, bağımlılık uyumluluk güncelleştirmesi)
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.4.0 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

Sürüm 2.4.0

Yayın tarihi: 13 Ağustos 2026

Genişletilmiş giriş desteği

WinUI 3 uygulamaları artık, işletim sistemi ve donanım tarafından desteklendiğinde, Windows.Devices.Haptics aracılığıyla işletim sistemi düzeyindeki dokunmatik yüzey ve fare dokunsal geri bildirimlerinin yanı sıra dokunmatik yüzeyde tek parmakla kaydırmayı da destekliyor. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

Hata düzeltmeleri
  • Dokunma veya kalem temasının kaydırılabilir bir alandan tam zamanlamayla ayrılması durumunda oluşabilecek bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
  • Dosya iletişim kutusu kapatıldıktan sonra Depolama Seçicilerinin (FileOpenPicker, FileSavePickerve FolderPicker) arama WinUI uygulama penceresini klavye odağı olmadan bırakması sorunu düzeltildi. Uygulama artık iletişim kutusu kapatıldıktan sonra önceki odağına geri döner. Daha fazla bilgi için bkz. GitHub sorun #6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
  • PRI dosyası mevcut olmadığında belgelenen yedek yol yerine MrmGetFilePathFromName döndürülmesine neden olan bir regresyon düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
  • MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY öğesinin alt işlemler tarafından devralınarak MRT Core ve katalog aramalarını kesintiye uğratabildiği bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
  • LanguageModel öğesinin, desteklenmeyen diller veya giriş ve çıkış dillerinin eşleşmemesi durumunda genel bir Error durumu döndürmesine neden olan bir sorun düzeltildi. Bu koşullar artık sırasıyla LanguageModelResponseStatus.LanguageMismatch ve LanguageModelResponseStatus.UnsupportedLanguage döndürür. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
  • Sistem Bileşim Altyapısı'nı kullanan uygulamalar VisualInteractionSource.TryRedirectForManipulation öğesini çağırdığında oluşan bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: N/A, işletim sistemi bileşim köprüsü düzeltmesi)
  • DISABLE_XAML_GENERATED_MAIN tanımlandığında, oluşturulan C# giriş noktası yardımcısının erişim değiştiricisi düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #11245. (RuntimeCompatibilityChange: Yok, derleme zamanı araç değişikliği)
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.3.1 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Sürüm 2.3.1

Yayın tarihi: 16 Temmuz 2026

Yapılandırılmış JSON Çıkış API'si

Çağıran tarafından sağlanan JSON Şemasına kısıtlanmış dil modeli yanıtları oluşturan Yapılandırılmış JSON Çıktı API'sini ()Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync eklendi. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

XamlOptionalChanges API'si

Uygulamaların XAML başlatılmadan önce isteğe bağlı uyumluluğu bozan değişiklikleri kullanmayı seçmesini sağlayan XamlOptionalChanges API’si eklendi. Daha fazla bilgi için bkz. GitHub PR microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

DISABLE_XAML_GENERATED_MAIN önişlemci sabitinin davranışı, tanımlandığında oluşturulan main() yöntemini tamamen kaldırmak yerine artık yeniden adlandıracak şekilde değiştirildi (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()). Bu, özel main() bir yöntemin varsayılan uygulamayı çağırmasına olanak tanır.

CompositionEngine API'si

CompositionEngine API'sini, uygulamaların Oluşturma API'lerinin altyapısı olarak işletim sistemini kullanmayı kabul etmesine olanak tanıyan kararsız bir Sınırlı Erişim Özelliği (LAF) olarak eklendi. (RuntimeCompatibilityChange: CompositionEngine_API)

Video Süper Çözünürlük geliştirmeleri

Video Süper Çözünürlük için NPU algılama düzeltildi, CPU desteği eklendi ve performans iyileştirildi. (ÇalışmaZamanıUyumlulukDeğişikliği: VideoSüperÇözünürlük_DonanımAlgılama)

Windows ML
  • Belirli senaryolarda yürütme sağlayıcısı numaralandırması düzeltildi. (Çalışma Zamanı Uyumluluk Değişikliği: WindowsML_Yürütme Sağlayıcısı Numaralandırma Güncelleştirmesi)
  • Windows ML için ARM64EC desteği eklendi.
Yapay zeka paketi belgeleri

Microsoft.WindowsAppSDK.AI NuGet paketindeki kararlı API’ler için IntelliSense belgeleri eklendi.

Performans iyileştirmeleri

Aşağıdaki optimizasyonlardan bazıları isteğe bağlıdır. Bunları etkinleştirmek için, her öğede belirtildiği gibi belirtilen XamlChangeId değerini ayarlayın.

  • Optimize edilmiş yeni XamlControlsResources stilleri eklendi; buna optimize edilmiş bir ScrollBar şablonu da dahildir. DefaultStyleOptimizations Bu stilleri kabul etmek için XamlChangeId değerini kullanın. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
  • FontIcon ve BitmapIcon, Grid XamlChangeId’sini kullanan uygulamalar için görsel ağacına fazladan bir IconNoGridOptimization eklemekten kaçınır. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
  • Bir değer uygulamayan Style özellik ayarlayıcılarının yüklenmesi durduruldu. Etkinleştirmek için OptimizeApplyStyles XamlChangeId kullanın. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
  • Öğe ağaca eklenene kadar FrameworkElement ve Control stillerinin uygulanması geciktirildi. Etkinleştirmek için OptimizeApplyStyles XamlChangeId kullanın. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
  • Artık Visual State Manager’ın tüm durumu yüklenmeden CommandBar başlatması optimize edildi. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
  • CommandBarFlyout'ye, PrimaryCommands'ye ve SecondaryCommands'ye ekleme performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
  • için ResourceDictionarydaha performanslı bir karma tablo kullanıldı. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
  • Ertelenmiş kaynaklar yüklenirken kaynak anahtarı dizesinin kopyalanması ve karşılaştırılması optimizasyonla kaldırıldı. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
  • Dize karşılaştırmaları azaltılarak ThemeResource aramalarının performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
  • Kaynak anahtarı karma oluşturma ek yükü azaltılarak XAML tema kaynakları araması sırasında CPU performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
  • UIElement ve FrameworkElement üzerinde gerçekleştirilen yaygın dahili XAML tür denetimleri için CPU performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
  • Dahili etkinleştirme fabrikası arama yollarında CPU performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
  • XBF dosyalarında depolanan tamsayıların kodunu çözme performansı iyileştirildi. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
  • Vektör belleğini önceden ayırarak ve bir RAII yardımcısını optimize ederek, başlatma yollarındaki ve ağaç dolaşımındaki yığın ayırmaları azaltıldı. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
  • Birden çok öğe eklenmeden önce izleme koleksiyonlarında yer ayrılarak performans iyileştirildi. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
  • Özellik bağlamaları için optimize edilmiş XamlUICommand bağlamaları. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
  • Klavye kısayolları tanımlamayan XamlUICommand'ler bağlanırken performans iyileştirildi. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
  • Zorunlu TintLuminosityOpacity gerçekleştirmeyi önlemek için, varsayılan stile sahip AcrylicBrush nesnelerinde TintLuminosityOpacity özelliği kodda değil, işaretlemede başlatıldı. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
  • Element ağacına girerken veya element ağacından çıkarken ContextFlyout ve TextBlock üzerinde gereksiz varsayılan RichTextBlock başlatılması önlendi. Etkinleştirmek için DeferContextFlyoutInit XamlChangeId kullanın. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
  • XAML’nin D3D aygıt kaldırma olayı, daha sonra UI iş parçacığında değil arka planda aygıt oluşturma sırasında kaydedilerek Direct3D kilit çekişmesinden kaynaklanan başlatma beklemeleri azaltıldı. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
  • RefreshRateInfo öğesinden gereksiz bir güç bildirimi kaydı kaldırıldı; bu da başlatma yükünü azalttı. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
  • Derleme zamanında günlüğe kaydedilen çalışma zamanı sürümünü hesaplayarak WinUI başlangıç yolundan yedekli version.dll bağımlılık kaldırıldı. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)
Hata düzeltmeleri
  • İşaretçi olayı yeniden oynatımı sırasında bir açılır pencere eşzamanlı olarak kapatıldığında CPopupRoot::ReplayPointerUpdate içinde oluşan serbest bırakma sonrası kullanım kaynaklı çökme düzeltildi. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
  • XAML adası kaldırılırken yeniden girişli UI Otomasyonu sorguları tarafından tetiklenen CXamlIslandRoot::GetScreenOffset içindeki erişim ihlali düzeltildi. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
  • ModernCollectionBasePanel içinde, görüntü alanı tarafından izlenen bir kapsayıcının veya kardeş bir düzen geçişi tarafından yeniden kullanılan bir başlığın, bir sonraki ölçümde fail-fast mekanizmasını tetikleyen geçerliliğini yitirmiş bir sabitleyici bırakabilmesi nedeniyle oluşan bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
  • Bir CPopup::RemoveChild kapatma işlemi iletileri işleyip kapatma yoluna yeniden girdiğinde, ToolTip içindeki fail-fast düzeltildi. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
  • Etkin UI Otomasyonu istemcileri varken, bir CXcpDispatcher yıkıcısının Popup tetiklemesi sonucu UIADisconnectAllProviders içindeki yeniden giriş çökmesi düzeltildi. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
  • Kademeli menü veya AutoSuggestBox gecikmeli açma zamanlayıcısı, bağlı olduğu ada ya da dağıtıcının kapatma süreci başlamışken tetiklendiğinde oluşan kilitlenme düzeltildi. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
  • Özel meta veri türlerindeki COM işaretçileri uygun şekilde serbest bırakılmadığında, DLL’nin yükten kaldırılması sırasında oluşabilecek olası use-after-free kaynaklı çökme giderildi. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
  • Odak değişiklikleri sırasında oluşan dispatcher yeniden girişi nedeniyle, bir Popup geri çağrısından CompositionTarget.Rendering açılırken oluşan kilitlenme düzeltildi. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
  • Medya oynatma olayları işlenirken GPU aygıtı kaybolduğunda MediaPlayerPresenter içindeki bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
  • Glif dizisi dokusu oluşturulurken aygıt kaybı kurtarma işlemi gerçekleştiğinde, Direct2D metin işleme sırasında oluşabilecek olası bir erişim ihlali düzeltildi. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
  • CFocusRectManager::FindFocusRectHost veya InlineUIContainer içinde, RichTextBlock aracılığıyla satır içi olarak barındırılan bir denetime odak geldiğinde TextBlock içindeki kilitlenme düzeltildi. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
  • Arka plan görevinin depolanmış bir CLSID’si olmadığında backgroundTaskHost.exe’ın tekrar tekrar çökmesine neden olabilen bir sorun giderildi ve CoCreateInstance başarısız olduğunda bunun uygun şekilde işlenmesi sağlandı. Daha fazla bilgi için bkz. GitHub sorun #5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
  • Ekranın alt kısmına yakın bir yerde yukarı doğru açıldıklarında, yan konumlandırmalarda pencereli ve penceresiz açılır menülerin yanlış hizalı görünmesi (ana öğenin yaklaşık bir öğe yüksekliği üzerinde) sorunu düzeltildi. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
  • LayoutState ve UniformGridLayout içinde, artık yüklü olmayan bir FlowLayout üzerinde koleksiyon değişikliği tetiklendiğinde ortaya çıkabilen bir çökmeyi (null ItemsRepeater başvurusundan kaynaklanan) düzelttik. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
  • ApplicationData.GetForUnpackaged().LocalSettings(), makineye yerel bir konum yerine dolaşım konumu olan yanlış yolda (HKCU\SOFTWARE\publisher\product yerine HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product) bir kayıt defteri anahtarının açılmasını düzeltti. Daha fazla bilgi için bkz. GitHub sorun #6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
  • Klavye değiştirici tuş durumunun işlenmesindeki, kullanıcı arayüzü iş parçacığına gelen eşzamanlı girdiler altında uygulamaların çökmesine neden olabilen bir yarış durumu düzeltildi. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
  • Paket yükleme, güncelleştirme veya kaldırma sırasında oluşabilecek bir AppxSvc kilitlenmesi düzeltildi. (RuntimeCompatibilityChange: Yok, hizmet konağı kilitlenme düzeltmesi)
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.2.0 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType
Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges
Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Sürüm 2.2.0

Yayın tarihi: 9 Haziran 2026

Video Süper Çözünürlük AI API'si

API, Microsoft.Windows.AI.Video.VideoScaler konuşma içeren yayınlar için iyileştirilmiş yapay zeka ölçeklendirmesi sayesinde gerçek zamanlı video iyileştirme sunar. Geliştiricilerin kötü ağ koşullarında bile konferans, akış ve düzenleme platformları arasında daha net, daha net görseller sağlamasına olanak tanır. API, BGR, RGB ve NV12 gibi birden çok video biçimi için uyumlulukla çıkış çözünürlüğü, kare hızı ve ilgi çekici bölgelerin özelleştirilmesini destekler.

VideoScaler tek kullanımlıktır ve uygulamaların çalışma zamanında VSR desteğini doğrulayabilmesi için bir yetenek denetimi içerir. Windows ML’nin açıkça başlatılması gerekli değildir.

Paketlenmemiş Uygulamalar için Yeni ApplicationData API'si

Yeni Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() API'sinde paketlenmemiş uygulamalara kullanıcı başına/makine başına uygulama verilerine birinci sınıf bir WinRT giriş noktası sağlanır ve daha önce yalnızca paketlenmiş uygulamalar için kullanılabilir olan yüzeyle eşleşebilir. Bu, ilerideki paketli↔paketlenmemiş geçişleri basitleştirir ve Registry API geçici çözümlerine duyulan gereksinimi ortadan kaldırır.

Yeni XamlBindingHelper API'leri

XamlBindingHelper öğesine (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) boxing gerektirmeyen değer ayarlayıcı aşırı yüklemeleri eklendi ve Setter.ValueProperty bağımlılık özelliği kullanıma sunuldu.

Hata düzeltmeleri
  • RenderTargetBitmap tamamlanmadan önce hedef öğe görsel ağaçtan ayrıldığında (örneğin, bir açılır pencere kapandığında) PreCommit içindeki bir çökme düzeltildi. RenderAsync artık kilitlenmek yerine E_ABORT döndürüyor. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
  • ScrollView denetimi, göstergeleri gizleme zamanlayıcısının tetiklenmesi hâlâ beklemedeyken yok edildiğinde oluşan serbest bırakıldıktan sonra kullanım kaynaklı çökme düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
  • Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate içinde, serbest bırakılması planlanmış bir nesneye erişilmeye çalışılmasından kaynaklanan olası bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
  • Microsoft.UI.System.ThemeSettings bir arka plan iş parçacığında yok edildiğinde (örneğin, .NET çöp toplayıcısı tarafından) uygulamanın çökmesine neden olabilen bir sorun düzeltildi. (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
  • Kalem girişi bunların yerini aldığında olduğu gibi, etkin dokunma temasları giriş donanımı tarafından iptal edildiğinde belirli cihazlarda meydana gelebilen bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
  • Seyrek paketlenmiş uygulamaların modüle özgü PRI dosyalarını bulamama sorunu düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
  • Flat-C Windows ML Kataloğu API'sini kullanırken dize sahipliği hatası düzeltildi. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
  • İşlem kapatma sırasında Windows ML'de olası bir sorun düzeltildi. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
  • Windows ML'deki olası COM başlatma ve sonlandırma sorunları düzeltildi. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.1.3 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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

Sürüm 2.1.3

Yayın Tarihi: 21 Mayıs 2026

TitleBar İçeriği Özel Sürükleme Bölgeleri

TitleBar, TitleBar.Content öğesinin hangi bölümlerinin sürüklenebilir olduğuna nasıl karar verildiğini iyileştirir ve geliştiricilere sürükleme bölgeleri üzerinde doğrudan denetim sağlayan API'ler ekler. Bkz. PR microsoft/microsoft-ui-xaml#10936 ve izleme sorunu #10421.

Ne değişti?

  • Yeni varsayılan davranış — Çerçeve artık görsel ağacı özyinelemeli olarak dolaşır ve sürükleme bölgesinden yalnızca etkileşimli denetimleri otomatik olarak hariç tutar. Boş boşluklar ve etkileşimli olmayan görseller varsayılan olarak sürüklenebilir ve işaretleme değişikliği gerekmez.
  • Açık denetim için yeni API'ler:
    • TitleBar.IsDragRegion — bir öğeyi sürüklenebilir (True), tıklanabilir (False) veya çerçeve tarafından belirlenen (ayarlanmamış) olarak işaretlemek için ekli, null atanabilir bool.
    • TitleBar.AutoRefreshDragRegions — True olduğunda, sürükleme bölgeleri düzen güncellemelerinde otomatik olarak yenilenir.
    • TitleBar.RecomputeDragRegions() — Dinamik içerik değiştikten sonra sürükleme bölgelerini el ile yeniden derler.

Neden

Özel başlık çubukları genellikle Grid/StackPanel düzenleri içinde etkileşimli denetimleri etkileşimli olmayan görsel öğelerle bir arada kullanır. Önceki "tam içerik alanında delikler açma" yaklaşımı, boş alan içeren, aralıkları eşit olmayan veya dinamik kullanıcı arayüzüne sahip düzenlerde beklenmedik sürüklenemez boşluklara neden oluyordu.

Görsel karşılaştırma

Varsayılan (önceki) davranış — sürüklenemeyen boşluklar:

Varsayılan davranış — sürüklenemeyen boşluklar

Boş orta alan sürüklenebilir değildir.

Mevcut (yeni) davranış — boşluklar sürüklenebilir, etkileşimli denetimler hariç tutulur:

Geçerli davranış — sabit sürükleme bölgeleri

Boş alan sürüklenebilir; etkileşimli denetimler doğru biçimde hariç tutulur. (RuntimeCompatibilityChange: Başlık Çubuğu_İçerik Sürükleme Bölgeleri)

LoRA API Kararlı Olarak Yükseltildi

Phi Silica için Low-Rank Adapter (LoRA) API’si kararlı sürüme geçirildi.

LoRA, geliştiricilerin cihaz içi Phi Silika dil modelini kendi özel verileriyle hassas bir şekilde ayarlamasına olanak tanır ve finans, tıp ve eğitim gibi belirli senaryolar için çıkışı uyumlu hale getirir. LanguageModelLowRankAdapter.CreateFromPath ile bir bağdaştırıcı yükleyin ve LanguageModelOptions.LowRankAdapter çağrılırken bunu GenerateResponseAsync aracılığıyla iletin. Ayrıntılar için bkz . Phi Silica LoRA .

Yeni AICapabilities API'si

Yeni AICapabilities.HasAICapability API'si üçüncü taraf uygulamaların cihazın Copilot+ PC olup olmadığını belirlemesini sağlar.

ONNX Çalışma Zamanı güncelleştirildi

ONNX Çalışma Zamanı sürümü 1.24.6 sürümüne güncelleştirildi. Daha fazla bilgi için bkz. ONNX Çalışma Zamanı sürümleri .

Windows ML
  • Tek bir MSIX paketi içinde birden çok yürütme sağlayıcısı için destek eklendi. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
  • Çerçeve paketleri olarak teslim edilen yürütme sağlayıcılarını bulma desteği eklendi. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
  • Esnek dağıtım yapılandırmaları için yürütme sağlayıcısı seçim modu eklendi. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)
Hata düzeltmeleri
  • ItemsRepeater üzerinden oluşan bir referans döngüsü nedeniyle geri dönüştürülen öğelerin çöp toplayıcı tarafından hiçbir zaman toplanmamasına yol açan ve RecyclePool içinde kilitlenmelere de neden olabilen InvalidateChildrenMeasure içindeki bir bellek sızıntısı düzeltildi. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
  • Örtülü bir Göster/Gizle animasyonu tamamlama geri çağrısının yok edilmiş bir CUIElement öğesine erişebilmesi nedeniyle oluşan erişim ihlali kaynaklı çökme düzeltildi. Geri çağırım artık, öğenin animasyon tamamlanmadan önce yok edilmesi durumunu güvenli bir şekilde ele almak için zayıf bir başvuru kullanıyor. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
  • XAML Island içinde açılan pencereli açılır içeriğin OverrideScale'ye uymaması nedeniyle, içeriğin çok büyük ve kırpılmış görünmesine yol açan bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorun #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
  • Bir çapraz daire COM serbest bırakma işlemleri sırasında yeniden girişel gönderim nedeniyle oluşan başarısız hızlı çökme hatası UIAffinityReleaseQueue::DoCleanup içinde düzeltildi. (UyumlulukZamanıDeğişimi: UIAffinityReleaseQueue_TemizlemeSırasındaGönderimiDurdur)
  • WinUI: Aynı ada sahip birden çok modül aynı işlemde yüklendiğinde belirsiz modül araması düzeltildi. GetModuleHandleW, adrese göre doğru modülün çözümlenmesi için GetModuleHandleExW ile değiştirilmiştir. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
  • UniformGridLayout::GetMajorSize, kullanılabilir genişlik bir öğenin ikincil adımından daha dar olduğunda yerleştirildiğinde, ItemsRepeater içindeki tamsayı sıfıra bölme çökmesi düzeltildi. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
  • Bir paket işlenmeden önce kaldırıldığında oluşabilecek olası bir kilitlenme düzeltildi. (RuntimeCompatibilityChange: PackageManager_FixCrash)
  • Gerekli paketler henüz dağıtılmamışken GetReadyState bileşeninin yanlış hata kodları (örneğin, DisabledByUser veya NotSupportedOnCurrentSystem) döndürmesine neden olan bir sorun düzeltildi. API artık bu senaryoda NotReady değerini doğru şekilde bildirerek tanılamanın netliğini artırıyor. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
  • İlk belirteç döndürülmeden önce gecikme kaynaklarını daha iyi tanımlamak için LanguageModel.GenerateResponseAsync'nin dahili performans değerlendirmesi iyileştirildi. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
  • Bir sorunun düzeltildiği, dotnet build kullanılırken XAML derleyicisi hatalarının, gerçek hata iletileri yerine, yalnızca MSB3073: exited with code 1 gösterildiği ve sessizce kaybolduğu. Daha fazla bilgi için bkz. GitHub sorun #9813. (RuntimeCompatibilityChange: Yok, derleme zamanı XAML derleyici aracı değişikliği)
  • 22000'den önceki Windows sürümlerinde, Dinamik Bağımlılıklar API'lerinin statik içe aktarımlarının bu işletim sistemlerinde mevcut olmaması nedeniyle Microsoft.Windows.Workloads.dll yüklenememe sorununu düzeltildi. İşlevler artık dinamik olarak çözümlendiği için desteklenmeyen işletim sistemi sürümlerindeki hatalar yükleyici hata iletişim kutusu yerine normal HRESULT olarak ortaya çıkar. (RuntimeCompatibilityChange: Uygulanamaz, kapsam yok)
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0.1 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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

Sürüm 2.0 kararlı (2.0.1)

Yayın tarihi: 29 Nisan 2026

Windows Uygulama SDK'sı 2.0, platform genelinde yeni API'ler ve iyileştirmeler sunar: XAML koşullu ifadeler, modern Depolama Seçici, Microsoft.UI.Content'ta genişletilmiş açılır pencere ve tutturucu API'ler, yeni paket dağıtımı ve doğrulama API'leri, Windows ML yığınının yeniden yapılandırılması ve Windows AI yüzeyine eklemeler. Ayrıca yeni AnlamSal Sürüm Oluşturma şemasının ilk sürümü ve Windows Uygulama SDK'sı 1.0'dan (Kasım 2021) bu yana ilk ana sürüm güncelleştirmesidir.

Anlamsal Sürüm Oluşturma

Windows Uygulama SDK'sı 2.0, Semantic Versioning 2.0.0 üzerinde standartlaştırılmış yeni Windows Uygulama SDK'sı sürüm oluşturma şemasının ilk sürümüdür. Ayrıca ana sürüm numarasını ilk kez artırıyoruz.

Yeni düzen, Windows Uygulama SDK'sı sürümünü NuGet paket sürümüyle hizalayarak sürüm oluşturma işlemini basitleştirir. Projenizde Windows Uygulama SDK'sı 2.0'a başvurmak artık, izlemek için ayrı tarih tabanlı derleme numarası olmadan ilgili NuGet sürümünü kullanacağınız anlamına gelir:

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

Paket ailesi adı ikincil sürüm yerine ana sürümle de hizalanır, bu nedenle Windows Uygulama SDK'sı bir sonraki yan yana sürümü 3.0.0 sürümü olacaktır. SemVer altında, uygunluk bozucu değişikliklere sadece ana sürüm güncellemeleri arasında izin verilir (bkz. Windows Uygulama SDK'sı dağıtım mimarisi).

Windows ML

Microsoft.WindowsAppSDK.ML NuGet paketi yeniden düzenlenerek yeni bir temel bağımlılık eklendi. Mevcut ML NuGet paketinin işlevselliği aynı kalır, ancak çekirdek Windows ML özellikleri Microsoft.Windows.AI.MachineLearning adlı temel pakette yeniden düzenlenmiştir. Bu yeni paket çok az sayıda bağımlılık içerir; Windows 10 v1903'e kadar destekleyen uygulamalar. Windows 10 v1809 desteğine ihtiyacınız varsa mevcut Microsoft.WindowsAppSDK.ML paketini kullanmaya devam edin.

ONNX Runtime. Windows ML ile birlikte gelen ONNX Çalışma Zamanı sürümü 1.24.5'e güncelleştirildi. Daha fazla bilgi için bkz. ONNX Çalışma Zamanı sürümleri . Bu sürüm ayrıca, API aracılığıyla üretilen grafikleri kullanarak model derlemeyi destekleyecek ek bir ORT API değişikliği içerir, bu değişiklik önceki OrtModelEditor yüzeyindeki bir özellik boşluğunu kapatmaktadır. Değişiklik kesintisizdir ve yaklaşan WebNN tarayıcı senaryolarını engelini kaldırmak amacıyla yapılmıştır; ayrıntılar için temel ONNX Runtime PR #27332 bölümüne bakın.

Lisanslama. Windows ML lisans sözleşmesi, ISV'ler için daha net koşullarla basitleştirildi:

  • Netlik için Yeniden Yapılandırılmış Yükleme, Veri ve Dağıtılabilir Kod bölümleri.
  • Yeni bir Yürütme Sağlayıcısı (EP) Uyumluluk Bildirimi bölümü, donanım hızlandırmalı yürütme sağlayıcılarıyla ilgili geliştirici sorumluluklarını açıklar.
  • NVIDIA TensorRT, Intel OpenVINO ve Qualcomm QNN (Qualcomm Sinir Ağı SDK'sı) için satıcı lisans sözleşmelerine doğrudan bağlantılar.
Windows AI API'leri
  • Phi Silika API'leri artık Sınırlı Erişim Özelliğinin (LAF) bir parçası olarak zorunlu kılındı. Ayrıntılar için bkz . Phi Silika .
  • Uygulamaların yapay zeka modeli alma işlemi sırasında geçici ve dayanıklı hataları açıklamasına AIFeatureReadyState yardımcı olmak için yeni durumlar eklendi: CapabilityMissing, NotCompatibleWithSystemHardwareve OSUpdateNeeded. Uygulamalar, her "hazır değil" koşulu genel bir hata olarak ele almak yerine kullanıcılara eyleme dönüştürülebilir rehberlik sağlamak için bu durumları kullanabilir.
  • Yapay zeka modeli yüklemesi sırasında çeşitli ağ ve Windows Update hataları için denetimler eklendi, ayrıca kullanıcıların model paketlerinin neden yüklenemediğini anlaması için sürekli başarısızlıkları işaretliyoruz.
  • Windows yapay zeka senaryolarında kullanılan Metin Zekası API'leri için iyileştirilmiş tanılama.
WebView2 (WinUI 3) sürükleme desteği

WinUI 3 uygulamalarında barındırılan WebView2 içeriği için sürükleme desteği etkinleştirildi. Bu özellik daha önce desteklenmiyordu ve artık yeni genel API'ler sunulmadan kullanılabilir. (Dış kaynaklardan WebView2 denetimine geçiş zaten destekleniyordu.)

Desteklenen senaryolar:

  • Standart sürükle ve bırak içeriği. Metin, HTML, resimler ve URL'lerin sürüklenme işlemi desteklenir. Bir görüntüyü uygulamanın dışına sürüklemek, Şu anda Dosya Gezgini'ne bırakıldığında varsayılan bir dosya adı (örneğin, download.jpg) ile sonuçlanmaktadır.
  • Sürüklemeyi iptal etme. Etkin sürükleme işleminin isteğe bağlı iptali desteklenir, bu nedenle bir uygulama, sürükleme başlatıldıktan sonra kısıtlı veya kısa ömürlü içerik için sürükleme işlemlerini koşullu olarak engelleyebilir.
  • Özel sürükleme görselleri. Kullanıcıların sürüklenen içeriği net bir şekilde tanımlamasına yardımcı olmak için simgeler veya önizlemeler gibi özel sürükleme kullanıcı arabirimi desteklenir.
  • Özelleştirilebilir sürükleme verileri. Sürükleme verilerini düzenleme ve özelleştirme desteklenir, böylelikle uygulamaya özel senaryolar, örneğin uygulamadan mesajların sürüklenmesi veya hedefte bırakıldığında okunabilecek bağlam verileri (örneğin "Kaynak: <uygulama adı>" gibi) eklenmesi mümkün kılınır.

Limitations:

  • şu anda dahil olmak üzere DownloadURLbazı ek sürükleme veri türleri desteklenmez.

Gereksinimler:

  • En düşük WebView2 Çalışma Zamanı sürümü (Edge Beta kanalı): 144.0.3719.11.
Depolama Seçicileri güncelleştirmeleri

Microsoft.Windows.Storage.Pickers API'si (Windows Uygulama SDK'sı 1.8'de kullanıma sunulmuştur) geliştiricilerin daha kolay gezinme için ilk ve kalıcı klasör konumlarını ve grup dosya türü filtrelerini net etiketlerle ayarlamasına izin vererek dosya ve klasör seçimini kolaylaştıracak şekilde genişletildi.

  • FileOpenPicker FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder ve Title ekler.
  • FileSavePicker, InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, SuggestedStartFolder ve Title ekler.
  • FolderPicker, PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder ve Title ekler.
Microsoft. UI. İçerik eklemeleri
  • Göreli açılır pencere konumlandırma. Yeni PopupAnchor API, DesktopPopupSiteBridge için, açılan pencerelerin yalnızca ekran koordinatları kullanılarak kesinlikle konumlandırılabilmesi sınırlamasını ortadan kaldırarak, sahip olduğu pencereye veya adaya bağlanarak göreli konumlandırmayı destekler. Yeni DesktopPopupSiteBridge.AnchoringBehavior ve DesktopPopupSiteBridge.AnchoringPixelAlignment özellikler bağlama davranışını denetler.
  • Klavye ipuçları kılavuzu. Yeni InputFocusController.ShouldShowKeyboardCues özellik, geliştiricilere bir ContentIslandoluşturulduktan hemen sonra klavye ipuçlarının gösterilip gösterilmeyeceğini gösterir.
  • PointerPoint kolaylık API'si. Yeni PointerPoint.GetCurrentPoint yöntemi, geliştiricilerin sağlanan PointerPoint biriminden aktif pointerId verileri almasını sağlar.
Microsoft. UI. Xaml.Controls.SystemBackdropElement

Yeni Microsoft.UI.Xaml.Controls.SystemBackdropElement, uygulamaların yuvarlatılmış arka plan alanları için FrameworkElement özelliğiyle XAML düzeni içinde herhangi bir yere Mica veya Akrilik gibi bir sistem arka planı yerleştirmesini sağlayan basit bir CornerRadius. WinUI 3'te, uygulama içi akrilik efektlerinin WinUI 2'de AcrylicBrush.BackgroundSource yardımıyla kolaylıkla elde edilebilen doğrudan bir eşdeğerinin olmaması sorununu giderir.

Paket dağıtımı ve doğrulaması

Microsoft.Windows.Management.Deployment ad alanı, paketlerin üzerine hazırlanan depolama birimlerini yönetmek için bir paket doğrulama çerçevesi ve PackageVolume API'sini ekler.

  • Doğrulayıcıları. Yeni IPackageValidator arabirim ve yeni PackageCertificateEkuValidator özelliği aracılığıyla PackageFamilyNameValidatorPackageMinimumVersionValidatorAddPackageOptions bağlanabilen üç yerleşik doğrulayıcı ( / , StagePackageOptions, PackageValidators). PackageValidationEventArgs, PackageValidationEventSource, ve PackageValidationHandler doğrulama olayları taşır; IsPackageValidationSupported ve GetValidationEventSourceForUri dağıtımı başlatmadan önce çağıranların desteği yoklamasına olanak tanır.
  • Paket Hacmi. Çalışma zamanı yetenek algılama (PackageVolume) için GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync, IsFeatureSupported ve PackageVolumeFeature ile yeni tür.
Özel XAML Koşulluları (IXamlCondition)

Yeni IXamlCondition arabirim, geliştiricilerin XAML'nin koşullu ad alanı söz dizimi ile tümleşen ve XAML ayrıştırma zamanında değerlendirilen özel koşullar tanımlamasına olanak tanır. Bu, deneysel IXamlPredicate arabirimin yerini alır. Özel koşullar özellik bayrakları, cihaz özellikleri, iş mantığı, yapılandırma ayarları ve diğer çalışma zamanı koşulları gibi uygulamaya özgü faktörleri temel alan koşullu XAML senaryolarını etkinleştirir.

Hata düzeltmeleri
  • WindowsAppSDK yükleyicisinin yükleme sırasında ilerleme göstermediği ve durdurulmuş gibi görünmesine neden olan bir sorun düzeltildi. Yükleyici artık daha net bir ilerleme geri bildirimi sağlar.
  • Sınıf kitaplıkları için etkinleştirilen WindowsAppSDKSelfContained senaryolar için geliştirilmiş hata işleme.
  • Windows Uygulama SDK'sı NuGet MSB8027 dosyalarındaki yinelenen LNK4042 öğelerinin neden olduğu ClCompile ve .targets derleme uyarılarını, önişlemci tanımlarını <Target> bloklarından <ItemDefinitionGroup>'e taşıyarak düzeltildi. Bilinen bir MSVC iç derleyici hatasından kaçınmak için ARM64EC+LTCG derlemeleri için bir geri çevirme geçici çözümü (WindowsAppSDK_Arm64EcCompilerWorkaround) eklenmiştir.
  • Öğeler listesi güncellendikten sonra klavye gezintisi (Sekme/Shift+Sekme) sırasında ListView'de oluşan kilitlenme düzeltildi.
  • Denetleyici görünür değilken odak CoreWebView2Controller üzerine taşındığında WinUI 3'ün kilitlenmesine neden olan bir sorun düzeltildi.
  • Bazı senaryolarda DeleteIndex ile artık başarısız olmayacak şekilde ERROR_SHARING_VIOLATION güvenilirliği artırıldı (Uygulama İçeriği Arama; deneysel kanalda kalır).
  • Bazı uç durumlarda negatif değerler döndüren OCR sınırlayıcı kutuları düzeltildi.
  • Aynı işlemde RegisterCertifiedAsync'yi tekrar çağırmanın yanlış bir şekilde 0 yürütme sağlayıcısı (EP) döndürmesine neden olan Windows ML hatası düzeltildi.
2.0 sürümüne yükseltme

Bu sürüm, nuget geçişli başvurularının yeniden düzenlenmesini içerir. Mevcut bir C++ projesini yükseltmek için, mevcut Windows Uygulama SDK'sı paketi başvurularını kaldırmak ve yeni başvuruyu eklemek için araçları (nuget.exe veya Visual Studio) kullanmanızı öneririz. Bu, packages.configtabanlı projelerle ilgili yükseltme sorunlarına geçici bir çözümdür.

2.0 Experimental7'den yükseltme. Deneysel Microsoft.WindowsAppSDK.ML paketi 2.0.0 kararlıdan daha yüksek bir yama numarasıyla gönderilir ve bu da NuGet düşürme hatası olarak ortaya çıkar (özellikle C++ projelerinde). Experimental7'deyseniz, 2.0.0'a başvurmadan önce deneysel paketi kaldırmak için NuGet Kaldırma kılavuzunu izleyin.

Önceki önizleme içeriğiyle ilgili notlar
  • Uygulama İçerik Araması deneysel olmaya devam eder. temel bilgileri geliştirmek ve gelecekteki uyumluluğu sağlamak için Microsoft.Windows.Search.AppContentIndex API yüzeyi (Uygulama İçeriği Arama) 2.0-Preview2 sürümünde kaldırıldı. 2.0.1 kararlı olarak dahil değildir . Deneme yapmak için deneysel sürümleri kullanmaya devam edin. Deneysel Microsoft.Windows.Search paketini daha önce yüklediyseniz, 2.0.1 kararlı sürümüne geçmeden önce NuGet Uninstall kılavuzu aracılığıyla kaldırın.
  • API'ler zaten 1.8 servis güncellemesinde gönderildi. 2.0 döngüsü sırasında önizlemesi yapılan bazı deneysel özellikler 1.8 bakım sürümlerinde kararlı API'lere yükseltildi ve bu nedenle 2.0.1 sürümünde yeni değildir. Bunlar arasında (1.8.3), ModelCatalog (1.8.4) ve TextRewriter.RewriteCustomAsync artı SplitMenuFlyoutItem (1.8.6) bulunur SplitMenuFlyoutItemAutomationPeer . Ayrıntılar için 1.8 sürüm notlarına bakın.
Bilinen sorunlar
  • AICapabilities 2.0.1'den eksik. Microsoft.Windows.AI.AICapabilities ve AICapabilityCategory.CopilotPlusPCCapable (Copilot+ PC özellik denetimi) 1.8.7'de gönderildi ancak 2.0.1'e gelmedi. Mayıs sürümünde bunları geri yüklemeyi planlıyoruz.
2.0.1 için yeni API'ler

Bu sürüm, kararlı 1.8.7 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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
2.0-Preview2 ile karşılaştırıldığında yeni API'ler
Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Sürüm 2.0 Önizleme 2 (2.0.0-Preview2)

Yayın tarihi: 31 Mart 2026

Windows ML

Microsoft.WindowsAppSDK.ML NuGet paketi yeniden düzenlenerek yeni bir temel bağımlılık eklendi. Mevcut ML NuGet paketinin işlevselliği aynı kalır, ancak temel Windows ML özellikleri Microsoft.Windows.AI.MachineLearning adlı temel bağımlı paket olarak yeniden düzenlenmiştir. Bu yeni paket çok az sayıda bağımlılık içerir, ancak C#/WinRT veya C++/WinRT'de yalnızca Windows 10 18362'ye kadar destekler. Windows 10 17763 desteğine ihtiyacınız varsa mevcut Microsoft.WindowsAppSDK.ML paketini kullanın.

Yeni geçişli bağımlılıklar için, paketi (nuget.exe veya VS) yükseltmek için araçları kullanmanızı öneririz. Ayrıca bkz. Windows Uygulama SDK'sı 1.6 sürüm notları.

ONNX Çalışma Zamanı güncelleştirildi

ONNX Çalışma Zamanı sürümü 1.24.4 sürümüne güncelleştirildi. Daha fazla bilgi için bkz. ONNX Çalışma Zamanı sürümleri .

Windows AI API'leri

Phi Silika API'lerinin Sınırlı Erişim Özelliğinin parçası olması zorunlu kılındı.

Yapay zeka modeli yüklemesi sırasında çeşitli ağ ve Windows Update hataları için denetimler eklendi, ayrıca kullanıcıların model paketlerinin neden yüklenemediğini anlaması için sürekli başarısızlıkları işaretliyoruz.

Windows yapay zeka senaryolarında kullanılan Metin Zekası API'leri için iyileştirilmiş tanılama.

Uygulama İçeriği Arama

Temel yapay zeka modelleri değiştikçe temelleri geliştirmek ve gelecekteki uyumluluğu sağlamak için çalışırken Uygulama İçerik Araması 2.0 önizleme sürümünden kaldırılmıştır. Bu arada, en son değişiklikleri denemek için lütfen deneysel kanalı kullanmaya devam edin.

WebView2 (WinUI 3)

WinUI 3 uygulamalarında barındırılan WebView2 içeriği için sürükleme desteği etkinleştirildi. Bu özellik daha önce desteklenmiyordu ve artık yeni genel API'ler sunulmadan kullanılabilir. Not: Dış kaynaklardan WebView2'ye bırakma işlemi zaten desteklenmektedir.

Desteklenen senaryolar

  • Standart sürükle ve bırak içeriği Metin, HTML, resimler ve URL'lerin sürüklenme işlemi desteklenir. Geçerli davranışa bağlı olarak, görüntüleri uygulamanın dışına sürüklemek, Dosya Gezgini'ne bırakıldığında varsayılan bir dosya adı (örneğin, download.jpg) ile sonuçlanmaktadır. Örnek senaryo: Kullanıcı WebView2 içindeki metni veya görüntüyü seçer ve uygulama içinde veya Dosya Gezgini gibi başka bir hedefe sürükler.

  • Sürükleme iptali Etkin sürükleme işleminin isteğe bağlı iptali desteklenir. Örnek senaryo: Uygulama başlatıldıktan sonra sürüklemeyi iptal ederek belirli içerik türleri (kısıtlı veya kısa ömürlü içerik gibi) için sürükleme işlemlerini koşullu olarak engeller.

  • Özel sürükle görselleri Kullanıcıların sürüklenen içeriği net bir şekilde tanımlamasına yardımcı olmak için simgeler veya önizlemeler gibi özel sürükleme kullanıcı arabirimi desteklenir. Örnek senaryo: Bir uygulama, bir kullanıcı medya içeriğini sürüklerken küçük resim önizlemesi veya simgesi görüntülüyor ve bu da şu anda hangi öğenin taşındığını açıkça belli ediyor.

  • Özelleştirilebilir sürükleme verileri Sürükleme verilerini düzenleme ve özelleştirme desteklenir ve uygulama içindeki iletileri sürükleme gibi uygulamaya özgü senaryoları etkinleştirir (örneğin, ileti iletme için alternatif bir etkileşim olarak). Örnek senaryo: Uygulama, sürükleme yükünü kaynak uygulama adı gibi bağlamsal meta verileri içerecek şekilde özelleştirir. İçerik bırakıldığında, hedef, sürüklenen içeriğin kaynağını belirtmek için "<uygulama adı> gibi bilgiler"i görüntüleyebilir veya işleyebilir.

Sınırlamalar

  • Ek sürükleme veri türleri desteği sınırlıdır. Aşağıdaki biçimler şu anda desteklenmiyor:
    • DownloadURL

Gereksinimler

  • En düşük WebView2 Çalışma Zamanı sürümü (Edge Beta kanalı): 144.0.3719.11
Özel XAML Koşulluları (IXamlCondition)

Arabirim, IXamlCondition geliştiricilerin XAML'nin koşullu ad alanı söz dizimi ile tümleşen ve XAML ayrıştırma zamanında değerlendirilen özel koşullar tanımlamasına olanak tanır. Bu, deneysel IXamlPredicate arabirimin yeniden adlandırılması ve kararlı sürüme geçişidir. Özel koşullar özellik bayrakları, cihaz özellikleri, iş mantığı, yapılandırma ayarları ve diğer çalışma zamanı koşulları gibi uygulamaya özgü faktörleri temel alan koşullu XAML senaryolarını etkinleştirir.

Hata düzeltmeleri
  • <Target> bloklarındaki ön işlemci tanımları <ItemDefinitionGroup> bloklarına taşınarak Windows Uygulama SDK'sı NuGet .targets dosyalarındaki yinelenen ClCompile öğelerinin neden olduğu MSB8027 ve LNK4042 derleme uyarıları düzeltildi. Bilinen bir MSVC iç derleyici hatasından kaçınmak için ARM64EC+LTCG derlemeleri için bir geri çevirme geçici çözümü (WindowsAppSDK_Arm64EcCompilerWorkaround) eklenmiştir.
  • Öğeler listesi güncellendikten sonra klavye gezintisi (Sekme/Shift+Sekme) sırasında ListView'de oluşan kilitlenme düzeltildi.
  • WinUI 3'ün, denetleyici görünür değilken odak CoreWebView2Controller'a taşındığında çökebileceği bir sorun düzeltildi.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0-Preview1 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş API'leri içerir:

Microsoft.UI.Xaml.Markup

    IXamlCondition

Sürüm 2.0 Önizleme 1 (2.0.0-Önizleme1)

Yayın tarihi: 13 Şubat 2026

Windows ML
  • Windows ML'deki ONNX Çalışma Zamanı sürümü 1.24 RC'ye güncelleştirildi
  • RegisterCertifiedAsync'in aynı işlemde yeniden çağrılırsa hatalı bir şekilde 0 yürütme sağlayıcısı (EP) döndürmesine neden olan bir hata düzeltildi
Microsoft.UI.Content
  • Yeni InputFocusController.ShouldShowKeyboardCues özelliği, geliştiricilere bir ContentIsland oluşturulmasından hemen sonra klavye ipuçlarının gösterilip gösterilmeyeceğini belirlemede yardımcı olur.
  • Geliştiricilerin sağlanan PointerPoint.GetCurrentPoint'dan etkin PointerPoint verilerini almasına olanak tanıyan yeni kullanışlı bir API pointerId.
Uygulama İçeriği Arama
  • Geliştirilmiş DeleteIndex güvenilirlik. Bazen DeleteIndex, ERROR_SHARING_VIOLATION hatası ile başarısız olur.

  • Bazı kenar durumlarında negatif değerler döndüren OCR sınır kutuları için bir düzeltme.

  • Uygulama İçeriği Arama, Microsoft.Windows.Search parçası olmak yerine ayrı bir Microsoft.Windows.AI package paketinin parçasıdır.

  • Ön ek aramanın kısa sorgu dizeleriyle çalışmaması sorunu düzeltildi.

  • Yeni API'ler ve resmi API incelemesine dayanarak yeniden adlandırmalar.

    • AppContentIndexer
      • Yeniden İndeksleme Gereken İçerik Öğelerini Al
      • Kaldır -> İçerik Öğesini Kaldır
      • RemoveMultiple -> İçerik Öğelerini Kaldır
      • TümİçerikÖğeleriniKaldır
      • İçerikDizinlemeDurumunuAl -> İçerikÖğesiDurumunuAl
      • Çoklu İçerik İndeksleme Durumunu Al -> İçerik Öğesi Durumlarını Al
      • GetContentItems
    • AppContentIndexListener
      • DizinlemeDurumuDeğişti -> İçerikÖğesiDurumuDeğişti
    • AppIndexTextQuerySession
      • GüncellemeSorgusu -> GüncellemeSorgusuİfadesi
      • EnSonuç -> SonuçAl
      • MostRecentResultChanged -> SonuçDeğiştirildi
    • AppIndexImageQuerySession
      • GüncellemeSorgusu -> GüncellemeSorgusuİfadesi
      • EnSonuç -> SonuçAl
      • MostRecentResultChanged -> SonuçDeğiştirildi
    • AppManagedImageQueryMatch
      • Alt Bölge -> RegionOfInterest
    • İçerik Öğesi Durum Sonucu
      • Yeniden Dizinleme Durumu * İçerik Öğesi Yeniden Dizinleme Durumu
    • TextQuerySessionResult
      • IsValid
    • ImageQuerySessionResult
      • IsValid
    • İçerik Öğesi Sorgulama Filtre Bayrakları
Hata Düzeltmeleri
  • WindowsAppSDK yükleyicisinin yükleme sırasında ilerleme göstermediği ve durdurulmuş gibi görünmesine neden olan bir sorun düzeltildi. Yükleyici artık daha net bir ilerleme geri bildirimi sağlar.
  • WindowsAppSDKSelfContained'in sınıf kitaplıkları için etkinleştirildiği senaryolarda geliştirilmiş hata işleme.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 1.8.5 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:


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

Sürüm 2.4 Deneysel (2.4.1-Deneysel)

Yayın tarihi: 25 Ağustos 2026

Bu deneysel sürüm, Windows Uygulama SDK'sı 2.4.0 kararlı sürümünü izler ve genellikle bu sürümdeki değişiklikleri getirir; bu ayrıntılar için 2.4.0 kararlı notlarına bakın. Aşağıdaki bölümlerde yalnızca deneysel eklemeler açıklanmaktadır.

Mürekkep Oluşturma Desteği

Bu sürüm, Kalem ve dokunma girişi, pano desteği, yüksek karşıtlık desteği, vuruş girişi ve işlenmemiş giriş dahil olmak üzere InkCanvas, InkToolbar ve InkPresenter aracılığıyla WinUI 3 için mürekkep oluşturma desteği ekler. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.3 Deneysel A sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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

Sürüm 2.3 Deneysel A (2.3.2-ExperimentalA)

Yayın tarihi: 30 Temmuz 2026

Bu deneysel sürüm, Windows Uygulama SDK'sı 2.3.1 kararlı sürümünde derlenmiştir; bu sürümdeki değişiklikler için 2.3.1 kararlı notlarına bakın. Aşağıdaki bölümlerde yalnızca deneysel eklemeler açıklanmaktadır.

Window.Width ve Window.Height

Yeni deneysel Window.Width ve Window.Height özellikleri, Window.AppWindow'a ulaşmadan ve el ile mantıksaldan fiziksele DPI dönüştürme işlemi gerçekleştirmeden uygulamalara doğrudan koddan veya işaretlemeden bir pencerenin boyutunu mantıksal (istemci) piksel olarak almak ve ayarlamak için DPI kullanan bir yol sağlar. Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth ve Window.MaxHeight özellikleri pencerenin boyutunu kısıtlar. Geri bildiriminizi bekliyoruz.

Konuşma Tanıma Güncelleştirmeleri

Deneysel SpeechAudioProvider (16 kHz, 16 bit, tek kanallı PCM sesini konuşma tanımaya göndermek için kullanılır) artık IClosable'ı uygulayarak uygulamaların ses akışını tamamladığında sağlayıcıyı Close/Dispose ile belirleyici bir şekilde serbest bırakabilmesini sağlar.

Uygulama İçerik Dizini Güncelleştirmeleri

Deneysel Uygulama İçeriği Dizini API'leri, bu sürümde yeni dizin oluşturma özellikleri ve önemli güvenilirlik ve performans geliştirmeleri ekler:

  • Daha hızlı toplu dizin oluşturma. Yeni bir AppContentIndexer.BatchAddOrUpdate API'si birden çok öğenin birlikte dizine alınmasını sağlar. Dizin oluşturma işlem hattı da paralel aşama yürütmeyi ve daha verimli toplu işlemeyi destekleyecek şekilde yeniden tasarlanmıştır.
  • Çok dilli belirteçleme geliştirildi. Uygulama İçerik Dizini artık ICU tabanlı bir sözcük ayırıcı kullanıyor ve bu da WinRT WordsSegmenter bağımlılığını kaldırırken diller arasında belirteçleştirme doğruluğunu geliştiriyor.
  • Dizin oluşturma ve sorgu performansı iyileştirildi. Dizin güncelleştirmeleri artık gereksiz sözcük temelli yeniden yazmalardan kaçınır, toplu temizleme daha verimli çalışır ve sorgular arasında dizin özelliklerini önbelleğe alır ve ortak sorgu ve dizin oluşturma yollarındaki ek yükü önemli ölçüde azaltır.
  • Daha kararlı sözcük temelli derecelendirme. BM25 puanlaması artık belge uzunluğu istatistiklerini bağımsız olarak tutarak, içerik kademeli olarak güncellendiğinde veya kaldırıldığında tutarlı sıralamayı korur.
  • Otomatik bozulma kurtarma. Uygulama İçerik Dizini, bir dizini açarken veritabanı bozulmasını ve uyumsuz şema değişikliklerini algılar ve dizini kullanılamaz durumda bırakmak yerine yeniden dizin başlatarak otomatik olarak kurtarılır. GetOrCreateIndexStatus.RecoveredFromCorruption kurtarmanın ne zaman gerçekleştiğini gösterir.
  • Statik sıralama artırımları. Yeni API'ler, uygulamaların tek tek içerik öğelerine veya bölgelere derecelendirme artışı uygulamasına olanak tanıyarak uygulama tarafından sağlanan sinyaller kullanılarak sonuçların yanlı olmasına olanak tanır. Örneğin, uygulamanız içeriğin kendisi tarafından yakalanmayan içeriğin göreli önemi hakkında bilgi sahibi olduğunda statik artışları kullanarak özellikle önemli olan veya kullanıcılarınız tarafından yaygın olarak aranan bir belgenin ortaya çıkarılmalarına yardımcı olun.
  • Görüntü içeriği indeksleme. Uygulamalar artık bit eşlem veya görüntü akışı içeriğini doğrudan dizine alabilir ve seçenekler OCR ayıklamasını ve ayıklanan metnin anlamsal dizinini denetleyebilir. Anlamlı ve aranabilir bilgiler zaten metin olarak mevcut olmak yerine bir görüntünün içinde yer alıyorsa, örneğin ekran görüntülerinde, taranmış belgelerde veya diğer görsel içeriklerde, görüntü dizinlemeyi kullanın.
  • Metin için anlamsal dizin oluşturma denetimi. Yeni bir ContentRegionTextOptions.AllowSemanticIndexing özelliği, uygulamaların tek tek metin bölgelerini semantik dizin oluşturma dışında seçmesine olanak tanır. Bu, sözcük temelli aranabilir olarak kalması gereken ancak anlamsal eşleştirmeden yararlanma olasılığı düşük olan metinler için kullanışlıdır ve uygulamalara anlamsal alma işlemine hangi içeriğin katılacağı üzerinde daha fazla denetim sağlar.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.2 Deneysel 9 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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

Sürüm 2.2 Deneysel 9 (2.2.2-Experimental9)

Yayın tarihi: 9 Haziran 2026

Bu deneysel sürüm Windows Uygulama SDK'sı 2.2.0 kararlı ile birlikte gelir ve bu sürümdeki değişiklikleri genellikle getirir; bu ayrıntılar için 2.2.0 kararlı notlarına bakın. Aşağıdaki bölümlerde yalnızca deneysel eklemeler açıklanmaktadır.

GPU'da Dil Modeli API'leri [Deneysel]

Dil Modeli API'leri artık desteklenen bir GPU ile donatılmış Copilot+ PCs olmayan cihazlarda çalıştırılır ve yerel dil modeli özellikleri daha geniş bir Windows 11 cihazı yelpazesine sunulur. Desteklenen donanımlar NVIDIA GeForce RTX 30 serisini ve 6+ GB vRAM ile daha yeni bir sürümü içerir. GPU ile çıkarım, Geliştirici Modu’nun etkinleştirilmesini ve bir Windows Insider Experimental Channel derlemesini gerektirir.

GPU modeli önceden yüklenmemiş. EnsureReadyAsync Windows Update aracılığıyla istek üzerine indirilir. Uygulamalar, indirmeyi tetiklemeden önce GetReadyState denetlemeli ve bir onay iletişim kutusu göstermelidir. Kullanıcılar modeli Ayarlar > Sistem > AI Bileşenleri sayfasından yönetebilir.

Sorumlu yapay zeka yönergeleri için yeni Saydamlık Notu'na bakın: Copilot+ olmayan bilgisayarlarda Dil Modeli API'leri.

Konuşma Tanıma API'leri [Deneysel]

Microsoft.Windows.AI.Speech'daki yeni cihaz içi konuşma tanıma API'leri hem toplu işlemi hem de konuşmayı metne akışla aktarmayı etkinleştirir. BatchRecognition, tek bir çağrıda tam bir ses kaynağını tanır ve StreamingRecognition, Recognizing ile Recognized olaylarını tetikler. Ses bir cihazdan (), dosyadan (AudioConfiguration.FromAudioDeviceFromFile), giriş akışından ()FromStream kaynaklanabilir veya arayan tarafından (16 kHz, 16 bit, tek kanallı PCM) aracılığıyla SpeechAudioProvider gönderilebilir. Cihaz içi model aracılığıyla SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsyncyönetilir ve indirme ve yükleme ilerleme durumu aracılığıyla SpeechRecognitionModelProgressbildirilir.

Yeni NpuType API'si

Yeni bir Microsoft.Windows.Workloads.NpuType numaralandırması, geçerli cihazdaki NPU sınıfını (örneğin Qnn, Lnl, Stx, Win365, Unknown, None) gösterir; böylece uygulamalar ve İş Yükleri altyapısı, yapay zeka iş yüklerini uygun yürütme yoluna yönlendirebilir.

Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.1 Experimental 8 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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

Sürüm 2.1 Deneysel 8 (2.1.4-Deneysel8)

Yayın Tarihi: 21 Mayıs 2026

Bu deneysel sürüm Windows Uygulama SDK'sı 2.1.3 kararlı ile birlikte gelir ve bu sürümdeki değişiklikleri genellikle getirir; bu ayrıntılar için 2.1.3 kararlı notlarına bakın. Aşağıdaki bölümlerde yalnızca deneysel eklemeler açıklanmaktadır.

Yapılandırılmış JSON yanıtları için kesin olarak yazılan sonuç ve durum [Deneysel]

LanguageModelExperimental.GenerateStructuredJsonResponseAsync (2.0 Experimental 7’de kullanıma sunulan) artık genel GenerateStructuredJsonResponseResultGenerateStructuredJsonResponseStatusLanguageModelResponseResult çifti yerine, / özelliğine sahip özel bir LanguageModelResponseStatus türü döndürür. Yeni durum sabit listesi şema kısıtlanmış oluşturma işlemine özeldir: model çıkışının istenen JSON şemasını karşılamadığı durum için genel dil modeli yanıt hatalarından ayrı bir ResponseInvalidJson değer içerir.

Bu ayrımın bir parçası olarak, ResponseInvalidJson değeri kararlı enum’undan LanguageModelResponseStatus (bu değer daha önce yapılandırılmış JSON çıktısını desteklemek için eklenmişti). ResponseInvalidJson kaynağından gelen LanguageModelResponseStatus öğesini işleyen uygulamalar, bu işlemeyi GenerateStructuredJsonResponseStatus tarafından döndürülen yeni GenerateStructuredJsonResponseAsync üzerine taşımalıdır. Diğer çağıranların LanguageModelResponseStatus artık JSON'a özgü bir hata değerini hesaba katmaları gerekmez.

Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0 Deneysel 7 sürümüyle karşılaştırıldığında aşağıdaki yeni API'leri içerir:

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]

Sürüm 2.0 Deneysel 7 (2.0.0-Experimental7)

Yayın tarihi: 21 Nisan 2026

CMake Desteği [Deneysel]

Windows Uygulama SDK'sı 2.0.0-experimental7, C++ geliştiricilerinin CMake tabanlı projelerden Windows Uygulama SDK'sı NuGet paketlerini kullanmasına olanak tanıyan deneysel CMake desteğini (etkin geliştirme aşamasında) kullanıma sunar.

CMake tümleştirmesi, NuGet paket yönetimi ile CMake'nin yerel iş akışı arasındaki boşluğu kapatan açık kaynak bir CMake modülü olan find_package() oluşturulur. NuGetCMakePackage, add_nuget_packages() aracılığıyla, NuGet paketlerinin yapılandırma zamanında indirilmesini ve geri yüklenmesini yönetir, her paketi ekli bir CMake yapılandırması için (konumunda bulunan build/cmake/<package>-config.cmake) kontrol eder ve paketin başlık dosyalarını, bağlantı kitaplıklarını, çalışma zamanı DLL'lerini ve WinRT meta verilerini standart CMake hedefleri olarak kullanıma sunar.

Her Windows Uygulama SDK'sı NuGet bileşeni ve bağımlı paketi artık build/cmake/ altına bir CMake yapılandırma dosyası ekler. Bu dosya, NuGetCMakePackage kitaplığının yardımıyla CMake'nin find_package() el ile yol yapılandırması olmadan hedefleri, üst bilgileri, kitaplıkları ve çalışma zamanı DLL'lerini otomatik olarak bulmasını sağlar. Bu, Temel ve Çalışma Zamanı gibi bağımlılıkların yanı sıra Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML ve WinUI gibi tüm bileşen paketlerini kapsar.

CMake tüketim modeline genel bakış ve başlangıç kılavuzu için CMake giriş sayfasına bakın.

Bu özellik deneyseldir ve topluluk geri bildirimlerini toplamak için erken saatlerde sunulmaktadır. Hedef adlandırma kuralları ve yapılandırma desenleri, geliştirici girişine göre değiştirilebilir. Bu erken bir uçuş olduğundan, bazı törenler ve kurulumlar söz konusudur. Lütfen dört dağıtım senaryosunda uçtan uca yapılandırmayı ve kullanımı gösteren CMake örnek uygulamalarına bakın (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Görüşlerinizi almak isteriz! Şu anda ele alınmayan bir senaryoyla karşılaşırsanız, geliştirici deneyimini geliştirmek için önerileriniz varsa veya sorunlarla karşılaşırsanız, lütfen Windows Uygulama SDK'sı açık kaynak deposundaki Issues sekmesinin altında geri bildirim gönderin veya Discussions içinde bir konuşma başlatın. Girişiniz bu özelliğin etkin geliştirmesini doğrudan şekillendirecektir.

Önizleme kanalından öne çıkarılan değişiklikler

Bu deneysel sürüm, 2.0-Preview1 ve 2.0-Preview2 sürümlerinde sunulan değişiklikleri ve düzeltmeleri toplar. Öne çıkarılan öğeler aşağıda özetlenmiştir; tüm ayrıntılar için bağlantılı Önizleme sürüm notlarına bakın.

2.0-Preview1 sürümünden:

  • Windows ML: Aynı işlemde yeniden çağrıldığında 0 yürütme sağlayıcısı döndürme problemi düzeltildi.
  • Microsoft. UI. content: Yeni InputFocusController.ShouldShowKeyboardCues özelliği ve yeni kolaylık API'si PointerPoint.GetCurrentPoint.
  • Microsoft.Windows. Management.Deployment: PackageVolume ile parity+ için yeni Windows.Management.Deployment API'leri (AddAsync dahil, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported ve daha fazlası). Yeni IPackageValidator ve AddPackageOptions üzerinde StagePackageOptions genişletilebilirlik noktası, üç yerleşik doğrulayıcı içerir: PackageCertificateEkuValidator, PackageFamilyNameValidator ve PackageMinimumVersionValidator.
  • Microsoft.Windows. Storage.Pickers:
    • Özel iletişim kutusu başlıklarını etkinleştiren Title, FileOpenPicker, ve FileSavePicker üzerindeki yeni FolderPicker özellikler.
    • SettingsIdentifier, FileOpenPicker ve FileSavePicker üzerindeki yeni FolderPicker özellikleri, oturumlar arasında seçici örneğe özgü durumları etkinleştirir.
    • InitialFileTypeIndex ve FileOpenPicker üzerinde, FileSavePicker yeni özellikler, geliştiricilerin varsayılan seçili dosya türü filtresini, dizin üzerinden (sıfırdan başlayarak) ayar yapmalarına olanak sağlar.
    • Yeni ShowOverwritePrompt özelliği FileSavePicker üzerinde. Varsayılan olarak true 'a ayarlanmıştır ve kullanıcı FileSavePicker aracılığıyla mevcut bir dosya seçtiğinde, seçicinin üzerine yazma konusunda uyarı verip vermeyeceğini denetler.
    • varsayılan davranışı FileSavePickerdeğiştirildi: WindowsAppSDK 2.0'dan başlayarak, FileSavePicker kullanıcı var olmayan bir dosya seçtiğinde boş bir dosya OLUŞTURMAZ ve geliştiricilerin dosyayı ne zaman yapacağına karar vermesine olanak tanır.
    • PickMultipleFoldersAsync üzerinde yeni FolderPicker yöntemi, tek bir işlemde birden çok klasörü seçmeyi etkinleştirir.
  • Hata düzeltmeleri: Yükleyici ilerleme durumu raporlaması; sınıf kitaplıkları için WindowsAppSDKSelfContained geliştirilmiş hata işleme.

2.0-Preview2 sürümünden:

  • Windows AI API'leri: Phi Silica API'leri Sınırlı Erişim Özelliği olarak zorunlu kılındı; yeni AIFeatureReadyState değerleri eksik özellikler, uyumsuz donanım ve gerekli işletim sistemi güncelleştirmeleri gibi model alma sorunlarını ortaya çıkarıyor; dayanıklı ağ/Windows Update yükleme hataları artık işaretleniyor; Metin Zekası API'leri için iyileştirilmiş tanınabilirlik.
  • Özel XAML Koşullulları: IXamlCondition deneysel IXamlPredicate arabiriminin tamamlanmasını ve yeniden adlandırılmasını sağlar, böylece XAML ayrıştırma zamanında değerlendirilen özel koşulları etkinleştirir.
  • WebView2 (WinUI 3): WebView2'de barındırılan içerik (metin, HTML, resimler, URL'ler) için sürükleme desteği, sürükleme iptali, özel sürükleme görselleri ve özelleştirilebilir sürükleme verileri sağlanmaktadır. WebView2 Çalışma Zamanı 144.0.3719.11 veya üzerini gerektirir. (DownloadURL henüz desteklenmiyor.)
  • Hata düzeltmeleri: Dosyalardaki yinelenen ClCompile öğelerinden kaynaklanan MSB8027/LNK4042 derleme uyarıları (ARM64EC+LTCG için alternatif çözüm .targets ile); Öğe listesi güncellendikten sonra klavye gezintisi sırasında ListView kilitlenmesi; Odak görünür olmayan bir CoreWebView2Controller'a taşındığında WinUI 3 kilitlenmesi.
Video Süper Çözünürlük
  • Netlik ve tutarlılık için API yeniden adlandırma geçişi:
    • ScaleFrameStatus → VideoScalerStatus
    • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
    • VideoScaler.ScaleFrame VideoScaler.Scale→ veVideoScaler.ScaleImageBuffer
  • VSR'de çeşitli hata düzeltmeleri ve kalite geliştirmeleri.
Windows AI Dil Modeli
  • Bir dil modelinden yapılandırılmış JSON çıktısı oluşturmak için LanguageModelExperimental.GenerateStructuredJsonResponseAsync altında yeni Microsoft.Windows.AI.Text.Experimental API'si.
  • Modelin geçerli JSON olarak ayrıştırılmayan bir yanıt döndürdüğünü belirten yeni LanguageModelResponseStatus.ResponseInvalidJson durum değeri.
Uygulama İçeriği Dizin Oluşturucu
  • Yeni AppContentIndexer.GetExistingIndexes ve AppContentIndexer.IsContentKindSupported API'ler.
  • OCR'dan türetilen metin aracılığıyla uygulama içeriğini sorgulamayı desteklemek için yeni AppManagedOcrTextQueryMatch türü ve QueryMatchContentKind.AppManagedOcrText değeri.
  • Yeni GetOrCreateIndexOptions.CreateAlways bir dizin oluşturulmasını zorlamak.
  • Dizinleme sırasında düşük disk alanı hatalarını ortaya çıkarmak için yeni ContentItemErrorDetail.InsufficientDiskSpace.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0.0-experimental6 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

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

Sürüm 2.0 Deneysel 6 (2.0.0-Experimental6)

Yayın tarihi: 13 Mart 2026

Windows ML CMake desteği

Windows ML artık CMake kullanılarak C++ projelerinden kullanılabilir. Daha fazla bilgi edinmek için Başlarken sayfasına bakın.

ONNX Çalışma Zamanı güncelleştirildi

ONNX Çalışma Zamanı sürümü 1.24.2 sürümüne güncelleştirildi. Daha fazla bilgi için bkz. ONNX Çalışma Zamanı sürümleri .

Windows AI Dil Modeli
  • NPUPowerMode daha yeni güç yönetimi API'leri için kullanım dışı bırakılmıştır.
  • Şimdi GetReadyState, oturum aracısı kullanılamadığında bir hata fırlatmak yerine düzgün bir şekilde NotSupported döndürür.
Video Süper Çözünürlük
  • Video Süper Çözünürlük için NV12 çıkış biçimi desteği eklendi.
Uygulama İçeriği Arama
  • Geliştirilmiş DeleteIndex güvenilirlik. Bazen DeleteIndex, ERROR_SHARING_VIOLATION hatası ile başarısız olur.

  • Bazı kenar durumlarında negatif değerler döndüren OCR sınır kutuları için bir düzeltme.

  • Uygulama İçeriği Arama, Microsoft.Windows.Search parçası olmak yerine ayrı bir Microsoft.Windows.AI package paketinin parçasıdır.

  • Ön ek aramanın kısa sorgu dizeleriyle çalışmaması sorunu düzeltildi.

  • Yeni API'ler ve resmi API incelemesine dayanarak yeniden adlandırmalar.

    • AppContentIndexer
      • Yeniden İndeksleme Gereken İçerik Öğelerini Al
      • Kaldır -> İçerik Öğesini Kaldır
      • RemoveMultiple -> İçerik Öğelerini Kaldır
      • TümİçerikÖğeleriniKaldır
      • İçerikDizinlemeDurumunuAl -> İçerikÖğesiDurumunuAl
      • Çoklu İçerik İndeksleme Durumunu Al -> İçerik Öğesi Durumlarını Al
      • GetContentItems
    • AppCOntentIndexListener
      • DizinlemeDurumuDeğişti -> İçerikÖğesiDurumuDeğişti
    • AppIndexTextQuerySession
      • GüncellemeSorgusu -> GüncellemeSorgusuİfadesi
      • EnSonuç -> SonuçAl
      • MostRecentResultChanged -> SonuçDeğiştirildi
    • AppIndexImageQuerySession
      • GüncellemeSorgusu -> GüncellemeSorgusuİfadesi
      • EnSonuç -> SonuçAl
      • MostRecentResultChanged -> SonuçDeğiştirildi
    • AppManagedImageQueryMatch
      • Alt Bölge -> RegionOfInterest
    • İçerik Öğesi Durum Sonucu
      • Yeniden Dizinleme Durumu * İçerik Öğesi Yeniden Dizinleme Durumu
    • TextQuerySessionResult
      • IsValid
    • ImageQuerySessionResult
      • IsValid
    • İçerik Öğesi Sorgulama Filtre Bayrakları
Hata düzeltmeleri
  • Yarış durumu nedeniyle ImageDescription.DescribeAsync hatasının InternalError ile başarısız olması düzeltildi.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0.0-experimental5 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

Sürüm 2.0 Deneysel 5 (2.0.0-Experimental5)

Yayın tarihi: 13 Şubat 2026

Windows ML Lisans Basitleştirme
  • Windows ML ile uygulama oluşturan ISV'ler için daha net koşullara sahip basitleştirilmiş lisans sözleşmesi.
  • Yükleme, Veri ve Dağıtılabilir Kod'un daha net bir şekilde ele alınıp yeniden yapılandırılmış bölümleri.
  • Yeni Yürütme Sağlayıcısı (EP) Uyumluluk Bildirimi bölümü, donanım hızlandırmalı yürütme sağlayıcılarıyla ilgili geliştirici sorumluluklarını açıklar.
  • NVIDIA TensorRT, Intel OpenVINO ve Qualcomm QNN (Qualcomm Sinir Ağı SDK'sı) için satıcı lisans sözleşmelerine doğrudan bağlantılar.

Sürüm 2.0 Deneysel 4 (2.0.0-Experimental4)

Yayın tarihi: 13 Ocak 2026

ONNX Çalışma Zamanı Hizalama ve Yürütme Sağlayıcısı Kararlılığı
  • Windows ML deneysel derlemeleri, uyumluluk ve kararlılığı artırmak amacıyla ONNX Runtime ana sürüm 1.24 ile hizalanmaktadır.
  • Kararlı Uygulama İkili Arabirimi (ABI) yürütme sağlayıcıları, kararlı olmayan yürütme sağlayıcıları alım dışında tutularak cihazlar arasında öngörülebilir davranış sağlamak için zorunlu tutulur.
    • Yalnızca OpenVINO yürütme sağlayıcısı desteklenir ve kararlılık gereksinimlerini karşıladıkları için zaman içinde ek yürütme sağlayıcıları eklenir.
  • Microsoft.Windows.AI.MachineLearning.dll boyutu yaklaşık 160 KB azaltıldı.
Uygulama İçeriği Arama
  • Dizine alınan öğelerin istatistiklerini bulmak için yeni deneysel API'ler. Bu, dizinde neler olduğuna ilişkin görünürlük sağlar.
  • Geçerli sorgu tamamlanmadan önce uygulamaların sorgu çalıştırmasına ve yeni bir sorgu varsa bu sorguyu güncelleştirmesine izin vermek için Sorgu iptali desteği. Bu, kullanıcı sorgu dizesinde yazarken sorguya daha hızlı yanıt vermenizi sağlar.
  • Kullanıcı yazarken sonuçları iyileştirmek amacıyla kısa dizeler için prefix eşleştirme desteği.
Video Süper Çözünürlük Geliştirmeleri
  • VideoScaler artık tek kullanımlıktır ve kaynak yönetimini ve yaşam döngüsü denetimini geliştirir.
  • VSR modeli, performansı geliştirmek ve yinelenen başlatma maliyetlerini azaltmak için derlenir ve önbelleğe alınır.
  • Kullanmadan önce VSR desteğini doğrulamak için bir yetenek denetimi eklendi.
  • Video Süper Çözünürlüğü kullanılırken artık WinML'nin açık bir şekilde başlatılması gerekli değildir.
WinUI FlowLayout Aralığı geliştirmeleri
  • Denetim FlowLayout artık yatay ve dikey aralık özellikleri yerine ItemSpacing ve LineSpacing terminolojisini kullanıyor. Uyumlu adlandırma, modern düzen örüntüleriyle UI çerçeveleri genelinde netliği ve tutarlılığı artırır.
WinUI WrapPanel geliştirmeleri
  • Denetim WrapPanel artık önceki yatay ve dikey aralık özellikleri yerine ItemSpacing ve LineSpacing terminolojisini kullanıyor.
Özel XAML Önkoşulları ve IXamlPredicate Tümleştirmesi
  • XAML'nin IXamlPredicate koşullu ad alanı söz dizimi ile sorunsuz bir şekilde tümleşen ve XAML ayrıştırma zamanında değerlendirilen özel koşul tanımlamak için arabirimi uygulandı.
  • Özel koşul, uygulamaya özgü faktörlere göre koşullu XAML senaryolarını etkinleştirir:
    • Özellik bayrakları
    • Cihaz özellikleri
    • İş mantığı
    • Yapılandırma ayarları
    • Diğer çalışma zamanı koşulları
WinUI Open-Source Geliştirmeleri
  • Aşağıdaki değişiklikleri içeren dış kullanılabilirliği etkinleştirmek için paketler güncelleştirildi:
    • Microsoft.UI.DCPP.Dependencies.Minimal
    • Microsoft.UI.DCPP.Dependencies.Edge
    • ExpPointerPointStatics
  • Visual Studio 2026 için derleme desteği eklendi
  • WinUI oluşturmak ve test etmek için dış geliştiriciler tarafından kullanılmak üzere sunulan araçlar ve betikler.
WinUI API'lerini kullanımdan kaldırma ve yeniden adlandırma
  • [kullanım dışı] DependencyObject.Dispatcher
  • [kullanım dışı] Window.Current
  • [kullanım dışı] FocusManager.GetFocusedElement
  • [yeniden adlandırıldı] SystemBackdropHost'dan SystemBackdropElement'e
WinAI API Ad Alanı yeniden adlandırma
  • Yeniden adlandırıldı Microsoft.Windows.AI.Search.Experimental.AppContentIndex ile Microsoft.Windows.Search.AppContentIndex
Hata düzeltmeleri
  • Windows ML ile bağımsız dağıtım kullanılırken "Sınıf kaydedilmedi" hataları düzeltildi. Bağımsız dağıtım kullanan geliştiricilerin artık dahili olarak kullanılan tüm Foundation paketi eyleme dönüştürülebilir sınıflarını kaydetmesi gerekmez.
  • Windows ML kullanılırken olası bir kilitlenmeye neden olan işlem sonlandırma sırasındaki sorun giderildi.
  • Çağrıların ImageForegroundExtractor doğru uç noktaya ulaşması için API yönlendirme yolu düzeltildi.
  • Yürütme sağlayıcısı yükleme ve indirme ilerleme durumunun paket dağıtımı sırasında uygulamalara doğru şekilde iletildiğinden emin olun.
  • Hedef bağlantısı kesildiğinde oluşan bir kilitlenme, geçersiz bağlantı kesilme yollarına karşı koruma sağlanarak düzeltildi SystemBackdrop.
  • Windows yapay zeka API'lerinin bazı uygulamalarda kullanılabilir olmasını engelleyen bir sorun düzeltildi.
Yeni veya güncelleştirilmiş API'ler

Bu sürüm, 2.0.0-experimental3 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

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
Bilinen sorunlar
  • ONNX Çalışma Zamanı regresyonu, Video Süper Çözünürlüğünün Qualcomm cihazlarında başarısız olmasına neden olur. Qualcomm NPU yürütme sağlayıcısı için bekleyen bir güncelleştirme bu sorunu çözer.

Sürüm 2.0 Deneysel 3 (2.0.0-Experimental3)

Yayın tarihi: 17 Kasım 2025

Yeni SplitMenuFlyoutItem denetimi

Yeni deneysel SplitMenuFlyoutItem denetimi, menü açılır öğesinde bölünmüş düğme deneyimi sağlamak için tasarlanmıştır. Bu denetim, geliştiricilerin varsayılan birincil eylemi kullanıma sunmasını sağlarken, karmaşık işlevleri daha küçük bir ayak izine daraltmak ve genel menü uzunluğunu kaydetmek için ideal olan bir alt menü aracılığıyla ek seçenekler sunar.

MenuFlyoutItem ve MenuFlyoutSubItem yetenekleri ile birlikte, kontrol SubMenuPresenterStyle ve SubMenuItemStyle olmak üzere iki diğer özellikle gelir; bu, GridView gibi alt menü sunucusu için kullanılarak alt menüyü özelleştirmeye olanak tanı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>
WindowsML

Yeniden Adlandırılmış Türler

  • WinMLCatalogModel adı ModelCatalog olarak değiştirildi
  • CatalogModelSource adı ModelCatalogSource olarak değiştirildi

Yöntem Güncelleştirmeleri

  • CatalogModelInfo: GetInstance yeniden GetInstanceAsync olarak adlandırıldı
  • ModelCatalogSource: CreateFromUri yeniden CreateFromUriAsync olarak adlandırıldı
  • ModelCatalog: FindModel yeniden FindModelAsync olarak adlandırıldı
  • ModelCatalog: FindAllModels yeniden FindAllModelsAsync olarak adlandırıldı

Özellik Değişiklikleri

  • CatalogModelInfo.Size güncellendi ve CatalogModelInfo.ModelSizeInBytes olarak değiştirildi.

Davranış Güncelleştirmeleri

  • CatalogModelInstanceResult kullanarak .GetInstance() örneğini alın.
  • CatalogModelStatus şimdi yerel kullanılabilirlik temelinde Ready veya NotReady döndürür
  • Örnek durumunun model durumundan ayrılması için CatalogModelInstanceStatus eklendi

CatalogModelInfo Geliştirmeleri

  • Alias adı Name olarak değiştirildi
  • Revision adı Version olarak değiştirildi
  • Publisher eklendi
  • Kaldırıldı DisplayName

JSON Değişiklikleri

  • alias yeniden id olarak adlandırıldı.
  • modelType ve description kaldırıldı.
  • executionProvider yeniden executionProviders olarak adlandırıldı.
  • Virgülle ayrılmış liste yerine bir JSON nesneleri dizisi olacak şekilde güncelleştirildi executionProviders .

Ek Değişiklikler

  • ModelCatalog şimdi bir örnek oluşturulduğunda Yürütme Sağlayıcılarının (IP' ler) listesini döndürür.
  • Windows 10 (1809) ve üzeri için destek eklendi.
  • Hem normal dosyalar hem de MSIX paketleri dahil olmak üzere yerel dosyalar için destek eklendi.
  • Geçersiz katalog JSON'un neden olduğu kilitlenmeler düzeltildi.
AppContentIndexer
  • Önceden AppIndexQuery ve GetNextTextMatches yöntemlerini içeren GetNextImageMatches türü, AppIndexTextQuery ve AppIndexImageQuery olmak üzere iki ayrı türe ayrılmıştır. AppContentIndexer.CreateQuery yöntemi ile değiştirildi: CreateTextQuery ve CreateImageQuery.

  • Bu yöntemler artık sırasıyla AppIndexTextQuery ve AppIndexImageQuery döndürmektedir. Kullanımı basitleştirmek için seçenek türleri de güncelleştirilmiştir:

    • Kaldırıldı: AppIndexQueryOptions, TextMatchOptions ve ImageMatchOptions
    • Eklendi: TextQueryOptions ve ImageQueryOptions
  • Daha önce diziler döndüren AppContentIndex ad alanındaki API'ler, artık geliştirilmiş tutarlılık ve performans için IVectorView döndürmektedir.

  • AppContentIndexer.WaitForIndexingIdleAsync yöntemi, daha net ve daha esnek bir TimeSpan zaman aşımı işlemesi sağlayarak tamsayı yerine parametre kabul etmek üzere güncelleştirildi.

Video Süper Çözünürlük AI API'si

API, VideoScaler konuşma içeren yayınlar için iyileştirilmiş yapay zeka ölçeklendirmesi sayesinde gerçek zamanlı video iyileştirme sunar. Geliştiricilerin kötü ağ koşullarında bile konferans, akış ve düzenleme platformları arasında daha net, daha net görseller sağlamasına olanak tanır. API, BGR, RGB ve NV12 gibi birden çok video biçimi için uyumlulukla çıkış çözünürlüğü, kare hızı ve ilgi çekici bölgelerin özelleştirilmesini destekler.

Windows AI Metin Yeniden Yazma Tonu

Yeni RewriteCustomAsync API'si, seçilen metnin yeniden yazılmasında Phi Silica'ya yol gösteren bir giriş dizesi sağlamanıza olanak tanır. İçeriğinizi anında dönüştürmek için "Goofy" veya "Korsan" gibi yeni yaratıcı stillerle denemeler yapabilirsiniz.

Yapay zeka görüntüsü oluşturma

sınıfı, ImageGenerator güçlü görüntü oluşturma özellikleri sağlamak için Kararlı Difüzyon modellerinden yararlanıyor. Birden fazla üretim senaryosunu destekler.

  • Metinden Resme: Açıklayıcı metin istemlerinden görüntüler oluşturun.

  • Görüntüden Resme: Metin açıklamalarını temel alarak mevcut görüntüleri dönüştürün.

  • Sihirli Dolgu: Görüntülerin maskelenmiş bölgelerini yapay zeka tarafından oluşturulan içerikle doldurun.

  • Boyama Kitabı Stili: Renklendirme-kitap stili görüntüler oluşturun.

  • Restyle: Yapıyı korurken mevcut görüntülerin artistik stilini değiştirin.

Oluşturulan tüm görüntüler ImageBuffer nesneleri aracılığıyla RGB8 biçiminde döndürülür. API yerleşik içerik güvenliği filtreleri içerir ve özelleştirilebilir oluşturma parametrelerini destekler.

Temel Metinden Görüntüye Oluşturma
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");
    }
}
2.0-deneysel3 için yeni API'ler

Bu sürüm, 2.0-experimental2 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

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
Hata düzeltmeleri
  • Metin döndüğünde sınırlayıcı kutu hesaplaması düzeltildi. Bazı durumlarda, görüntülerde eşleşen OCR metni, metin döndürüldüğünde yanlış veya boş bölge sınırları bildirilir.

Sürüm 2.0 Deneysel 2 (2.0.0-Deneysel2)

Yayın tarihi: 6 Kasım 2025

Önemli

daha önce Windows Uygulama SDK'sı 2.0 Deneysel 1 yüklediyseniz, NuGet Uninstall kılavuzunu izleyerek projenizden Microsoft.WindowsAppSDK sürümüne sahip 2.0.250930001-experimental1 NuGet Meta Paketi'ni ve bu yeni sürümü denemeden önce ilgili WinAppSDK bileşen paketlerini kaldırın, çünkü daha önce yayımlanan Deneysel paketin sürüm numarası geçerli sürümden daha yüksektir.

Uygulama İçeriği Arama

AppContentIndexer API'leri, geliştiricilerin hızlı ve ilgili alma için metin ve görüntüler de dahil olmak üzere uygulama içeriğini verimli bir şekilde dizine almalarını sağlar. Hem sözcük temelli (anahtar sözcük tabanlı) hem de anlamsal (anlam tabanlı) aramaları destekleyen bu API'ler, uygulamaların yalnızca tam anahtar sözcükler yerine kullanıcı amacına ve bağlamına göre hızlı ve ilgili sonuçlar sunmasına olanak tanır.

Bu özellik aşağıdaki gelişmiş senaryoların kilidini açar:

  • Anlamsal Arama
    Uygulamalar, tam anahtar sözcük eşleşmeleri yerine amaç ve anlam temelinde sonuç döndürebilir.
    Örnek:"Proje zaman çizelgesi" sorgusu, tam olarak bu sözcükler kullanılmamış olsa bile "zamanlama" veya "teslim tarihlerinden" bahseden içeriği ortaya çıkarabilir.
  • Retrieval-Augmented Oluşturma (RAG)
    Dizine alınan içerik, üretken yapay zeka modelleri için bir bilgi bankası görevi görebilir. Kullanıcı bir soru sorduğunda, uygulama dizinden en ilgili belgeleri veya kod parçacıklarını alır ve modele besleyerek gerçek verilerle temel alınan doğru, bağlama duyarlı yanıtlar sağlar.
Windows ML Model Kataloğu

Windows ML Model Kataloğu API'leri, uygulamanızın veya kitaplığınızın büyük yapay zeka modeli dosyalarını kendi çevrimiçi model kataloglarınızdan dinamik olarak bulmasına ve indirmesine olanak tanıyarak bu büyük dosyaları doğrudan uygulamanız veya kitaplığınızla paketleme gereksinimini ortadan kaldırır. Model kataloğu, modelleri filtreleyerek ve yalnızca kullanımdaki belirli Windows cihaz için geçerli olanları indirerek cihaz uyumluluğunu sağlamaya yardımcı olur.

Kalıcı Dosya ve Klasör Konumları

En son Microsoft.Windows.Storage.Pickers güncelleştirmesi, geliştiricilerin ilk ve kalıcı klasör konumlarını ayarlamasına izin vererek ve daha kolay gezinmek için dosya türü filtrelerini net etiketlerle gruplandırarak dosya ve klasör seçimini kolaylaştırır.

Göreli Açılan Pencere Konumlandırma

PopupAnchor API artık ait olduğu pencereye veya adaya bağlanarak DesktopPopupSiteBridge göreli konumlandırmayı desteklemeye olanak tanır ve açılır pencerelerin yalnızca ekran koordinatları kullanılarak mutlak olarak konumlandırılabildiği sınırlamayı ele alır.

SystemVisual ContentIslands için Giriş Yönlendirme

InputUnderlyingWindowController API, geliştiricilerin başlangıçta SystemVisual'dan oluşturulan bir ContentIsland'a gönderilen giriş iletilerini almak için hedef HWND'yi belirlemesine olanak tanır (bkz. ContentIsland.CreateForSystemVisual).

Esnek Sistem Arka Planı Yerleşimi

SystemBackdropHost bir uygulamanın görsel ağacı içinde herhangi bir yere sistem arka planı (akrilik/mika) yerleştirmeyi sağlar.

XAML Düzeni Sıralı Konumlandırma

WrapPanel, alt öğeleri soldan sağa sıralı bir konumda yerleştiren bir WinUI XAML düzen panelidir; satır taşan öğeler, içeren panelin sonunda otomatik olarak bir sonraki satıra kırılır. Hızlı yanıt veren düzenler için kullanışlıdır.

Bu, mevcut Windows Community Toolkit denetiminin bir portudur.

2.0-deneysel2 için yeni API'ler

Bu sürüm, 2.0-experimental1 ile karşılaştırıldığında aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

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
Bilinen sorunlar
  • AppContentIndexer API'ler arka plan iş parçacığından çağrılmalıdır. Kullanıcı arabirimi iş parçacığında kullanılması, takılmalara veya kullanıcı deneyimini etkileyen uzun duraklamalara neden olabilir.
  • AppIndexQuery.GetNextTextMatches ve AppIndexQuery.GetNextImageMatches kullanarak yapılan sorgu sonuçları, eşleşme olmadığında, boş bir liste yerine null olarak döner.
  • Özellikle metin döndürüldüğünde veya çarpıtıldığında, OCR değerlerine göre kullanılan AppManagedImageQueryMatch.Subregion görüntü eşleşmeleri bazen yanlış olabilir.
  • kullanan AppManagedImageQueryMatch.Subregion görüntü eşleşmeleri bazen sıfır boyutlu veya son derece küçük dikdörtgenler içerebilir ve bu da yanlış sonuçlara yol açabilir.
  • AppContentIndex.CreateQuery'den boş bir sorgu istisna fırlatabilir.

Sürüm 2.0 Deneysel 1 (2.0.0-Deneysel1)

Yayın tarihi: 2 Ekim 2025

Windows AI API'leriyle cihaz içi yapay zekayı kullanın

Önemli

Bu API'ler için gereken temel ml modelleri, cihazınızın şu anda Geliştirme Kanalı'nda en son Windows 11 Insider Preview Derlemesini çalıştırmasını gerektirir. Ayrıca, bu API'ler cihazınızın bir Copilot+ PC olmasını gerektirir. Bu cihazlar hakkında daha fazla bilgi edinmek için bkz. Copilot+ Bilgisayar Geliştirici Kılavuzu. API'ler, gerekli desteği olmayan cihazlarda çağrıldığında bir özel durum oluşturur.

Windows Uygulama SDK'sı gelişmiş Windows yapay zeka özelliklerine sahiptir ve geliştiricilerin akıllı özellikleri uygulamalarıyla sorunsuz bir şekilde tümleştirmesini sağlar. Bu geliştirmeler, gelen istemlere yanıt verme, görüntülerdeki metinleri tanıma, görüntü içeriğini açıklama, resimlerden nesne ayıklama ve daha fazlası gibi yerel yapay zeka işlevlerini içerir.

Yapay zeka destekli özellikler oluşturulurken de uygulanabilen Windows yapay zeka API'lerinin oluşturulması sırasında kullanılan sorumlu geliştirme uygulamaları hakkında bilgi için Windows yönergelerinde Geliştirici Sorumlu Yapay Zeka Uygulamaları ve Özellikleri'ne başvurun.

Microsoft Windows ML

Windows ML Model Kataloğu API'leri, uygulamanızın veya kitaplığınızın büyük yapay zeka modeli dosyalarını doğrudan uygulama veya kitaplığınızla göndermeden kendi çevrimiçi model kataloglarınızdan dinamik olarak indirmesine olanak sağlar. Ayrıca model kataloğu, hangi modellerin üzerinde çalıştığı Windows cihazla uyumlu olduğunu filtrelemeye yardımcı olur, böylece doğru model cihaza indirilir.

Başlıca avantajlar:

  • Katalog ekleme: Bir veya daha fazla çevrimiçi katalog ekleme
  • Uyumlu modelleri bulma: Kullanıcının donanım ve yürütme sağlayıcılarıyla çalışan modelleri otomatik olarak bulma
  • Modelleri indirme: Çeşitli kaynaklardan modelleri indirme ve depolama
  • Modelleri uygulamalar arasında paylaşma: Birden çok uygulama aynı katalog kaynağını kullanıyorsa, modeller indirmeler çoğaltılmadan diskte paylaşılır
Hata düzeltmeleri
  • DeploymentManager'da, bazı durumlarda PackageInstallRequired gerekliliği hatalı şekilde raporlanmasına neden olan bir sorun giderildi.
Yeni API'ler

Bu sürüm aşağıdaki yeni ve değiştirilmiş deneysel API'leri içerir:

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