Windows Uygulama SDK'sı için en son kararlı kanal sürüm notları

Kararlı kanal, üretim ortamlarındaki uygulamalar tarafından kullanılmak üzere desteklenen Windows Uygulama SDK'sının sürümlerini sağlar. Windows Uygulama SDK'sının kararlı sürümünü kullanan uygulamalar da Microsoft Store'da yayımlanabilir.

Önemli bağlantılar:

• Mevcut bir uygulamayı Windows Uygulama SDK'sının eski bir sürümünden daha yeni bir sürüme yükseltmek istiyorsanız bkz. Var olan projeleri Windows Uygulama SDK'sının en son sürümüne güncelleştirme.

Kararlı kanal yayın notu arşivi:

• Windows Uygulama SDK'sı 1.5 için Kararlı kanal sürüm notları
• Windows Uygulama SDK'sı 1.4 için kararlı kanal sürüm notları
• Windows Uygulama SDK 1.3 için Stable Kanal sürüm notları
• Windows Uygulama SDK'sı 1.2 için kararlı kanal sürüm notları
• Windows Uygulama SDK'sı 1.1 için Kararlı kanal sürüm notları
• Windows Uygulama SDK'sı 1.0 için Kararlı kanal sürüm notları
• Windows Uygulama SDK'sı 0.8 için Kararlı kanal sürüm notları
• Windows Uygulama SDK 0.5 için kararlı kanal sürüm notları

Windows Uygulama SDK'sı için indirmeler

Sürüm 1.6.5 (1.6.250205002)

Bu, Windows Uygulama SDK'sının 1.6 sürümü için kritik hata düzeltmeleri içeren bir hizmet sürümüdür.

• Birkaç bellek sızıntısı sorunu düzeltildi.

Sürüm 1.6.4 (1.6.250108002)

Bu, Windows Uygulama SDK'sının 1.6 sürümü için kritik hata düzeltmeleri içeren bir hizmet sürümüdür.

• Çok satırlı TextBox'ta metin seçimi vurgulamayla ilgili bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #9965.
• DDLM paketinin bazen yüklenmediği ve paketlenmemiş uygulamaların başlatılmasını önleyen bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #3855.
• Bazı senaryolarda Detours'ta olası bir kilitlenme düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #4937.
• CommandBar pencerenin alt kısmındayken, CommandBar dışında bir menünün aşağı yerine yukarı açılmasına neden olabilecek başka bir olası sorun düzeltildi.
• Eski grafik donanımında çalışırken olası bir çökme sorunu düzeltildi.
• Bir pencere kapatıldığında işaretçi olay işlemesinde olası bir kilitlenme düzeltildi.
• CUIAWindow::InitIds bazen yeniden giriş tetiklemesinin neden olduğu olası kilitlenme düzeltildi.
• CompositionCapabilities.Changed olayı kullanılırken olası bir kilitlenme önlendi.
• Bazı Unicode karakterlerinin TextBox/RichEditBox içinde kareler olarak görüntülenmesiyle ilgili bir sorun düzeltildi.
• PackageDeploymentManager.EnsurePackage*Async()için options.RegisterNewerIfAvailable'nın işlenmesi düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #4864.

Sürüm 1.6.3 (1.6.241114003)

Bu, Windows Uygulama SDK'sının 1.6 sürümü için kritik hata düzeltmeleri içeren bir hizmet sürümüdür.

• AppWindow.ExtendsContentIntoTitleBar özelliğini okumanın özel başlık çubuğu işlemeyi açması sorunu düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #9988.
• Bir TextBox/RichEditBox'nin yok edilmesi sırasında ortaya çıkabilecek olası bir kilitlenme düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #9070.
• PackageDeploymentManager.IsPackageReadyOrNewerAvailable() başarısız olduğu bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #4817.
• ScrollViewer sızıntısına neden olan bir sorun düzeltildi.
• Uygulamanın işlemeyi durdurduğu ve bir daha kurtulamadığı nadir bir senaryo için algılama eklendi.
• PackageDeploymentManager.RegisterPackageSetAsync()'ın isteğe bağlı olarak PackageFamilyName ile kaydedilebilmesi gerektiği durumda URI gerektirdiği bir sorun düzeltildi.
• Uygulamaların yüklenmesini veya kaldırılmasını engelleyen bir sorun düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #4881.

