Catatan rilis saluran eksperimental untuk SDK Aplikasi Windows

  • Artikel

Penting

Saluran eksperimental tidak didukung untuk digunakan di lingkungan produksi, dan aplikasi yang menggunakan rilis eksperimental tidak dapat diterbitkan ke Microsoft Store.

Saluran eksperimental menyediakan rilis SDK Aplikasi Windows yang mencakup fitur saluran eksperimental yang berada dalam tahap awal pengembangan. API untuk fitur eksperimental memiliki atribut Eksperimental . Jika Anda memanggil API eksperimental dalam kode, Anda akan menerima peringatan build-time. Semua API di saluran eksperimental mungkin memiliki perubahan yang melanggar dalam rilis mendatang, tetapi API eksperimental terutama dapat berubah. Fitur eksperimental dapat dihapus dari rilis berikutnya, atau mungkin tidak pernah dirilis.

Tautan penting:

Rilis saluran eksperimental:

Eksperimental Versi 1.5 (1.5.0-eksperimental2)

Ini adalah rilis terbaru dari saluran eksperimental. Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.5.240124002-experimental2.

Perbaikan bug

Rilis ini mencakup perbaikan bug berikut:

  • Memperbaiki masalah yang menyebabkan aplikasi mengalami crash saat startup saat menggunakan kustom NavigationViewItem. Untuk informasi selengkapnya, lihat Masalah GitHub #8814.
  • Memperbaiki NavigationView masalah di mana tombol elipsis akan salah menghasilkan kesalahan. Untuk informasi selengkapnya, lihat Masalah GitHub #8380.
  • Memperbaiki masalah di mana SystemBackdrop tidak akan dirender dengan benar di aplikasi multi-jendela. Untuk informasi selengkapnya, lihat Masalah GitHub #8423.
  • Memperbaiki masalah duplikasi saat menyisipkan ke awal ObservableCollection. Untuk informasi selengkapnya, lihat Masalah GitHub #8370.

API baru

1.5-experimental2 mencakup API baru berikut. API ini tidak bersifat eksperimental, tetapi belum disertakan dalam versi rilis yang stabil dari WinAppSDK.

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Automation.Peers
 
    SelectorBarItemAutomationPeer

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.Windows.Management.Deployment
 
    EnsureReadyOptions
    PackageDeploymentManager
        AddPackageSetAsync
        DeprovisionPackageAsync
        DeprovisionPackageByUriAsync
        DeprovisionPackageSetAsync
        EnsurePackageReadyAsync
        EnsurePackageReadyByUriAsync
        EnsurePackageSetReadyAsync
        IsPackageReady
        IsPackageReadyByUri
        IsPackageRegistrationPending
        IsPackageRegistrationPendingForUser
        ProvisionPackageAsync
        ProvisionPackageByUriAsync
        ProvisionPackageSetAsync
        RegisterPackageAsync
        RegisterPackageByUriAsync
        RegisterPackageSetAsync
        RemovePackageByUriAsync
        RepairPackageAsync
        RepairPackageByUriAsync
        RepairPackageSetAsync
        ResetPackageAsync
        ResetPackageByUriAsync
        ResetPackageSetAsync
        StagePackageAsync
        StagePackageByUriAsync
        StagePackageSetAsync
 
    PackageDeploymentProgress
    PackageDeploymentResult
        Error
        ErrorText
 
    PackageSet
        Items
        PackageUri
 
    PackageVolume
        FindPackageVolumeByName
        FindPackageVolumeByPath
        FindPackageVolumes
        IsRepairNeeded
        Repair
 
    ProvisionPackageOptions
    RegisterPackageOptions
        DependencyPackageFamilyNames
 
    RemovePackageOptions
        FailIfNotFound

API Eksperimental Tambahan

Rilis ini mencakup API eksperimental baru dan yang dimodifikasi berikut:

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode
 
    DispatcherShutdownMode
    XamlIsland
        SystemBackdrop

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        IsXamlRunningOnCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Windows.System.Workloads
 
    IWorkloadHandler
    Workload
    WorkloadManager
    WorkloadProgress
    WorkloadProgressStatus
    WorkloadResult
    WorkloadsContract
    WorkloadStatus

Eksperimental Versi 1.5 (1.5.0-eksperimental1)

Ini adalah rilis terbaru dari saluran eksperimental. Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.5.231202003-experimental1.

API baru

1.5-experimental1 mencakup API baru berikut. API ini tidak bersifat eksperimental, tetapi belum disertakan dalam versi rilis yang stabil dari WinAppSDK.

Microsoft.Windows.Widgets.Feeds.Providers
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider

API Eksperimental Tambahan

Rilis ini mencakup API eksperimental baru dan yang dimodifikasi berikut:

Microsoft.UI.Content
 
    ContentIsland
        ConnectionInfo
        ConnectRemoteEndpoint
        IsRemoteEndpointConnected
 
    ContentIslandEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        ThemeChanged
 
    ContentSiteEnvironment
        CurrentOrientation
        DisplayScale
        NativeOrientation
        NotifyThemeChanged
 
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged
 
    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentSiteBridgeEndpointConnectionPrivate
    ProcessStarter
    SystemVisualSiteBridge
        IsClosed

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    DebugSettings
        LayoutCycleDebugBreaks
        LayoutCycleTracing
 
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel
    XamlIsland

Microsoft.UI.Xaml.Controls
 
    SelectionModel
        SelectAllFlat

Microsoft.UI.Xaml.Core.Direct
 
    XamlPropertyIndex
        FlyoutBase_SystemBackdrop
        Popup_SystemBackdrop

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    AddPackageSetOptions
    DeploymentPriority
    DeploymentProcessingModel
    EnsureIsReadyOptions
    FindPackageSetOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetManager
    PackageSetRuntimeDisposition
    PackageVolume
    PackageVolumeManager
    PackageVolumeStatus
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

Eksperimental Versi 1.4 (1.4.0-eksperimental1)

Ini adalah rilis terbaru dari saluran eksperimental. Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.4.230518007-experimental1.

Perbaikan bug

Rilis ini berisi perbaikan lain-lain, termasuk yang berikut ini:

  • Memperbaiki masalah saat mengaktifkan penghitung framerate pengaturan debug di aplikasi desktop WinUI baru menyebabkan pelanggaran akses. Untuk informasi selengkapnya, lihat masalah 2835 di GitHub.
  • Memperbaiki masalah di mana pengguliran horizontal pada touchpad tidak berfungsi di halaman web WebView2. Untuk informasi selengkapnya, lihat masalah 7772 di GitHub.

API Eksperimental Tambahan

Rilis ini mencakup API eksperimental baru dan yang dimodifikasi berikut:

Microsoft.UI

   IClosableNotifier

Microsoft.UI.Composition.SystemBackdrops

   DesktopAcrylicController
       Closed
       FrameworkClosed
       Kind

   DesktopAcrylicKind
   MicaController
       Closed
       FrameworkClosed

Microsoft.UI.Content

   ContentAppWindowBridge
       SettingChanged

   ContentEnvironmentSettingChangedEventArgs
   ContentExternalBackdropLink
   ContentExternalOutputLink
       ExternalOutputBorderMode

   ContentIsland
       FrameworkClosed

   ContentIslandWindow
       SettingChanged

   ContentSite
       FrameworkClosed

   ContentSiteWindow
       NotifySettingChanged
       SettingChanged

   CoreWindowTopLevelWindowBridge
       SettingChanged

   DesktopSiteBridge
       Closed
       FrameworkClosed

   IContentWindow
       SettingChanged

   SystemVisualSiteBridge
       Closed
       FrameworkClosed

Microsoft.UI.Input

   InputLayoutPolicy
   InputNonClientPointerSource
       ConfigurationChanged
       GetForWindowId

   NonClientRegionConfigurationChangedEventArgs

Microsoft.UI.System

   ThemeSettings

Microsoft.UI.Windowing

   DisplayArea
       GetMetricsFromWindowId

Microsoft.UI.Xaml

   XamlRoot
       ContentWindow

Microsoft.UI.Xaml.Controls

   ItemContainer
       Child
       ChildProperty

   ItemContainerMultiSelectMode
       Extended

   ItemsView
       Animator
       AnimatorProperty

   MenuFlyoutPresenter
       SystemBackdrop
       SystemBackdropProperty

   RiverFlowLayout
       InvalidateItemsInfo
       RequestedRangeCount
       RequestedRangeStartIndex

   RiverFlowLayoutElementAnimator

Microsoft.UI.Xaml.Controls.Primitives

   CommandBarFlyoutCommandBar
       SystemBackdrop
       SystemBackdropProperty

Microsoft.UI.Xaml.Input

   AccessKeyManager
       EnterDisplayMode

Eksperimental Versi 1.3 (1.3.0-eksperimental1)

Ini adalah rilis terbaru dari saluran eksperimental. Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.3.230202101-experimental1.

API Backdrop XAML

Dengan properti bawaan XAML Window, latar belakang Mica & Background Acrylic sekarang lebih mudah digunakan di aplikasi WinUI 3 Anda. Lihat spesifikasi Xaml Backdrop API di GitHub untuk informasi selengkapnya tentang properti Window.SystemBackdrop.

Dari catatan dalam rilis ini, Anda dapat mengatur backdrop hanya di code-behind, seperti di bawah ini. Pengaturan <Window.SystemBackdrop> dalam markup menghasilkan kesalahan kompilasi. Selain itu, API Xaml Backdrop saat ini kehilangan tag 'eksperimental' karena sedang dalam pengembangan aktif.

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Mengganti beberapa baris kode boilerplate, Anda sekarang dapat menggunakan API AppWindow langsung dari Jendela melalui Window.AppWindow. Lihat spesifikasi Window.AppWindow API di GitHub untuk informasi latar belakang dan penggunaan tambahan.

Fitur baru dari seluruh WinAppSDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId yang menggantikan MddGetGenerationId yang tidak digunakan lagi.
  • Pengelola Lingkungan: EnvironmentManager.AreChangesTracked untuk memberi tahu Anda apakah perubahan pada pengelola lingkungan dapat dilacak di aplikasi Anda. Lihat spesifikasi ENVIRONMENT Manager API di GitHub untuk informasi selengkapnya.
  • MRT Core: Peristiwa baru, Application.ResourceManagerInitializing memungkinkan aplikasi Anda untuk menyediakan implementasi IResourceManager antarmukanya sendiri, dan memberi Anda akses ke ResourceManager yang digunakan WinUI untuk menyelesaikan URI sumber daya.
  • Dengan VSIX eksperimental terbaru, Anda sekarang dapat mengonversi aplikasi antara unpackaged dan dikemas melalui menu Visual Studio alih-alih di file proyek Anda.
  • Peristiwa baru, DebugSettings.XamlResourceReferenceFailed sekarang dimunculkan ketika pencarian Statis/ThemeResource yang direferensikan tidak dapat diselesaikan. Kejadian ini memberikan akses ke jejak yang merinci tempat kerangka kerja mencari kunci tersebut untuk memungkinkan Anda men-debug kegagalan pencarian Statis & ThemeResource dengan lebih baik. Untuk informasi selengkapnya, lihat masalah 4972, 2350, dan 6073 di GitHub.

Perbaikan bug

  • Memperbaiki masalah dengan input sentuhan yang menyebabkan keyboard lunak tidak muncul pada kotak teks. Untuk informasi selengkapnya, lihat masalah 6291 di GitHub.
  • Memperbaiki masalah yang menyebabkan ItemsRepeater dengan IElementFactory sebagai ItemTemplate-nya melempar ArgumentException. Untuk informasi selengkapnya, lihat masalah 4705 di GitHub.

API Eksperimental Tambahan

Rilis ini juga mencakup beberapa API yang sedang dalam pengembangan awal.

Daftar di bawah ini merinci API yang diperkenalkan dalam rilis eksperimental ini yang tidak kami rencanakan untuk dikirim dalam rilis stabil 1.3.0.

**Microsoft.UI.Content**

    DesktopSiteBridge
        GetInputEnabledToRoot
        GetVisibleToRoot
        InputEnabled

**Microsoft.UI.Dispatching**

    DispatcherQueue
        FrameworkShutdownStarting

**Microsoft.UI.Input**

    InputLightDismissAction
        GetForIsland

    InputNonClientPointerSource
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior

    NonClientRegionCaptionTappedEventArgs
    NonClientRegionHoverEventArgs
    NonClientRegionKind

**Microsoft.UI.Input.DragDrop**

    DragDropManager
    DragDropModifiers
    DragInfo
    DragOperation
    DragUIContentMode
    DragUIOverride
    DropOperationTargetRequestedEventArgs
    IDropOperationTarget

**Microsoft.UI.Xaml.Automation.Peers**

    ItemContainerAutomationPeer
    ItemsViewAutomationPeer

**Microsoft.UI.Xaml.Controls**

    AnnotatedScrollBar
    AnnotatedScrollBarLabel
    AnnotatedScrollBarScrollEventArgs
    AnnotatedScrollBarScrollEventType
    AnnotatedScrollBarScrollOffsetRequestedEventArgs
    AnnotatedScrollBarSubLabelRequestedEventArgs
    AnnotatedScrollBarValueRequestedEventArgs
    ElementFactory
        GetElement
        GetElementCore
        RecycleElement
        RecycleElementCore

    IndexBasedLayoutOrientation
    ItemContainer
    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    ItemsView
    ItemsViewItemInvokedEventArgs
    ItemsViewItemInvokeMode
    ItemsViewSelectionMode
    Layout
        IndexBasedLayoutOrientation

    NonVirtualizingLayout
        IndexBasedLayoutOrientationCore

    RiverFlowLayout
    RiverFlowLayoutItemsInfoRequestedEventArgs
    RiverFlowLayoutItemsJustification
    RiverFlowLayoutItemsStretch
    VirtualizingLayout
        IndexBasedLayoutOrientationCore

    VirtualizingLayoutContext
        VisibleRect
        VisibleRectCore

**Microsoft.Graphics.Display**

    DisplayInformation
        AngularOffsetFromNativeOrientation
        DpiChanged
        OrientationChanged
        RawDpi
        RawPixelsPerViewPixel

    DisplayOrientation

**Microsoft.UI.Xaml.Hosting**

    DesktopWindowXamlSource
        CreateSiteBridge
        SiteBridge
        SystemBackdrop

Eksperimental Versi 1.2 (1.2.0-eksperimental2)

Ini adalah rilis terbaru dari saluran eksperimental. Ini mendukung semua fitur dan fitur saluran eksperimental dari 1.2.0-preview 1.

Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.2.220909.2-experimental2.

Memperbaiki masalah

Dalam build Windows Insider Preview mendatang, aplikasi yang menggunakan SDK Aplikasi Windows akan gagal diluncurkan.

Eksperimental Versi 1.2 (1.2.0-eksperimental1)

Ini adalah rilis terbaru dari saluran eksperimental. Ini mendukung semua fitur saluran eksperimental.

Untuk mengunduh, targetkan ulang versi WinAppSDK NuGet Anda ke 1.2.220727.1-experimental1.

Input & Komposisi

