Mulai cepat: Membuat dan menjalankan proyek WinUI 3

Siapkan alat Anda, buat proyek C# WinUI 3 kosong, dan pastikan proyek tersebut berhasil dikompilasi dan diluncurkan. Pilih Visual Studio untuk editor dan debugger terintegrasi, atau dotnet baru untuk bekerja dari baris perintah di editor apa pun. Gunakan tab di bawah ini untuk beralih di antara dua pendekatan.

Panduan singkat ini berakhir dengan proyek yang berjalan. Untuk menambahkan antarmuka pengguna, penyimpanan, dan navigasi, lanjutkan setelahnya dengan Membuat aplikasi catatan WinUI 3.

Visual Studio

Menyiapkan lingkungan pengembangan Anda

Untuk mengembangkan aplikasi WinUI 3 dengan Visual Studio, Anda memerlukan Visual Studio 2026 dengan beban kerja yang diperlukan dan Mode Pengembang diaktifkan.

Menyiapkan dengan WinGet (disarankan)

Buka Terminal Windows dan jalankan perintah berikut di PowerShell untuk menginstal Visual Studio 2026 secara otomatis dengan beban kerja yang diperlukan dan aktifkan Mode Pengembang menggunakan file Konfigurasi WinGet:

winget configure -f https://aka.ms/winui-config

Untuk meninjau file konfigurasi dan mempelajari selengkapnya, lihat README di GitHub.

Note

Jika WinGet tidak tersedia di lingkungan Anda, instal terlebih dahulu:

Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers

Lihat Menggunakan WinGet untuk informasi selengkapnya.

Menyiapkan secara manual

Jika Anda lebih suka menginstal alat secara manual:

1. Aktifkan Mode Pengembang: buka Pengaturan Windows, navigasikan ke Tingkat Lanjut Sistem>, dan alihkan Mode Pengembang ke Aktif.

2. Unduh dan instal Visual Studio 2026. Untuk detailnya, lihat Install Visual Studio.

3. Di penginstal Visual Studio, pilih beban kerja pengembangan aplikasi WinUI pada tab Beban Kerja. Untuk pengembangan C++, pilih juga alat pengembangan aplikasi C++ WinUI di bawah beban kerja tersebut di panel Detail penginstalan.

   

Petunjuk / Saran

Jika Anda tidak melihat templat WinUI setelah menginstal Visual Studio, buka Penginstal Visual Studio, pilih Modify, dan pastikan bahwa beban kerja Pengembangan aplikasi WinUI dipilih. Mulai ulang Visual Studio setelah memodifikasi penginstalan.

Membuat dan meluncurkan aplikasi WinUI 3 pertama Anda

1. Buka Visual Studio 2026 dan pilih Buat proyek baru.

2. Cari WinUI, pilih templat proyek C# WinUI Blank App (Packaged), dan pilih Berikutnya.

   

3. Masukkan nama proyek dan pilih Buat.

   

4. Tekan Mulai (F5) untuk membuat dan menjalankan aplikasi Anda.

   proyek Anda

   Aplikasi Anda membangun, menyebarkan, dan meluncurkan dalam mode debug:

   proyek

   Anda telah membangun dan meluncurkan aplikasi WinUI 3 pertama Anda! 🎉

Baris perintah

Prerequisites

• Windows 10 versi 1809 (build 17763) atau yang lebih baru
• Mode Pengembang diaktifkan (ms-settings:developers)
• .NET 10 SDK atau yang lebih baru (verifikasi dengan dotnet --version)

Membuat dan menjalankan aplikasi WinUI 3 pertama Anda

1. Instal templat proyek WinUI 3 untuk dotnet new (jalankan sekali):

   dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates
   

2. Buat proyek baru dan navigasikan ke dalamnya:

   dotnet new winui -n MyWinUIApp
   cd MyWinUIApp
   

3. Bangun proyek tersebut:

   dotnet build
   

4. Jalankan aplikasi:

   dotnet run
   

   Templat ini mencakup Microsoft.Windows.SDK.BuildTools.WinApp, yang menghubungkan ke target CLI run .NET untuk mendaftarkan identitas debug dan meluncurkan aplikasi dengan identitas paket MSIX - tidak ada langkah penyebaran manual yang diperlukan.

   Jendela aplikasi kosong terbuka. Anda telah membangun dan meluncurkan aplikasi WinUI 3 pertama Anda! 🎉

Troubleshooting

Jika Anda mengalami masalah saat membangun atau menjalankan aplikasi pertama Anda, coba perbaikan umum berikut:

Problem	Solusi
Templat WinUI tidak muncul di Visual Studio	Buka Visual Studio Installer, pilih Modifikasi, dan konfirmasikan beban kerja pengembangan aplikasi WinUI dicentang. Mulai ulang Visual Studio setelah memodifikasi penginstalan. Lihat tips di Menyiapkan lingkungan pengembangan Anda untuk detailnya.
Build gagal karena kesalahan versi SDK	Buka alat penginstal Visual Studio dan pilih Komponen individual. Verifikasi bahwa versi SDK Windows target proyek Anda diinstal. Dalam file proyek Anda, konfirmasikan bahwa TargetFramework cocok dengan SDK yang diinstal (misalnya, net10.0-windows10.0.26100.0).
Kegagalan pemulihan NuGet	Hapus cache NuGet lokal dan pulihkan lagi. Di terminal, jalankan: dotnet nuget locals all --clear lalu dotnet restore.
Kesalahan "Mode Pengembang tidak diaktifkan"	Buka Windows Pengaturan >Sistem > Tingkat Lanjut dan alihkan Mode Pengembang ke Aktif. Lihat Mengaktifkan Mode Pengembang untuk informasi selengkapnya.
Perubahan tidak dikenali setelah penginstalan SDK pertama	Setelah menginstal atau memperbarui beban kerja SDK Aplikasi Windows atau Visual Studio untuk pertama kalinya, mulai ulang Visual Studio sehingga mengambil komponen baru.

Petunjuk / Saran

Jika tidak ada hal di atas yang menyelesaikan masalah Anda, cari masalah SDK Aplikasi Windows GitHub atau tanyakan pada Tanya Jawab Microsoft A.

Langkah berikutnya

Lingkungan pengembangan Anda siap. Langkah selanjutnya yang direkomendasikan adalah tutorial Catatan, yang mengajarkan dasar-dasar XAML dan C# dalam Visual Studio. Jika Anda lebih suka mempelajari alur kerja yang dibantu AI, pilih tutorial Task Tally sebagai gantinya; Anda tidak perlu menyelesaikan keduanya.

Membuat aplikasi catatan WinUI 3

Untuk jalur opsional yang dibantu AI, lihat Membangun aplikasi tugas WinUI 3 dengan asisten AI. Ini mengajarkan cara membatasi kode yang dihasilkan ke WinUI 3 dan memverifikasi hasilnya.

Membuat aplikasi catatan WinUI 3
Pelajari XAML, peristiwa, penyimpanan file, pengikatan data, dan navigasi di aplikasi C# dua halaman.

Galeri WinUI 3
Jelajahi contoh interaktif kontrol, fitur, dan fungsionalitas WinUI.

Sampel dan sumber daya
Telusuri sampel kode, proyek pemula, dan alat untuk mempercepat pengembangan Anda.