Visual Studio untuk pengembangan aplikasi Windows

Visual Studio adalah IDE yang direkomendasikan untuk membangun aplikasi Windows dengan WinUI dan SDK Aplikasi Windows. Ini menyediakan integrasi mendalam dengan platform Windows dan alat yang dibuat khusus untuk pengembangan aplikasi berbasis XAML.

Fitur utama untuk pengembang aplikasi Windows meliputi:

• XAML Hot Reload — ubah markup XAML saat aplikasi Anda berjalan dan lihat perubahan diterapkan secara instan tanpa memulai ulang
• XAML Live Visual Tree — periksa pohon visual runtime aplikasi Anda yang sedang berjalan untuk men-debug masalah tata letak dan memahami hierarki elemen
• IntelliSense untuk XAML dan C#/C++ — dapatkan penyelesaian kode, info cepat, dan penyorotan kesalahan untuk markup dan code-behind
• Penelusuran kesalahan terintegrasi — atur titik henti di XAML dan kode, periksa pengikatan data, dan diagnosis masalah penyajian UI

Untuk memulai, lihat Membuat dan menjalankan proyek WinUI 3.

Templat Proyek WinUI

Visual Studio menyertakan templat proyek untuk membantu Anda membuat aplikasi WinUI dengan cepat. Untuk menemukannya, buka File>New>Project, kemudian filter menurut WinUI di drop-down jenis project atau cari WinUI.

Templat aplikasi

Pilih templat berdasarkan shell aplikasi yang ingin Anda mulai. Pilih nama templat untuk melihat cuplikan layar aplikasi yang dibuat oleh templat tersebut.

Template	Bahasa	template CLI winapp	Deskripsi
Aplikasi Kosong WinUI (Dipaketkan)	C# dan C++	winui (C#)	Satu jendela tanpa konten. Ini adalah titik awal yang direkomendasikan untuk sebagian besar aplikasi baru.
Aplikasi Navigasi WinUI	C#	winui-navview	Shell NavigationView dengan halaman Beranda, Tentang, dan Pengaturan.
Aplikasi WinUI TabView	C#	winui-tabview	Shell TabView yang tabnya berada di bilah judul.
Aplikasi WinUI MVVM	C#	winui-mvvm	Model halaman dan model tampilan yang menggunakan pola Model-View-ViewModel (MVVM) dengan CommunityToolkit.Mvvm.
Aplikasi Kosong (Paket dengan Proyek WAP)	C# dan C++	Tidak tersedia	Aplikasi kosong ditambah Windows Application Packaging Project terpisah.

Membuat proyek dari baris perintah

Templat aplikasi C# juga tersedia dari terminal melalui Windows App Development CLI (winapp CLI). Teruskan nama templat dari tabel ke winapp new, lalu buat dan luncurkan aplikasi dengan winapp run:

winapp new --name MyApp --template winui-navview --use-defaults
cd MyApp
winapp run

Jalankan winapp new --list untuk melihat setiap templat yang diinstal. Proyek yang dihasilkan adalah .csproj standar, sehingga Anda dapat membukanya di Visual Studio kapan saja. Untuk informasi selengkapnya, lihat Menggunakan winapp CLI dengan WinUI.

Aplikasi Kosong WinUI (Dipaketkan)

Membuat aplikasi desktop di C# (.NET) atau C++ (Win32) dengan UI berbasis WinUI. Proyek ini dimulai dengan satu jendela yang berasal dari Microsoft.UI.Xaml.Window, siap untuk Anda menambahkan halaman dan kontrol Anda sendiri. Ini adalah titik awal yang direkomendasikan untuk sebagian besar aplikasi baru. Untuk panduan, lihat Membuat dan menjalankan proyek WinUI 3.

Aplikasi Navigasi WinUI

Membuat aplikasi C# dengan NavigationView di panel kiri. Templat menyertakan halaman Beranda dan Tentang, item Pengaturan, dan kode navigasi yang beralih di antara halaman tersebut.

Aplikasi WinUI TabView

Membuat aplikasi C# dengan TabView yang meluas ke bilah judul. Templat menyertakan tab Beranda dan Tentang dan tombol untuk menambahkan tab baru.

Aplikasi WinUI MVVM

