WinUI

Bersedia untuk membangunkan dengan WinUI 3

Laman dikemaskini :
Tarikh penciptaan halaman :

Persekitaran operasi

Windows
  • Windows 11
Visual Studio
  • Visual Studio 2022 Versi 17.9.3
.BERSIH
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK Aplikasi Windows
  • 1.4.230913002

Prasyarat

Dalam sesetengah kes, versi yang lebih rendah juga boleh berfungsi.

Windows
  • Tingkap 10
  • Windows 11
Visual Studio
  • Visual Studio 2022 versi 17.9.3 atau lebih baharu
.BERSIH
  • .NET 6
  • (.NET 8)
SDK Aplikasi Windows
  • 1.4.230913002 atau lebih baru

Pasang Visual Studio dan sediakan WinUI

Projek pembangunan WinUI 3 boleh ditambah dengan pemasangan Visual Studio. Bahagian ini menyediakan penerangan ringkas tentang proses pemasangan Visual Studio. Untuk arahan terperinci, sila rujuk Petua berikut.

Lancarkan pemasang Visual Studio 2022 daripada internet atau media. Ia menyokong edisi Komuniti, Profesional atau lebih tinggi.

Dalam pemilihan beban kerja, pilih . Pembangunan Desktop NET.

「. Pembangunan Desktop NET dan semak Templat C# SDK Aplikasi Windows daripada Butiran Pemasangan di sebelah kanan.

Sekarang mulakan sahaja pemasangan. Terdapat skrin lain, tetapi saya tidak akan menerangkannya sehingga mereka membuat projek.

Setelah pemasangan selesai, buat projek baharu.

Terdapat dalam item carian di bahagian winui atas sebelah kanan, jadi apabila anda memilihnya, templat projek WinUI 3 akan dipaparkan, jadi pilih mana-mana templat dan buat projek.

Anda kini boleh membangunkan aplikasi menggunakan WinUI 3.

Jika anda melihat "Menyasarkan versi .NET yang tidak dipasang"

Sehingga versi 17.9.1 Visual Studio 2022 , .NET untuk WinUI 3 menyasarkan .NET 6. Jika anda tidak memilih sebarang masa jalan tambahan dalam Visual Studio 2022, hanya masa jalan .NET 8 akan dipasang dan anda mungkin melihat amaran seperti yang di bawah.

Jika anda bimbang, anda boleh memasang masa jalan .NET 6 atau hanya menolak amaran. Anda tidak perlu memasang masa jalan .NET 6 untuk nyahpepijat.

Jika anda ingin menambah persekitaran pembangunan WinUI 3 kemudian

Jika anda memasang Visual Studio terlebih dahulu, anda boleh menambah persekitaran pembangunan WinUI 3 kemudian.

Mulakan Visual Studio dan pilih Alat > Dapatkan Alat dan Ciri daripada menu.

Skrin yang sama seperti semasa anda memasang Visual Studio akan dipaparkan, jadi anda boleh menggunakan . Pastikan "Pembangunan Desktop .NET" ditandakan, dan semak "Templat C# SDK Apl Windows" daripada "Butiran Pemasangan" di sebelah kanan.

Dayakan mod pembangun

Aplikasi WinUI berjalan dalam persekitaran yang dipertingkatkan keselamatan tidak seperti aplikasi desktop lain. Oleh itu, ia tidak boleh dijalankan seperti sedia ada. Apabila anda cuba menjalankannya, anda akan melihat dialog seperti di bawah dan anda akan digesa untuk mendayakan "Mod Pembangun". Jika anda mengklik pautan, skrin tetapan akan dipaparkan, jadi sila dayakan "Mod Pembangun".

Walaupun anda tidak menggunakan Visual Studio, anda juga boleh mendayakan atau melumpuhkan "Mod Pembangun" daripada skrin tetapan. Pilih "Tetapan" daripada menu Mula.

Daripada menu Sistem, pilih Untuk Pembangun.

Terdapat togol untuk "Untuk pembangun", jadi tetapkannya kepada "Hidup". Nota akan dipaparkan, jadi pilih "Ya" untuk mendayakannya.

Jika anda ingin menukar kepada .NET 8

Jika anda mencipta projek dengan templat ini, ia akan lalai kepada .NET 6. Walaupun saya menukar rangka kerja sasaran kepada .NET 8 daripada sifat projek, binaan masih menunjukkan ralat dan amaran. Walau bagaimanapun, sekitar 03/13/2024, SDK Apl Windows akan dikemas kini untuk menyokong .NET 8 secara rasmi.

Walau bagaimanapun, templat masih dalam .NET 6, jadi anda perlu bekerja pada .NET 8 sebaik sahaja anda mencipta projek. Mungkin terdapat kemungkinan bahawa ia akan disokong dalam peningkatan versi akan datang.

Mula-mula, cipta projek, dan kemudian gunakan NuGet untuk mengemas kini versi berkaitan SDK Aplikasi Windows.

Melainkan sebaliknya, semuanya dikemas kini. Microsoft.WindowsAppSDK mestilah sekurang-kurangnya 1.5.XXXX.

Tukar rangka kerja sasaran kepada .NET 8 daripada sifat projek.

Walaupun anda membina dalam keadaan ini, ralat akan dipaparkan kerana tetapan projek sudah lapuk.

Buka fail projek sebagai kod.

RuntimeIdentifiersOleh kerana terdapat parameter, keluarkan aksara seperti 10 berikut Win10 .

Sebelum Pengubahsuaian

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Selepas pembetulan

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Ia juga menulis semula tetapan penerbitan program. Buka setiap .pubxml fail dalam folder Properties > PublishProfiles.

Begitu juga RuntimeIdentifier , keluarkan aksara dalam 10 Win10 parameter .

Selepas itu, bina semula dan sahkan bahawa tiada ralat atau amaran. .pubxml (Akan ada amaran dalam fail, tetapi anda tidak perlu risau mengenainya kerana ia adalah sintaks yang berbeza daripada isu ini.) )

Walau bagaimanapun, atas sebab tertentu, perpustakaan kelas WinUI terus memberi amaran walaupun anda melakukan perkara yang sama seperti di atas. Buat masa ini, anda boleh menjalankannya, jadi mari kita tunggu sehingga ini diperbaiki.