Bu sürüm, Pencere Öğeleri sağlayıcılarının Pencere Öğelerine web içeriği eklemesine olanak tanıyan aşağıdaki yeni API'leri içerir:

Microsoft.Windows.Widgets.Providers 
  IWidgetManager2 
  IWidgetProviderMessage 
  IWidgetResourceProvider 
  WidgetManager 
     SendMessageToContent 

  WidgetMessageReceivedArgs 
  WidgetResourceRequest 
  WidgetResourceRequestedArgs 
  WidgetResourceResponse 

Sürüm 1.6.1 (1.6.240923002)

Bu, Windows Uygulama SDK'sının 1.6 sürümü için kritik hata düzeltmeleri içeren bir hizmet sürümüdür.

• FocusVisualKind.Reveal() kullanılırken meydana gelen kilitlenme düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #9966.
• Gürültülü C++ özel durumları Bcp47Langs.dll'dan düzeltildi. Daha fazla bilgi için bkz. GitHub sorunu #4691. Bu düzeltmenin Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverrideile eşitlemeyi kaldırdığını unutmayın.
• Unloadedgösterildikten hemen sonra ek bir ContentDialog olayının tetiklendiği bir sorun düzeltildi. Daha fazla bilgi için bkz. #8402GitHub sorunu.
• CommandBar menüsünün, aşağı doğru açılmak için yeterli alan olsa bile yukarı doğru yanlışlıkla açılmasına neden olan bir sorun düzeltildi.
• Sağdan sola modda çalışan üst düzey pencerelerde, InputNonClientPointerSource bölgelerine girişin doğru işlenmediği bazı sorunlar düzeltildi.
• Windows SDK çerçeve sürümünün derleme zamanı denetimi, .NET 9 için kullanılan biraz farklı çerçeve adını işlemek üzere düzeltildi.

Sürüm 1.6

Aşağıdaki bölümlerde, sürüm 1.6 için yeni ve güncelleştirilmiş özellikler ve bilinen sorunlar açıklanmaktadır.

Mevcut bir Windows Uygulama SDK'sı 1.5 uygulamasında Nuget paketinizi 1.6.240829007 sürümüne güncelleştirebilirsiniz (NuGet Paket Yöneticisi'ni kullanarak Visual Studio'da paketleri yükleme ve yönetme) Paketi güncelleştirme bölümüne bakın).

Güncellenmiş çalışma zamanı ve MSIX hakkında bilgi için, Windows Uygulama SDK'sına ilişkin İndirme Dosyalarınagöz atabilirsiniz.

1.6 için gerekli proje değişiklikleri

C++ proje değişiklikleri

C++ projesini 1.6'ya güncelleştirirken, Microsoft.Web.WebView2 paketine bir proje başvurusu eklemeniz gerekir. Visual Studio'da NuGet Paket Yöneticisi aracılığıyla güncelleştirme yaparsanız, bu bağımlılık sizin için eklenir.

C# proje değişiklikleri

1.6 sürümü itibarıyla Windows App SDK ile yönetilen uygulamalar, dosyanızdaki *.*.*.38 aracılığıyla belirtilebilen Microsoft.Windows.SDK.NET.Refcsproj veya sonraki bir sürümü gerektirir. Mesela:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.22621.38</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

Ayrıca, Windows Uygulama SDK'sı ile yönetilen uygulamalar Microsoft.Windows.CsWinRT2.1.1 (veya üzeri) sürümüne güncellenmelidir.

Yerel AOT desteği

.NET PublishAot proje özelliği artık yerel İleri-Of-Time derlemesi için desteklenmektedir. Yerel AOT hakkında ayrıntılı bilgi için bkz. Yerel AOT Dağıtımı. AOT, Kırpma desteği üzerine kurulduğundan, aşağıdaki kırpmayla ilgili rehberin çoğu AOT için de geçerlidir.

PublishAot destek ve kırpma desteği için, önceki bölümde açıklanan C# proje değişikliklerine ek olarak, bir sonraki .NET SDK hizmet güncelleştirmesi yayınlanana kadar bu paketten kaynak oluşturucuyu etkinleştirmek amacıyla Microsoft.Windows.CsWinRT2.1.1 (veya üzeri) paketine de bir başvuruda bulunmanız gerekecektir.

