Bagikan melalui

Catatan rilis saluran yang stabil untuk SDK Aplikasi Windows 0,8

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

Rilis terbaru yang tersedia dari silsilah 0.8.x dari saluran stabil SDK Aplikasi Windows adalah versi 0.8.12.

Catatan

SDK Aplikasi Windows sebelumnya dikenal dengan nama kode Project Reunion. Beberapa aset SDK di versi 0.8 dan yang lebih lama masih menggunakan nama kode. Beberapa area dokumentasi masih menggunakan Project Reunion saat merujuk ke aset yang ada atau rilis sebelumnya yang ditentukan.

Versi 0.8.12

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

Catatan

Untuk pengembang C#, salah satu versi .NET SDK berikut diperlukan: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (atau yang lebih baru). Untuk memperbarui versi .NET SDK Anda, kunjungi Unduhan .NET atau perbarui ke versi terbaru Visual Studio. Tanpa versi .NET SDK yang diperlukan, saat memperbarui paket NuGet Anda, Anda akan melihat kesalahan seperti: "Versi WindowsAppSDK ini memerlukan WinRT.Runtime.dll versi 1.6 atau yang lebih tinggi.".

Perbaikan bug (0.8.12)

  • Memperbaiki masalah saat aplikasi dengan SwapChainPanel atau WebView2 tidak dapat diprediksi mengalami crash karena pelanggaran akses.

Versi 0.8.11

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

Catatan

Untuk pengembang C#, salah satu versi .NET SDK berikut diperlukan: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (atau yang lebih baru). Untuk memperbarui versi .NET SDK Anda, kunjungi Unduhan .NET atau perbarui ke versi terbaru Visual Studio. Tanpa versi .NET SDK yang diperlukan, saat memperbarui paket NuGet Anda, Anda akan melihat kesalahan seperti: "Versi WindowsAppSDK ini memerlukan WinRT.Runtime.dll versi 1.6 atau yang lebih tinggi.".

Perbaikan bug (0.8.11)

  • Memperbaiki regresi yang menyebabkan peristiwa fokus hilang diaktifkan saat memilih teks menggunakan mouse.

Versi 0.8.10

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

Catatan

Untuk pengembang C#, salah satu versi .NET SDK berikut diperlukan: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (atau yang lebih baru). Untuk memperbarui versi .NET SDK Anda, kunjungi Unduhan .NET atau perbarui ke versi terbaru Visual Studio. Tanpa versi .NET SDK yang diperlukan, saat memperbarui paket NuGet Anda, Anda akan melihat kesalahan seperti: "Versi WindowsAppSDK ini memerlukan WinRT.Runtime.dll versi 1.6 atau yang lebih tinggi.".

Perbaikan bug (0.8.10)

  • Memperbaiki masalah yang menyebabkan aplikasi terkadang mengalami crash selama operasi seret dan lepas.

Catatan

SDK Aplikasi Windows 0.8.9 tidak dirilis. Versi yang dirilis langsung setelah 0.8.8 adalah 0.8.10.

Versi 0.8.8

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

Catatan

Untuk pengembang C#, salah satu versi .NET SDK berikut (atau yang lebih baru) diperlukan: 6.0.202, 6.0.104, 5.0.407, 5.0.213. Untuk memperbarui versi .NET SDK Anda, kunjungi Unduhan .NET atau perbarui ke versi terbaru Visual Studio. Tanpa versi .NET SDK yang diperlukan, saat memperbarui paket NuGet Anda, Anda akan melihat kesalahan seperti: "Versi WindowsAppSDK ini memerlukan WinRT.Runtime.dll versi 1.6 atau yang lebih tinggi.".