Pertama kali diperkenalkan di SDK Aplikasi Windows 0.8, ada beberapa kelas eksperimental di namespace Microsoft.UI.Input.Experimental & Microsoft.UI.Composition.Experimental.

Baru dalam rilis ini:

Konten

Baru dalam rilis ini, kelas eksperimental di namespace Microsoft.UI.Content menyediakan blok penyusun konten interaktif. Ini adalah primitif tingkat rendah yang dapat dirakit ke dalam konten untuk memberikan pengalaman interaktif bagi pengguna akhir. Konten menentukan struktur untuk: merender output dengan animasi, memproses input pada target yang berbeda, memberikan representasi aksesibilitas, dan menangani perubahan status host.

API penting:

  • ContentIsland - menggabungkan Output, Input, dan Aksesibilitas dan menyediakan abstraksi untuk konten interaktif. Pohon visual kustom dapat dibangun dan dibuat interaktif dengan API ini.
  • DesktopChildSiteBridge - memungkinkan ContentIsland untuk dihubungkan ke dalam hierarki berbasis HWND.

Lihat sampel di GitHub untuk informasi selengkapnya.

Pengiriman

DispatcherQueue sekarang dikirim sebagai reentrant. Sebelumnya, tidak lebih dari satu panggilan balik DispatcherQueueHandler dapat aktif pada satu utas pada satu waktu. Sekarang, jika handler memulai pompa pesan berlapis, panggilan balik tambahan dikirim sebagai reentrant. Ini cocok dengan perilaku Win32 di sekitar pesan jendela dan pompa pesan berlapis.

Notifications

Mendaftarkan nama tampilan aplikasi dan ikon untuk pemberitahuan aplikasi sekarang didukung. Lihat spesifikasi di GitHub untuk informasi tambahan.

WinUI 3

  • Kontrol dan gaya sudah diperbarui dengan rilis WinUI 2.8 .
  • UWP tidak lagi didukung dalam rilis eksperimental.

Batasan lain dan masalah yang diketahui

  • Aplikasi perlu dibangun kembali setelah memperbarui ke SDK Aplikasi Windows 1.2-eksperimental1 karena perubahan menerobos yang diperkenalkan di ABI.
  • Aplikasi yang mereferensikan paket yang bergantung pada WebView2 (seperti Microsoft.Identity.Client) gagal dibuat. Ini disebabkan oleh biner yang bertentangan pada waktu build. Lihat masalah 2492 di GitHub untuk informasi selengkapnya.
  • Menggunakan dotnet build dengan proyek pustaka kelas WinAppSDK C# mungkin melihat kesalahan build "Tugas Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent tidak dapat dimuat". Untuk mengatasi masalah ini, atur <EnableMsixTooling>true</EnableMsixTooling> dalam file proyek Anda.
  • Templat WinAppSDK default mencatat bahwa MaxVersionTested="10.0.19041.0" ketika seharusnya "10.0.22000.0". Untuk dukungan penuh dari beberapa fitur, terutama UnlockedDEHs, perbarui MaxVersionTested ke "10.0.22000.0" dalam file proyek Anda.

Eksperimental Versi 1.0 (1.0.0-eksperimental1)

Rilis ini mendukung semua fitur saluran eksperimental.

Mengunduh

Bagian berikut ini menjelaskan fitur baru dan yang diperbarui, batasan, dan masalah yang diketahui untuk rilis ini.

WinUI 3

Rilis WinUI 3 ini difokuskan untuk membangun fitur baru untuk 1.0 stabil dan memperbaiki bug.

  • Fitur baru: Dukungan untuk menampilkan ContentDialog per jendela daripada per utas.
  • Bug: Untuk daftar lengkap bug yang dibahas dalam rilis ini, lihat repositori GitHub kami.
  • Sampel: Untuk melihat kontrol dan fitur WinUI 3 beraksi, Anda dapat mengkloning dan membuat aplikasi Galeri WinUI 3 dari GitHub, atau mengunduh aplikasi dari Microsoft Store.