Daha fazla bilgi için CsWinRT Trimming / AOT destek belgesi ve CsWinRT 2.1.1 Sürüm Notlarıbölümüne bakın.

NuGet geri yükleme sırasında PublishAot'ı etkinleştirmenizi öneririz. Windows Uygulama SDK'sı, F5 ile dağıtım yapılırken yayımlama hedeflerini çağırdığından, bunu csproj dosyanıza ekleyin:

<PublishAot>true</PublishAot>

AOT Sorunlarını Çözme

Bu sürümde geliştirici, kırpmayı önlemek için (yansıma tabanlı {Binding} hedefleri gibi) tüm türlerin düzgün şekilde köklendiğinden emin olmaktan sorumludur. Daha sonraki sürümler, mümkün olduğunda kök oluşturma işlemini otomatikleştirmek için hem C#/WinRT'yi hem de XAML Derleyicisini geliştirecek, geliştiricileri riskleri azaltma konusunda uyaracak ve çözüm mekanizmaları sağlayacaktır.

Kısmi Sınıflar

C#/WinRT ayrıca sürüm 2.1.1'de PublishAot desteği içerir. C#/WinRT ile AOT yayımlama için bir sınıfı etkinleştirmek için önce partialolarak işaretlenmelidir. Bu, C#/WinRT AOT kaynak çözümleyicisinin statik analiz için sınıfları özniteliklemesini sağlar. Yalnızca sınıflar (yöntemleri, kırpma hedeflerini içeren) bu özniteliği gerektirir.

Güvenli Olmayan Kod Hatası

CsWinRT kaynak oluşturucu, unsafekullanan bir kod oluşturabilir. Derleme sırasında böyle bir hatayla veya buna dair bir tanılama uyarısıyla (CS0227 "Güvenli olmayan kod yalnızca /unsafe ile derleniyorsa görünebilir") karşılaşırsanız, EnableUnsafeBlocks ayarını true olarak ayarlamanız gerekir. Daha fazla bilgi için bkz. CsWinRT #1721GitHub sorunu.

WebView2 henüz AOT uyumlu değil

Microsoft.Web.WebView2 paketi sürüm 1.0.2651.64'teki WebView2 projeksiyonları henüz AOT ile uyumlu değildir. Bu, projenizde başvurabileceğiniz Microsoft.Web.WebView2 paketinin gelecek bir sürümünde düzeltilecektir.

Reflection-Free Teknikleri

AOT uyumluluğunu etkinleştirmek için yansıma tabanlı teknikler statik olarak yazılan serileştirme, AppContext.BaseDirectory, typeof() vb. ile değiştirilmelidir. Ayrıntılar için bkz. kırpma uyarılarına giriş.

Kök Oluşturma Türleri

{Binding} için tam destek uygulanana kadar, türler aşağıdaki gibi kırpılmadan korunabilir:

Belirli proje P'daki, yalnızca dinamik olarak başvurulan (bu nedenle normalde kırpılan) ve Aad alanında bulunan tür T ile derleme N'i kullanan T'ün korunması şu şekilde sağlanabilir:

P.csproj:

<ItemGroup>
    <TrimmerRootDescriptor Include="ILLink.Descriptors.xml" />
</ItemGroup>

ILLink.Descriptors.xml:

<?xml version="1.0" encoding="utf-8"?>
<linker>
    <assembly fullname="A">
        <type fullname="N.T" preserve="all" />
    </assembly>
</linker>

Tam kök tanımlayıcı XML ifadesi söz dizimi için bkz. Kök Tanımlayıcılar.

Ayrılmış WebView2 sürümleme

Windows Uygulama SDK'sı artık Edge WebView2 SDK'sının sabit kodlanmış bir sürümünü eklemek yerine Bir NuGet başvurusu olarak Edge WebView2 SDK'sını tüketiyor. Yeni model, uygulamaların Windows Uygulama SDK'sının oluşturulduğu sürümle sınırlı kalmak yerine Microsoft.Web.WebView2 paketinin daha yeni bir sürümünü seçmesine olanak tanır. Yeni model, uygulamaların Edge WebView2 SDK'sına da başvuran NuGet paketlerine başvurmasına da olanak tanır. Daha fazla bilgi için bkz. GitHub sorunu #5689.

Yeni Paket Dağıtım API'leri