Membuat aplikasi C# yang memisahkan UI dari logika dengan pola MVVM. Templat menggunakan CommunityToolkit.Mvvm untuk properti dan perintah yang dapat diamati, dan menunjukkan penghitung yang terikat ke model tampilan.

Aplikasi Kosong (Dipaketkan dengan Proyek WAP)

Sama seperti templat WinUI Blank App (Packaged) di atas, tetapi menambahkan Proyek Pengemasan Aplikasi Windows terpisah ke solusi. Project ini menangani pembuatan aplikasi Anda menjadi paket MSIX untuk distribusi. Jika Anda lebih suka pengaturan yang lebih sederhana, Anda dapat menggunakan Single-project MSIX sebagai gantinya untuk menghindari mempertahankan project kemasan terpisah.

Komponen dan templat pengujian

Template-template ini membuat pustaka dan proyek pengujian yang bekerja bersama aplikasi WinUI.

Template	Bahasa	templat winapp CLI	Deskripsi
Pustaka Kelas WinUI	C#	winui-lib	Library kelas .NET (DLL) untuk berbagi kode dan komponen UI di seluruh aplikasi WinUI.
Komponen Windows Runtime	C++	Tidak tersedia	Komponen Windows Runtime ditulis dalam C++/WinRT yang dapat digunakan oleh aplikasi apa pun dengan UI berbasis WinUI, terlepas dari bahasa pemrograman.
Aplikasi Uji Unit WinUI	C# dan C++	winui-unittest (C#)	Project MSTest untuk menulis dan menjalankan pengujian otomatis terhadap aplikasi Anda.

Templat WinUI item

Templat item memungkinkan Anda menambahkan file baru ke project WinUI yang sudah ada. Klik kanan proyek Anda di Penjelajah Solusi, pilih Tambahkan> Item Baru, dan pilih tab WinUI.

templat item

Template	Bahasa	Deskripsi
Halaman Kosong	C# dan C++	Menambahkan file XAML dan file kode yang menentukan halaman baru yang berasal dari kelas Microsoft.UI.Xaml.Controls.Page .
Jendela Kosong	C# dan C++	Menambahkan file XAML dan file kode yang menentukan jendela baru yang berasal dari kelas Microsoft.UI.Xaml.Window .
Dialog Konten	C#	Menambahkan file XAML dan file kode yang menentukan dialog baru yang berasal dari kelas Microsoft.UI.Xaml.Controls.ContentDialog. Untuk informasi selengkapnya, lihat Kontrol dialog.
Kamus Sumber Daya	C# dan C++	Menambahkan kumpulan sumber daya XAML yang kosong dan berkunci. Untuk informasi selengkapnya, lihat referensi sumber daya ResourceDictionary dan XAML.
File Sumber Daya (.resw)	C# dan C++	Menambahkan file untuk menyimpan string dan sumber daya bersyarat untuk aplikasi Anda. Anda dapat menggunakan item ini untuk membantu melokalisasi aplikasi Anda. Untuk informasi selengkapnya, lihat Melokalkan string di UI dan manifes paket aplikasi Anda.
Kontrol Berpola	C# dan C++	Menambahkan file kode untuk membuat kontrol templat dengan gaya default. Kontrol templat berasal dari kelas Microsoft.UI.Xaml.Controls.Controls . Untuk panduan yang menunjukkan cara menggunakan templat item ini, lihat Membangun kontrol yang ditemplati XAML. Untuk informasi selengkapnya tentang kontrol templat, lihat Kontrol XAML Kustom.
Kontrol Pengguna	C# dan C++	Menambahkan file XAML dan file kode untuk membuat kontrol pengguna yang berasal dari kelas Microsoft.UI.Xaml.Controls.UserControl . Biasanya, kontrol pengguna merangkum kontrol terkait yang ada dan menyediakan logikanya sendiri. Untuk informasi selengkapnya tentang kontrol pengguna, lihat Kontrol XAML Kustom.

Untuk menambahkan item ini dari baris perintah dalam proyek C#, gunakan templat item dotnet new yang sesuai, seperti dotnet new winui-page -n SettingsPage. Jalankan dotnet new list winui untuk melihat semua templat item.

Baca juga

• SDK Aplikasi Windows
• Membuat dan menjalankan proyek WinUI 3
• Sampel SDK Aplikasi Windows