Mulai cepat: Membuat aplikasi WinUI 3 pertama Anda

Buat, bangun, dan jalankan aplikasi WinUI 3 pertama Anda. Pilih Visual Studio untuk pengalaman IDE lengkap dengan dukungan desainer visual, atau dotnet baru untuk bekerja dari baris perintah di editor apa pun. Gunakan tab di bawah ini untuk beralih di antara dua pendekatan.

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! 🎉

Langkah berikutnya

Membangun aplikasi WinUI pertama Anda
Siap untuk melaju lebih jauh? Ikuti tutorial langkah demi langkah untuk membangun aplikasi WinUI lengkap.

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.