Templat WinUI 3 di Visual Studio
Setelah menyiapkan komputer pengembangan (lihat Menginstal alat untuk SDK Aplikasi Windows), Anda siap untuk membuat aplikasi WinUI 3 dengan memulai dari salah satu templat proyek WinUI 3 di Visual Studio. Topik ini menjelaskan templat proyek dan item yang tersedia. Dan Buat proyek WinUI 3 pertama Anda memanah Anda dalam membuat proyek.
Untuk mengakses templat proyek WinUI 3, di filter drop-down dialog Proyek Baru, pilih C#/C++, Windows, dan WinUI. Atau, Anda dapat mencari WinUI, dan memilih salah satu templat C# atau C++ yang tersedia.
Templat proyek untuk WinUI 3
Anda dapat menggunakan templat proyek WinUI 3 ini untuk mulai membuat aplikasi.
Aplikasi Kosong, Dipaketkan (WinUI 3 di Desktop)
Templat proyek ini membuat aplikasi desktop .NET (C#) atau Win32 (C++) asli dengan antarmuka pengguna berbasis WinUI 3. Proyek yang dihasilkan mencakup jendela dasar yang berasal dari kelas Microsoft.UI.Xaml.Window di pustaka WinUI 3 yang dapat Anda gunakan untuk mulai membangun UI Anda. Untuk informasi selengkapnya tentang menggunakan templat proyek ini, lihat Membuat proyek WinUI 3 pertama Anda.
Fitur templat proyek ini bervariasi di antara versi ekstensi SDK Aplikasi Windows.
Versi 1.0 Pratinjau 2: Dimulai dengan rilis ini, templat proyek ini menghasilkan proyek aplikasi dengan manifes paket dan dukungan lain yang diperlukan untuk membangun aplikasi ke dalam paket MSIX tanpa menggunakan proyek pengemasan terpisah. Untuk menggunakan templat proyek ini, Anda juga harus menginstal ekstensi alat pengemasan MSIX proyek tunggal untuk Visual Studio.
Catatan
Dalam versi 1.0 Pratinjau 2 dan rilis yang lebih baru, templat proyek ini hanya mendukung satu executable dalam paket MSIX yang dihasilkan. Jika Anda perlu menggabungkan beberapa executable ke dalam satu paket MSIX, maka Anda harus menggunakan templat proyek Blank App, Packaged with Windows Application Packaging Project (WinUI 3 in Desktop), atau menambahkan Proyek Pengemasan Aplikasi Windows ke solusi Anda.
Pratinjau Versi 1.0 1 dan yang lebih lama: Dalam rilis ini, templat proyek ini menghasilkan solusi dengan Proyek Pengemasan Aplikasi Windows terpisah yang dikonfigurasi untuk membangun aplikasi ke dalam paket MSIX. Anda dapat secara opsional menginstal ekstensi alat pengemasan MSIX proyek tunggal untuk Visual Studio dan menggabungkan pengaturan proyek pengemasan ke dalam proyek aplikasi Anda sehingga Anda tidak perlu lagi mempertahankan proyek pengemasan terpisah.
Aplikasi Kosong, Dikemas dengan Proyek Kemasan Aplikasi Windows (WinUI 3 di Desktop)
Templat proyek ini tersedia di versi 1.0 Pratinjau 1 dan rilis yang lebih baru. Ini membuat aplikasi desktop .NET (C#) atau Win32 (C++) asli dengan antarmuka pengguna berbasis WinUI 3. Proyek yang dihasilkan mencakup jendela dasar yang berasal dari kelas Microsoft.UI.Xaml.Window di pustaka WinUI 3 yang dapat Anda gunakan untuk mulai membangun UI Anda. Untuk informasi selengkapnya tentang menggunakan templat proyek ini, lihat Membuat proyek WinUI 3 pertama Anda.
Solusi ini juga mencakup Proyek Pengemasan Aplikasi Windows terpisah yang dikonfigurasi untuk membangun aplikasi ke dalam paket MSIX. Anda dapat secara opsional menginstal ekstensi alat pengemasan MSIX proyek tunggal untuk Visual Studio dan menggabungkan pengaturan proyek pengemasan ke dalam proyek aplikasi Anda sehingga Anda tidak perlu lagi mempertahankan proyek pengemasan terpisah.
[Eksperimental] Aplikasi Kosong (WinUI 3 di UWP)
Templat proyek ini membuat aplikasi UWP C# atau C++ yang dengan antarmuka pengguna berbasis WinUI 3. Proyek yang dihasilkan mencakup halaman dasar yang berasal dari kelas Microsoft.UI.Xaml.Controls.Page di pustaka WinUI 3, yang dapat Anda gunakan untuk mulai membangun UI Anda. Untuk informasi selengkapnya tentang templat proyek ini, lihat Membuat aplikasi WinUI 3 pertama Anda.
Templat proyek WinUI untuk komponen lain
Anda dapat menggunakan templat proyek WinUI 3 ini untuk membangun komponen yang dapat dimuat dan digunakan oleh aplikasi berbasis WinUI 3.
| Templat | Bahasa | Deskripsi |
|---|---|---|
| Pustaka Kelas (WinUI 3 di Desktop) | Hanya C# | Membuat pustaka kelas terkelola .NET (DLL) di C# yang dapat digunakan oleh aplikasi desktop .NET lainnya dengan antarmuka pengguna berbasis WinUI 3. |
| [Eksperimental] Pustaka Kelas (WinUI 3 di UWP) | Hanya C# | Membuat pustaka kelas terkelola (DLL) di C# yang dapat digunakan oleh aplikasi UWP lain dengan antarmuka pengguna berbasis WinUI 3. |
| Komponen Runtime Windows (WinUI 3) | C++ | Membuat komponen Windows Runtime yang ditulis dalam C++/WinRT yang dapat digunakan oleh UWP atau aplikasi desktop apa pun dengan antarmuka pengguna berbasis WinUI 3, terlepas dari bahasa pemrograman tempat aplikasi ditulis. |
| [Eksperimental] Komponen Runtime Windows (WinUI 3 di UWP) | C# | Membuat komponen Windows Runtime yang ditulis dalam C# yang dapat dikonsumsi oleh aplikasi UWP apa pun dengan antarmuka pengguna berbasis WinUI 3, terlepas dari bahasa pemrograman tempat aplikasi ditulis. |
Templat item untuk WinUI 3
Templat item berikut tersedia untuk digunakan dalam proyek WinUI 3. Untuk mengakses templat item WinUI 3 ini, klik kanan simpul proyek di Penjelajah Solusi, pilih Tambahkan item ->Baru, dan klik WinUI dalam dialog Tambahkan Item Baru.
Catatan
Jika Anda memiliki saluran eksperimental atau rilis pratinjau SDK Aplikasi Windows yang lebih lama terinstal, Anda mungkin melihat set kedua Templat Item yang memiliki awalan [Eksperimental]. Kami menyarankan agar Anda menggunakan templat item [Eksperimental] tersebut jika Anda membangun aplikasi non-produksi/pratinjau, dan menggunakan templat item yang stabil dan tidak ditandai jika Anda membangun aplikasi desktop produksi.
| Templat | Bahasa | Deskripsi |
|---|---|---|
| Halaman Kosong (WinUI 3) | C# dan C++ | Menambahkan file XAML dan file kode yang menentukan halaman baru yang berasal dari kelas Microsoft.UI.Xaml.Controls.Page di pustaka WinUI 3. |
| Jendela Kosong (WinUI 3 di Desktop) | C# dan C++ | Menambahkan file XAML dan file kode yang menentukan jendela baru yang berasal dari kelas Microsoft.UI.Xaml.Window di pustaka WinUI 3. |
| Kontrol Kustom (WinUI 3) | C# dan C++ | Menambahkan file kode untuk membuat kontrol templat dengan gaya default. Kontrol templat berasal dari kelas Microsoft.UI.Xaml.Controls.Controls di pustaka WinUI 3.Untuk panduan yang menunjukkan cara menggunakan templat item ini, lihat Kontrol XAML templat untuk aplikasi UWP dan WinUI 3 dengan kontrol C++/WinRT dan Templated XAML untuk aplikasi UWP dan WinUI 3 dengan C#. Untuk informasi selengkapnya tentang kontrol templat, lihat Kontrol XAML Kustom. |
| Kamus Sumber Daya (WinUI 3) | C# dan C++ | Menambahkan kumpulan sumber daya XAML yang kosong dan dikun kunci. Untuk informasi selengkapnya, lihat Referensi sumber daya ResourceDictionary dan XAML. |
| File Sumber Daya (WinUI 3) | C# dan C++ | Menambahkan file untuk menyimpan string dan sumber daya bersyarah untuk aplikasi Anda. Anda dapat menggunakan item ini untuk membantu melokalisasi aplikasi Anda. Untuk informasi selengkapnya, lihat Melokalkan string di manifes paket UI dan aplikasi Anda. |
| Kontrol Pengguna (WinUI 3) | C# dan C++ | Menambahkan file XAML dan file kode untuk membuat kontrol pengguna yang berasal dari kelas Microsoft.UI.Xaml.Controls.UserControl di pustaka WinUI 3. Biasanya, kontrol pengguna merangkum kontrol terkait yang ada dan menyediakan logikanya sendiri.Untuk informasi selengkapnya tentang kontrol pengguna, lihat Kontrol XAML Kustom. |
Lihat juga
Windows developer
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk