Bagikan melalui

Catatan rilis saluran yang stabil untuk SDK Aplikasi Windows 1.3

  • Artikel

Saluran stabil menyediakan rilis SDK Aplikasi Windows yang didukung untuk digunakan oleh aplikasi di lingkungan produksi. Aplikasi yang menggunakan rilis stabil SDK Aplikasi Windows juga dapat diterbitkan ke Microsoft Store.

Tautan penting:

Rilis saluran stabil terbaru:

Unduhan untuk SDK Aplikasi Windows

Catatan

SDK Aplikasi Windows Visual Studio Extensions (VSIX) tidak lagi didistribusikan sebagai unduhan terpisah. Mereka tersedia di Visual Studio Marketplace di dalam Visual Studio.

Versi 1.3.3 (1.3.230724000)

Ini adalah rilis layanan dari SDK Aplikasi Windows yang mencakup perbaikan bug penting untuk rilis 1.3.

  • Memperbaiki masalah di mana mouse terkadang akan berhenti berfungsi ketika kotak dialog ditutup.
  • Memperbaiki masalah penyebaran yang mencegah aplikasi diinstal karena ketidakcocokan versi paket pada sistem. Untuk informasi selengkapnya, lihat Masalah GitHub #3740.
  • Memperbaiki masalah yang memengaruhi pemosisian menu konteks di SDK Aplikasi Windows 1.3.
  • Memperbaiki masalah yang menyebabkan beberapa aplikasi WinUI3, dalam beberapa situasi, mengalami crash saat aplikasi ditutup karena XAML mematikan dirinya terlalu dini.
  • Memperbaiki masalah di mana ikon font tidak mencerminkan dengan benar dalam bahasa kanan-ke-kiri. Untuk informasi selengkapnya, lihat Masalah GitHub #7661.
  • Memperbaiki masalah yang menyebabkan aplikasi mengalami crash saat pematian saat sumber daya dicabik-cabik dalam urutan yang buruk. Untuk informasi selengkapnya, lihat Masalah GitHub #7924.

Versi 1.3.2 (1.3.230602002)

Ini adalah rilis layanan dari SDK Aplikasi Windows yang mencakup perbaikan bug penting untuk rilis 1.3.

  • Memperbaiki crash saat mengatur Kursor Terproteksi.
  • Memperbaiki masalah performa di XamlMetadataProvider selama pengaktifan aplikasi. Untuk informasi selengkapnya, lihat Masalah GitHub #8281.
  • Memperbaiki masalah dengan hyperlink dan menyentuh RichTextBlock. Untuk informasi selengkapnya, lihat Masalah GitHub #6513.
  • Memperbaiki masalah dengan pengguliran dan touchpad di WebView2. Untuk informasi selengkapnya, lihat Masalah GitHub #7772.
  • Memperbaiki masalah saat pembaruan SDK Aplikasi Windows terkadang memerlukan hidupkan ulang Visual Studio. Untuk informasi selengkapnya, lihat Masalah GitHub #3554.
  • Memperbaiki pengecualian yang bising saat dimatikan saat berjalan dalam debugger.

Versi 1.3.1 (1.3.230502000)

Ini adalah rilis layanan dari SDK Aplikasi Windows yang mencakup perbaikan bug penting untuk rilis 1.3.

  • Memperbaiki masalah yang menyebabkan aplikasi mengalami crash saat mengatur SystemBackdrop jika Konten null. Untuk informasi selengkapnya, lihat Masalah GitHub #8416.
  • Memperbaiki masalah yang menyebabkan aplikasi mengalami crash saat mengatur Judul Jendela di XAML, kemampuan baru yang ditambahkan dalam 1.3.0. Untuk informasi selengkapnya, lihat Masalah GitHub #3689.
  • Memperbaiki masalah di mana jendela salah mengambil fokus saat kontennya berubah.
  • Memperbaiki masalah dalam membuat proyek C++ dengan templat proyek WinAppSDK 1.3.
  • Templat yang diperbarui di Visual Studio Marketplace

Fitur baru dan yang diperbarui serta masalah yang diketahui untuk versi 1.3

Bagian berikut menjelaskan fitur baru dan yang diperbarui serta masalah yang diketahui untuk versi 1.3.

Di aplikasi SDK Aplikasi Windows 1.2 yang ada, Anda dapat memperbarui paket Nuget ke 1.3.230331000 (lihat bagian Memperbarui paket di Menginstal dan mengelola paket di Visual Studio menggunakan Manajer Paket NuGet).

Untuk runtime yang diperbarui dan MSIX, lihat Unduhan SDK Aplikasi Windows terbaru.

API Backdrop XAML

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

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

Dengan mengganti beberapa baris kode boilerplate, Anda sekarang dapat menggunakan API AppWindow langsung dari Window melalui Window.AppWindow.

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.
  • Peristiwa baru, DebugSettings.XamlResourceReferenceFailed sekarang dinaikkan 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 spesifikasi API kegagalan pencarian referensi sumber daya XAML Pelacakan di GitHub.

Pembaruan lainnya

  • Lihat tonggak WinAppSDK 1.3 kami di WinAppSDK GitHub untuk masalah tambahan yang dibahas dalam rilis ini.
  • Lihat tonggak WinUI 3 di WinAppSDK 1.3 kami di GitHub microsoft-ui-xaml untuk masalah tambahan yang ditangani dalam rilis ini.
  • Dengan VSIX eksperimental terbaru, Anda sekarang dapat mengonversi aplikasi antara unpackaged dan dikemas melalui menu Visual Studio alih-alih di file proyek Anda.

Masalah yang diketahui

Karena perubahan terbaru pada pengkompilasi xaml, proyek yang ada yang ditingkatkan ke 1.3 mungkin mengalami kesalahan build seperti berikut ini dalam Visual Studio:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Ini disebabkan oleh Visual Studio menggunakan dll tugas kompilator xaml cache dari 1.2, tetapi mendorongnya dengan logika MSBuild yang tidak kompatibel dari 1.3, seperti yang terlihat pada teks kesalahan di atas. Solusinya adalah mematikan Visual Studio, memulai ulang, dan memuat ulang solusi.