Paket Yönetimi API'si Is*ReadyOrNewerAvailable*(), EnsureReadyOptions.RegisterNewerIfAvailable, Is*Provisioned*(), IsPackageRegistrationPending() gibi çeşitli geliştirmeler ve çeşitli hata düzeltmeleri aldı. Daha fazla bilgi için bkz. PackageManagement.md ve Pull Request #4453.

Geliştirilmiş TabView sekmesi ayrılması

'da Geliştirilmiş TabView Yırtılma Özelliği

TabView, sekmeleri sürüklemek ve yeni bir pencereye sürüklemek için gelişmiş bir deneyim sağlayan yeni bir CanTearOutTabs modunu destekler. Bu yeni seçenek etkinleştirildiğinde, sekme sürükleme, sürükleme sırasında hemen yeni bir pencerenin oluşturulduğu Edge ve Chrome'daki sekme sürükleme deneyimine çok benzer ve kullanıcının pencereyi tek bir düz hareketle ekranı kaplamak veya tutturmak için ekranın kenarına sürüklemesine olanak tanır. Bu uygulama sürükle ve bırak API'lerini de kullanmaz, bu nedenle bu API'lerdeki sınırlamalardan etkilenmez. Özellikle, yönetici olarak çalıştırılan işlemlerde sekme koparma desteklenir.

Diğer önemli değişiklikler

• UWP'den bu boşluğu dolduran yeni bir ColorHelper.ToDisplayName() API'si eklendi.
• Özellikle yeni bir Microsoft.Windows.Globalization.ApplicationLanguages özelliği içeren yeni bir PrimaryLanguageOverride sınıfı eklendi. Daha fazla bilgi için bkz. GitHub sorunu #4523.
• Mühürsüz ItemsWrapGrid. Bu, geriye dönük uyumlu bir değişiklik olmalıdır.
• PipsPager, ilk ve son öğeler arasında döngüsel geçiş yapabileceği yeni bir modu destekliyor.

1.6'daki yeni PipsPager sarmalama modu

• RatingControl, bazı sabit kodlanmış stil özelliklerini tema kaynaklarına taşıyarak artık daha özelleştirilebilir. Bu, uygulamaların RatingControl görünümünü daha iyi özelleştirmek için bu değerleri geçersiz kılmasına olanak tanır.

Microsoft.UI

    ColorHelper
        ToDisplayName

Microsoft.UI.Input

    EnteredMoveSizeEventArgs
    EnteringMoveSizeEventArgs
    ExitedMoveSizeEventArgs
    InputNonClientPointerSource
        EnteredMoveSize
        EnteringMoveSize
        ExitedMoveSize
        WindowRectChanged
        WindowRectChanging

    MoveSizeOperation
    WindowRectChangedEventArgs
    WindowRectChangingEventArgs

Microsoft.UI.Xaml

    XamlRoot
        CoordinateConverter

Microsoft.UI.Xaml.Automation.Peers

    ScrollPresenterAutomationPeer

Microsoft.UI.Xaml.Controls

    PipsPager
        WrapMode
        WrapModeProperty

    PipsPagerWrapMode
    TabView
        CanTearOutTabs
        CanTearOutTabsProperty
        ExternalTornOutTabsDropped
        ExternalTornOutTabsDropping
        TabTearOutRequested
        TabTearOutWindowRequested

    TabViewExternalTornOutTabsDroppedEventArgs
    TabViewExternalTornOutTabsDroppingEventArgs
    TabViewTabTearOutRequestedEventArgs
    TabViewTabTearOutWindowRequestedEventArgs

Microsoft.Windows.Globalization

    ApplicationLanguages

Microsoft.Windows.Management.Deployment

    EnsureReadyOptions
        RegisterNewerIfAvailable

    PackageDeploymentFeature
    PackageDeploymentManager
        IsPackageDeploymentFeatureSupported
        IsPackageProvisioned
        IsPackageProvisionedByUri
        IsPackageReadyOrNewerAvailable
        IsPackageReadyOrNewerAvailableByUri
        IsPackageSetProvisioned
        IsPackageSetReadyOrNewerAvailable

    PackageReadyOrNewerAvailableStatus

Microsoft.Windows.Storage

    ApplicationData
    ApplicationDataContainer
    ApplicationDataContract
    ApplicationDataCreateDisposition
    ApplicationDataLocality