Perbaikan bug (0.8.8)

  • Memperbaiki masalah input sentuhan di TextBox mengenai keyboard lunak dan interaksi umum. Masalah ini juga memengaruhi pintasan keyboard. Untuk informasi selengkapnya, lihat masalah 6291 di GitHub.
  • Memperbaiki masalah di mana jendela aplikasi terkadang akan ditampilkan sebagai tidak aktif saat aktif.
  • Memperbaiki masalah performa yang disebabkan oleh UIA (UI Automation) yang berjalan dalam proses eksternal.
  • Memperbaiki masalah stabilitas aplikasi dengan input pena.
  • Memperbaiki masalah di mana render ikon png di Menu tertunda secara dramatis karena UIA.

Versi 0.8.7

Ini adalah rilis layanan dari SDK Aplikasi Windows yang mencakup beberapa pembaruan performa untuk aplikasi C#/.NET. Untuk memperbarui ke versi ini, Anda harus mereferensikan versi paket Windows SDK terbaru. Untuk melakukannya, tambahkan properti <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> ke file Anda .csproj dengan versi SDK yang ditargetkan aplikasi Anda dari TargetFramework properti . Contohnya:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

Versi proyeksi Windows SDK ini akan tersedia dalam rilis layanan .NET 6 mendatang. Setelah pembaruan .NET SDK tersedia, Anda harus menghapus <WindowsSdkPackageVersion> properti dari file proyek Anda.

Jika Anda tidak mengatur properti ini, maka Anda akan melihat kesalahan seperti: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Versi 0.8.6

Ini adalah rilis layanan dari SDK Aplikasi Windows yang mencakup beberapa peningkatan performa untuk aplikasi C#/.NET untuk rilis 0.8.0.

Untuk memperbarui ke versi SDK Aplikasi Windows ini, Anda harus menginstal pembaruan .NET SDK Desember terbaru (lihat Unduh .NET dan .NET 5 akan mencapai Akhir Dukungan pada 10 Mei 2022). Jika Anda tidak memiliki versi minimum yang diperlukan dari .NET SDK yang terinstal, maka Anda akan melihat kesalahan seperti "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Perbaikan Bug (0.8.6)

Untuk daftar terperinci peningkatan performa, lihat catatan rilis C#/WinRT 1.4.1.

Versi 0.8.5

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

Perbaikan bug (0.8.5)

  • Memperbaiki masalah yang menyebabkan aplikasi WinUI menggunakan input pointer mengalami crash.
  • Memperbaiki masalah yang menyebabkan tombol bilah judul (min, maks, tutup) tidak memiliki sudut bulat pada Windows 11.
  • Memperbaiki masalah yang menyebabkan opsi tata letak penguatan ukuran tidak muncul saat mengarahkan mouse ke tombol maksimalkan/pulihkan pada Windows 11.
  • Memperbaiki masalah yang menyebabkan pengecualian crash di mana membuat objek PointCollection . Untuk informasi selengkapnya, lihat masalah 971 di Github.

Batasan dan masalah yang diketahui untuk versi 0.8 juga berlaku untuk versi 0.8.5, kecuali ditandai sebaliknya di bagian di bawah ini.

Versi 0.8.4

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

Perbaikan bug (0.8.4)

  • Perbaikan untuk bilah judul kustom sehingga ContentDialog tidak menutupinya, dan tombol bilah judul dibulatkan.
  • Perbaiki untuk crash dalam pemrosesan gambar saat skala tampilan diubah.
  • Memperbaiki bug kliping di mana UI hilang atau diklip dengan tidak benar

Batasan dan masalah yang diketahui untuk versi 0.8 juga berlaku untuk versi 0.8.4, kecuali ditandai sebaliknya di bagian di bawah ini.

Versi 0.8.3

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

Perbaikan bug (0.8.3)

Fokus keyboard hilang ketika jendela diminimalkan lalu dipulihkan, membutuhkan klik mouse untuk memulihkan fokus.

Batasan dan masalah yang diketahui untuk versi 0.8 juga berlaku untuk versi 0.8.3, kecuali ditandai sebaliknya di bagian di bawah ini.

Versi 0.8.2

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

