WinUI

Bersiap untuk mengembangkan dengan WinUI 3

Halaman Diperbarui :
Tanggal pembuatan halaman :

Lingkungan operasi

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

Prasyarat

Dalam beberapa kasus, versi yang lebih rendah mungkin juga berfungsi.

Windows
  • Jendela 10
  • Jendela 11
Visual Studio
  • Visual Studio 2022 versi 17.9.3 atau yang lebih baru
.JARING
  • .NET 6
  • (.NET 8)
SDK Aplikasi Windows
  • 1.4.230913002 atau yang lebih baru

Menginstal Visual Studio dan menyiapkan WinUI

Proyek pengembangan WinUI 3 dapat ditambahkan dengan penginstalan Visual Studio. Bagian ini memberikan deskripsi yang disederhanakan tentang proses penginstalan Visual Studio. Untuk instruksi terperinci, silakan lihat Tips berikut.

Luncurkan penginstal Visual Studio 2022 dari internet atau media. Ini mendukung edisi Komunitas, Profesional, atau yang lebih tinggi.

Dalam pemilihan beban kerja, pilih . NET Desktop Development.

「. NET Desktop Development dan periksa Windows App SDK C# Templates dari Detail Instalasi di sebelah kanan.

Sekarang mulai saja instalasi. Ada layar lain, tetapi saya tidak akan menjelaskannya sampai mereka membuat proyek.

Setelah penginstalan selesai, buat proyek baru.

Ada item pencarian di kanan winui atas, jadi ketika Anda memilihnya, templat proyek WinUI 3 akan ditampilkan, jadi pilih templat apa pun dan buat proyek.

Anda sekarang dapat mengembangkan aplikasi menggunakan WinUI 3.

Jika Anda melihat "Menargetkan versi .NET yang tidak diinstal"

Pada versi 17.9.1 Visual Studio 2022 , .NET untuk WinUI 3 menargetkan .NET 6. Jika Anda tidak memilih runtime tambahan di Visual Studio 2022, hanya runtime .NET 8 yang akan diinstal, dan Anda mungkin melihat peringatan seperti di bawah ini.

Jika Anda khawatir, Anda dapat menginstal runtime .NET 6 atau tutup saja peringatan. Anda tidak perlu menginstal runtime .NET 6 untuk men-debug.

Jika Anda ingin menambahkan lingkungan pengembangan WinUI 3 nanti

Jika Anda menginstal Visual Studio terlebih dahulu, Anda dapat menambahkan lingkungan pengembangan WinUI 3 nanti.

Mulai Visual Studio dan pilih Alat > Dapatkan Alat dan Fitur dari menu.

Layar yang sama seperti saat Anda menginstal Visual Studio akan ditampilkan, sehingga Anda dapat menggunakan file . Pastikan "Pengembangan Desktop .NET" dicentang, dan centang "Templat SDK Aplikasi Windows C#" dari "Detail Instalasi" di sebelah kanan.

Aktifkan mode pengembang

Aplikasi WinUI berjalan di lingkungan yang ditingkatkan keamanan, tidak seperti aplikasi desktop lainnya. Oleh karena itu, tidak dapat dijalankan apa adanya. Saat Anda mencoba menjalankannya, Anda akan melihat dialog seperti di bawah ini dan Anda akan diminta untuk mengaktifkan "Mode Pengembang". Jika Anda mengklik tautan, layar pengaturan akan ditampilkan, jadi harap aktifkan "Mode Pengembang".

Bahkan jika Anda tidak menggunakan Visual Studio, Anda juga dapat mengaktifkan atau menonaktifkan "Mode Pengembang" dari layar pengaturan. Pilih "Pengaturan" dari menu Mulai.

Dari menu Sistem, pilih Untuk Pengembang.

Ada sakelar untuk "Untuk pengembang", jadi atur ke "Aktif". Sebuah catatan akan ditampilkan, jadi pilih "Ya" untuk mengaktifkannya.

Jika Anda ingin mengubah ke .NET 8

Jika Anda membuat proyek dengan templat ini, itu akan default ke .NET 6. Bahkan jika saya mengubah kerangka kerja target ke .NET 8 dari properti proyek, build masih menunjukkan kesalahan dan peringatan. Namun, sekitar 13/03/2024, SDK Aplikasi Windows akan diperbarui untuk mendukung .NET 8 secara resmi.

Namun, templat masih dalam .NET 6, jadi Anda harus mengerjakan .NET 8 setelah Anda membuat proyek. Mungkin ada kemungkinan bahwa itu akan didukung dalam peningkatan versi di masa mendatang.

Pertama, buat proyek, lalu gunakan NuGet untuk memperbarui versi terkait SDK Aplikasi Windows.

Kecuali jika sebaliknya, semuanya mutakhir. Microsoft.WindowsAppSDK harus minimal 1.5.XXXX.

Ubah kerangka kerja target ke .NET 8 dari properti proyek.

Bahkan jika Anda membangun dalam status ini, kesalahan akan ditampilkan karena pengaturan proyek sudah kedaluwarsa.

Buka file proyek sebagai kode.

RuntimeIdentifiersKarena ada parameter, hapus karakter sebagai 10 berikut Win10 .

Sebelum Modifikasi

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

↓

Setelah perbaikan

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

Ini juga menulis ulang pengaturan penerbitan program. Buka setiap .pubxml file di folder Properties > PublishProfiles.

Demikian pula RuntimeIdentifier , hapus karakter dalam 10 Win10 parameter .

Setelah itu, bangun kembali dan verifikasi bahwa tidak ada kesalahan atau peringatan. .pubxml (Akan ada peringatan dalam file, tetapi Anda tidak perlu khawatir karena sintaksnya berbeda dari masalah ini.) )

Namun, untuk beberapa alasan, pustaka kelas WinUI terus memperingatkan bahkan jika Anda melakukan hal yang sama seperti di atas. Untuk saat ini, Anda dapat menjalankannya, jadi mari kita tunggu sampai ini diperbaiki.