Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
WinUI 3 adalah kerangka kerja UI asli untuk membangun aplikasi desktop Windows. Ini adalah bagian dari SDK Aplikasi Windows - sekumpulan API dan alat yang terpisah dari sistem operasi Windows itu sendiri dan harus diinstal pada komputer target atau dipaketkan bersama aplikasi Anda. WinUI 3 mendukung C# dan C++ dan bukan kerangka kerja lintas platform atau berbasis web.
Important
WinUI 3 berbeda dari UWP. WinUI 3 menggunakan namespace Microsoft.UI.Xaml dan berjalan sebagai proses desktop; UWP menggunakan Windows.UI.Xaml dan berjalan di dalam kontainer aplikasi. WinUI 3 mendukung paket (MSIX), dikemas dengan lokasi eksternal, dan distribusi yang tidak dikemas - pilihan yang tepat tergantung pada skenario penyebaran Anda. Lihat Memilih metode distribusi untuk panduan.
Pilih jalur Anda
Ada dua jalur yang didukung untuk membuat proyek WinUI 3.
| Visual Studio | Baris perintah | |
|---|---|---|
| Terbaik untuk | Pengembang baru untuk Windows pengembangan, desainer UI visual, atau siapa pun yang menginginkan pengalaman IDE penuh | Pengembang nyaman dengan terminal, alur CI/CD, atau penyiapan lingkungan berskrip |
| Peralatan | Visual Studio 2026 dengan beban kerja SDK Aplikasi Windows dan WinUI terinstal | SDK .NET 10 dengan dotnet new templat WinUI |
| Pembuatan proyek | Wizard Proyek Baru — pilih templat Aplikasi Kosong, Dipaketkan (WinUI 3 untuk Desktop) | dotnet new winui -n MyApp |
| Membangun dan menjalankan | Tekan F5 — Visual Studio membangun, menandatangani, menyebarkan paket MSIX, dan meluncurkan aplikasi |
dotnet run — membangun dan meluncurkan aplikasi dengan identitas paket (memerlukan Mode Pengembang) |
| Pemecahan Masalah | Debugger lengkap Visual Studio dengan pratinjau langsung XAML | Sambungkan debugger secara manual atau buka .sln yang dihasilkan di Visual Studio |
Kedua jalur menghasilkan proyek WinUI 3 yang setara. Jalur Visual Studio menangani penandatanganan dan penyebaran MSIX secara otomatis. Jalur baris perintah menggunakan dotnet run untuk pengembangan lokal (paket yang disertakan Microsoft.Windows.SDK.BuildTools.WinApp menangani identitas debug secara otomatis); pengemasan untuk distribusi memerlukan langkah tambahan.
Membangun dengan asisten pengodisian AI
Anda dapat menggunakan asisten pengodian AI dengan salah satu jalur pengembangan. Asisten dapat menghasilkan kode proyek dan menjelaskan konsep yang tidak dikenal, tetapi Anda masih perlu membatasinya ke WinUI 3, membangun perubahannya, memeriksa hasilnya, dan memverifikasi WINDOWS API terhadap dokumentasi saat ini.
Tutorial WinUI berbantuan AI mengajarkan alur kerja Tanya → Hasilkan → Bangun → Periksa → Verifikasi → Sempurnakan yang dapat diulang. Ini juga menunjukkan cara mendeteksi kode yang dihasilkan yang mencampur WinUI 3 dengan UWP, WPF, atau kerangka kerja UI Windows lainnya.
Prerequisites
Kedua jalur memiliki persyaratan minimum yang sama.
- Windows 10 versi 1809 (build 17763) atau yang lebih baru — Windows 11 direkomendasikan
-
Mode Pengembang diaktifkan di perangkat Anda (
ms-settings:developers) - Visual Studio 2026 (jalur Visual Studio) atau .NET 10 SDK (jalur baris perintah)
SDK Aplikasi Windows adalah penginstalan terpisah dari Windows. Visual Studio menginstalnya sebagai bagian dari penyiapan beban kerja. Untuk penggunaan melalui baris perintah, template dotnet new winui secara otomatis menyertakan paket NuGet yang diperlukan.
Langkah berikutnya
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Windows developer