Perbaikan bug (0.8.2)

  • SDK Aplikasi Windows dan WinUI 3 sekarang didukung di Visual Studio 2022 Pratinjau 2 dan yang lebih baru.
  • Untuk aplikasi .NET, Anda mungkin menerima kesalahan berikut saat meneruskan dalam array enum: Object contains non-primitive or non-blittable data.
  • Menulis menggunakan Panel Tulisan Tangan di dalam kotak teks menyebabkan crash
  • Ikon/gambar selalu dimuat pada nilai skala 100% mereka daripada berdasarkan nilai skala monitor
  • Pengumpulan sampah EventSource<T> menyebabkan kegagalan berikutnya untuk berhenti berlangganan handler (lihat masalah GitHub untuk detail selengkapnya)
  • Perbaikan keamanan - lihat CVE-2021-34533 untuk detail selengkapnya.
  • SwapChainPanel.CompositionScaleChanged terkadang mengembalikan nilai KomposisiScale yang salah setelah mengubah skala tampilan

Batasan dan masalah yang diketahui untuk versi 0.8 juga berlaku untuk versi 0.8.2, kecuali ditandai sebaliknya di bagian di bawah ini.

Versi 0.8.1

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

Perbaikan bug (0.8.1)

  • SDK Aplikasi Windows tidak dapat berjalan pada build Windows Insider terbaru
  • Crash di EditableComboBox saat memasukkan nilai yang tidak muncul di dropdown
  • WebView2 tidak mengizinkan pengguna untuk melakukan tab keluar setelah fokus diterima
  • Sepenuhnya memenuhi syarat Windows.Foundation.Metadata.DefaultOverload namespace dalam kode yang dihasilkan WinUI untuk menghindari ambiguitas namespace
    • Ini memperbaiki bug #5108.
  • Perbaikan keamanan - lihat CVE-2021-34489 untuk detail selengkapnya.

Batasan dan masalah yang diketahui untuk versi 0.8 juga berlaku untuk versi 0.8.1, kecuali ditandai sebaliknya di bagian di bawah ini.

Versi 0.8.0 Stabil

Fitur dan pembaruan baru

Rilis ini mendukung semua fitur saluran yang stabil.

WinUI 3:

Rilis ini mencakup banyak perbaikan bug dan peningkatan stabilisasi di seluruh WinUI 3. Ini semua adalah perubahan baru di WinUI 3 sejak rilis WinUI 3 - Project Reunion 0.5:

  • Kontrol Pivot telah ditambahkan kembali dan sekarang dapat digunakan di aplikasi WinUI 3 apa pun.

  • Semua perbaikan bug dari Project Reunion v0.5.5, v0.5.6, dan v0.5.7 disertakan dengan rilis ini.

  • Perbaikan bug baru, termasuk:

    • Klik kanan mouse di TextBox merusak aplikasi
    • NavigationView menyebabkan crash di UWP, Pratinjau Reunion 0.5
    • Bilah Kemajuan tidak menampilkan perbedaan antara opsi Dijeda dan Kesalahan
    • Crash di RichEditBox saat menyalin/menempelkan/mengubah gaya teks
    • Tombol keterangan jendela salah tempat saat SetTitleBar tidak diatur atau null

    Untuk daftar lengkap bug yang dibahas dalam rilis ini, lihat repositori GitHub kami.

  • ColorHelper.ToDisplayName API tidak lagi tersedia.

  • Jenis berikut telah dihapus:

    • Microsoft.Graphics.IGeometrySource2D
    • Microsoft.Graphics.IGeometrySource2DInterop

    Gunakan Windows.Graphics.IGeometrySource2D dan Windows.Graphics.IGeometrySource2DInterop sebagai gantinya.

  • Semua jenis di Microsoft.System namespace telah dipindahkan ke Microsoft.UI.Dispatching namespace layanan, termasuk kelas DispatcherQueue.

  • Properti AcrylicBrush.BackgroundSource telah dihapus, karena HostBackdrop tidak didukung sebagai BackgroundSource di WinUI 3.