Untuk informasi selengkapnya atau untuk mulai mengembangkan dengan WinUI, lihat:

Pemberitahuan push (fitur eksperimental)

Rilis ini memperkenalkan API pemberitahuan push yang dapat digunakan oleh aplikasi desktop paket dengan identitas berbasis pendaftaran aplikasi Azure. Untuk menggunakan fitur ini, Anda harus mendaftar untuk pratinjau privat kami.

Batasan penting:

  • Pemberitahuan push hanya didukung di aplikasi paket MSIX yang berjalan pada Windows 10 versi 2004 (build 19041) atau rilis yang lebih baru.
  • Microsoft berhak menonaktifkan atau mencabut aplikasi dari pemberitahuan push selama pratinjau privat.
  • Microsoft tidak menjamin keandalan atau latensi pemberitahuan push.
  • Selama pratinjau privat, volume pemberitahuan push dibatasi hingga 1 juta per bulan.

Untuk informasi selengkapnya, lihat Pemberitahuan push.

Windowing

Rilis ini mencakup pembaruan pada API jendela. Ini adalah sekumpulan API windowing tingkat tinggi, yang berpusat di sekitar kelas AppWindow, yang memungkinkan skenario windowing yang mudah digunakan yang terintegrasi dengan baik dengan pengalaman pengguna Windows dan aplikasi lainnya. Ini mirip dengan, tetapi tidak sama dengan, UWP AppWindow.

Batasan penting:

  • Rilis ini AppWindow saat ini hanya tersedia untuk aplikasi Win32 (baik yang dikemas maupun tidak dikemas).
  • SDK Aplikasi Windows saat ini tidak menyediakan metode untuk melampirkan konten kerangka kerja UI ke AppWindow; Anda dibatasi untuk menggunakan HWND metode akses interop.
  • WINDOWING API saat ini tidak akan berfungsi pada Windows versi 1809 dan 1903 untuk AMD64.

Untuk informasi selengkapnya, lihat Mengelola jendela aplikasi.

Penyebaran untuk aplikasi yang tidak dikemas

Rilis ini memperkenalkan pembaruan pada fitur dependensi dinamis, termasuk API bootstrapper.

Batasan penting:

  • Fitur dependensi dinamis hanya didukung untuk aplikasi yang tidak dikemas.
  • Penelepon yang ditingkatkan tidak didukung.

Untuk informasi lebih lanjut, baca artikel berikut:

Batasan lain dan masalah yang diketahui

  • Tidak ada dukungan untuk konfigurasi build CPU apa pun: SDK Aplikasi Windows ditulis dalam kode asli dan dengan demikian tidak mendukung konfigurasi build CPU apa pun. Templat WinUI 3 di Visual Studio hanya mengizinkan build khusus arsitektur. Saat menambahkan SDK Aplikasi Windows ke aplikasi atau komponen .NET yang ada yang mendukung CPU Apa pun, Anda harus menentukan arsitektur yang diinginkan: x86, atau x64arm64.
  • Aplikasi .NET harus menargetkan build 18362 atau yang lebih baru: TFM Anda harus diatur ke net6.0-windows10.0.18362 atau yang lebih baru, dan proyek <TargetPlatformVersion> kemasan Anda harus diatur ke 18362 atau yang lebih baru. Untuk informasi selengkapnya, lihat masalah yang diketahui di GitHub.
  • Aplikasi C# yang menggunakan 1.0 Eksperimental harus menggunakan salah satu .NET SDK berikut:

Pratinjau Versi 0.8 (pratinjau 0.8.0)

Rilis ini mendukung semua fitur saluran eksperimental.

Mengunduh

Bagian berikut ini menjelaskan fitur baru dan yang diperbarui, batasan, dan masalah yang diketahui untuk rilis ini.