Untuk informasi selengkapnya tentang WinUI, lihat WinUI.

Untuk melihat kontrol dan fitur WinUI 3 yang sedang beraksi, Anda dapat mengkloning dan membangun aplikasi Galeri WinUI 3 dari GitHub, atau mengunduh aplikasi dari Microsoft Store.

Untuk mulai mengembangkan dengan WinUI, lihat artikel berikut:

DWriteCore:

Rilis DWriteCore ini mencakup fitur baru dan yang diperbarui berikut. DWriteCore diperkenalkan dan dijelaskan dalam gambaran umum DWriteCore.

Catatan

DWriteCoreCreateFactory secara fungsional sama dengan fungsi DWriteCreateFactory yang diekspor oleh versi sistem DirectWrite. Fungsi DWriteCore memiliki nama yang berbeda untuk menghindari ambiguitas jika Anda menautkan dan DWriteCore.lib DWrite.lib.

Untuk referensi API DWriteCore dan DirectWrite, lihat Referensi API DWriteCore dan Referensi API DirectWrite.

MrtCore:

  • Tindakan Build untuk sumber daya secara otomatis diatur saat Anda menambahkan sumber daya ke proyek Anda, mengurangi kebutuhan akan konfigurasi proyek manual.

Batasan

  • Rilis ini saat ini tidak didukung pada Saluran Dev program Windows Insider. Ini diperbaiki dalam versi 0.8.1.

  • Aplikasi desktop (desktop C# atau C++): Rilis ini didukung untuk digunakan hanya di aplikasi desktop (C++ atau C#) yang dibungkus menggunakan MSIX. Untuk menggunakan SDK Aplikasi Windows di aplikasi desktop yang tidak dikemas, Anda harus menggunakan saluran rilis eksperimental.

Penting

Jika Anda sedang mengerjakan aplikasi UWP, lihat Migrasi dari UWP ke SDK Aplikasi Windows.

Masalah umum

  • Alat WinUI 3 seperti Live Visual Tree, Live Property Explorer, dan Hot Reload di versi 0.8 dan yang lebih baru memerlukan Visual Studio 2019 16.11 Pratinjau 3 dan yang lebih baru.

  • Aplikasi yang saat ini menggunakan WinUI 3 dan SDK Aplikasi Windows 0.8 tidak dapat menggunakan pustaka kelas yang menggunakan Project Reunion 0.5. Perbarui pustaka kelas untuk menggunakan SDK Aplikasi Windows 0,8.

  • 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 kemasan Anda harus diatur ke 18362 atau yang lebih baru. Untuk informasi selengkapnya, lihat Masalah GitHub #921.

  • Anda mungkin mengalami crash saat sering beralih antara mode terang dan gelap.

  • Untuk aplikasi .NET, Anda mungkin menerima kesalahan berikut saat meneruskan array enum: Object contains non-primitive or non-blittable data. Ini diperbaiki dalam versi 0.8.2.

  • Untuk aplikasi .NET, saat ini tidak ada cara untuk memilih keluar dari gambar yang diindeks sebagai sumber daya aplikasi menggunakan UI Visual Studio. Untuk mengatasi hal ini, tambahkan Directory.Build.targets (lihat Mengkustomisasi build Anda - Visual Studio untuk instruksi) ke proyek dan hapus gambar sebagai berikut:

    • Untuk menghapus gambar tertentu (perhatikan bahwa jalur relatif diperlukan):

      <Project>
<ItemGroup>
    <Content Remove="..\Bitmap1.bmp" />
</ItemGroup>
</Project>
      • Untuk menghapus gambar berdasarkan metadata:
      <Project>
<ItemGroup>
    <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
</ItemGroup>
</Project>

      Perbaikan untuk masalah ini direncanakan untuk rilis mendatang - pada saat itu, solusi di atas tidak akan lagi diperlukan.