WinUI 3

Rilis ini memperkenalkan perbaikan bug penting (termasuk yang diperbaiki dalam rilis layanan 0,5) dan perubahan lain untuk WinUI. Untuk daftar lengkapnya, lihat catatan rilis WinUI 3 - SDK Aplikasi Windows 0.8.

Siklus hidup aplikasi (fitur eksperimental)

Rilis ini memperkenalkan fitur eksperimental baru yang terkait dengan pengelolaan siklus hidup aplikasi aplikasi Anda.

  • Semua aplikasi (dikemas dan tidak dikemas) dapat menggunakan GetActivatedEventArgs (meskipun aplikasi yang dikemas sudah dapat menggunakan implementasi ini di platform).
  • Hanya aplikasi yang tidak dikemas yang dapat menggunakan fungsi RegisterForXXXActivation .
  • Aplikasi desktop kemasan dapat menggunakan instancing siklus hidup aplikasi.

Untuk informasi selengkapnya, lihat Instancing aplikasi dan Aktivasi kaya.

Penyebaran untuk aplikasi yang tidak dikemas (fitur eksperimental)

Rilis ini memperkenalkan fitur penyebaran eksperimental baru untuk aplikasi yang tidak dikemas. Aplikasi yang tidak dipaketkan sekarang dapat secara dinamis mengambil dependensi pada paket runtime SDK Aplikasi Windows sehingga Anda dapat terus menggunakan MSI atau program penyiapan yang ada untuk penyebaran aplikasi. Ini tersedia melalui fitur-fitur berikut:

  • Alat penginstal mandiri untuk SDK Aplikasi Windows.
  • Bundel paket MSIX yang mencakup fungsionalitas dependensi dinamis.

Untuk informasi selengkapnya, lihat panduan penyebaran SDK Aplikasi Windows untuk aplikasi yang bergantung pada kerangka kerja yang dikemas dengan lokasi eksternal atau tidak dikemas.

DWriteCore

Rilis ini menambahkan fitur berikut:

  • Dekorasi teks (garis bawah dan coretan di API tata letak teks)
  • Tata letak teks vertikal
  • API kerning wajah font
  • Dukungan eksperimental untuk aplikasi yang tidak dikemas

Untuk informasi selengkapnya, lihat Merender teks dengan DWriteCore.

MRT Core

Rilis ini menambahkan fitur berikut:

  • Tindakan build untuk sumber daya sekarang diatur secara otomatis, mengurangi kebutuhan akan konfigurasi proyek manual.
  • Dukungan eksperimental untuk aplikasi yang tidak dikemas.

Untuk informasi selengkapnya, lihat Mengelola sumber daya dengan MRT Core.

Batasan dan masalah yang diketahui

  • Tidak ada dukungan untuk konfigurasi build CPU apa pun: SDK Aplikasi Windows ditulis dalam kode asli dan dengan demikian tidak mendukung konfigurasi build CPU apa pun. Templat WinUI 3 di Visual Studio hanya mengizinkan build khusus arsitektur. Saat menambahkan SDK Aplikasi Windows ke aplikasi atau komponen .NET yang ada yang mendukung CPU Apa pun, Anda harus menentukan arsitektur yang diinginkan: x86, atau x64arm64.
  • Aplikasi .NET harus menargetkan build 18362 atau yang lebih baru: TFM Anda harus diatur ke net6.0-windows10.0.18362 atau yang lebih baru, dan proyek <TargetPlatformVersion> kemasan Anda harus diatur ke 18362 atau yang lebih baru. Untuk informasi selengkapnya, lihat masalah yang diketahui di GitHub.

Sampel

Sampel SDK Aplikasi Windows belum berfungsi dengan rilis ini. Sampel baru dan yang diperbarui, termasuk sampel yang menunjukkan fitur baru seperti penyebaran aplikasi yang tidak dikemas, akan segera hadir.