Bagikan melalui

Mulai menggunakan WinUI

  • Artikel

Selamat datang untuk mengembangkan aplikasi dengan WinUI. Panduan ini akan memandu Anda melalui langkah-langkah yang Anda butuhkan untuk memulai. Ini juga akan mengarahkan Anda ke sumber daya yang akan membantu Anda mempelajari lebih lanjut tentang pengembangan Windows.

1. Instal Visual Studio

Anda akan menggunakan Visual Studio, lingkungan pengembangan terintegrasi (IDE) Microsoft yang komprehensif, untuk membuat aplikasi WinUI Anda. Ini adalah alat pengembangan pilihan dari banyak pengembang Windows dan akan membantu Anda menulis, men-debug, dan menyebarkan aplikasi Anda. Templat proyek di Visual Studio akan dengan cepat membuat Anda mulai menggunakan proyek untuk Windows dan banyak platform lainnya.

Tip

Sebelum menginstal alat-alat ini, pastikan komputer pengembangan Anda memenuhi persyaratan sistem untuk pengembangan aplikasi Windows.

Gunakan tautan ini untuk mengunduh dan menginstal Visual Studio terbaru. Alat penginstal akan memandu Anda melalui langkah-langkah, tetapi jika Anda menemukan Bahwa Anda memerlukan instruksi terperinci, lihat Menginstal Visual Studio.

Unduh Visual Studio

Visual Studio Community Edition gratis mencakup semua yang Anda butuhkan untuk membuat aplikasi Anda. Jika Anda bekerja dengan tim pengembangan atau perusahaan, Anda mungkin memerlukan Visual Studio Professional atau Visual Studio Enterprise. Lihat Apa itu Visual Studio? untuk informasi selengkapnya.

Beban kerja dan komponen yang diperlukan

Saat menginstal Visual Studio, Anda perlu menginstal beban kerja dan komponen yang diperlukan untuk mengembangkan dengan WinUI dan SDK Aplikasi Windows. Setelah penginstalan, Anda dapat membuka aplikasi Penginstal Visual Studio dan memilih Ubah untuk menambahkan beban kerja dan komponen.

Pada tab Beban Kerja aplikasi Penginstal Visual Studio, pilih beban kerja dan komponen berikut:

  • Untuk pengembangan aplikasi C# menggunakan SDK Aplikasi Windows, pilih Pengembangan aplikasi Windows.

Cuplikan layar UI penginstal Visual Studio dengan beban kerja pengembangan aplikasi Windows dipilih.

  • Untuk pengembangan aplikasi C++ menggunakan SDK Aplikasi Windows, pilih Pengembangan aplikasi Windows.
    • Kemudian di panel Detail penginstalan, di bawah simpul pengembangan aplikasi Windows, pilih alat pengembangan aplikasi C++ WinUI. (Ini juga akan memilih komponen tambahan yang diperlukan.)

Cuplikan layar UI penginstal Visual Studio dengan alat pengembangan aplikasi C++ WinUI dipilih.

2. Aktifkan Mode Pengembang

Windows memiliki mode khusus untuk pengembang yang menyesuaikan pengaturan keamanan untuk memungkinkan Anda menjalankan aplikasi yang sedang Anda kerjakan. Anda harus mengaktifkan Mode Pengembang sebelum dapat membuat, menyebarkan, dan menguji aplikasi menggunakan Visual Studio.

Tip

Jika Anda tidak mengaktifkannya sekarang, Anda akan diminta untuk mengaktifkannya saat mencoba membuat aplikasi di Visual Studio.

Untuk mengaktifkan Mode Pengembang:

  • Buka Windows Pengaturan dan navigasikan ke halaman Sistem > Untuk pengembang.
  • Alihkan tombol Mode Pengembang ke Aktif dan konfirmasikan pilihan Anda dalam dialog konfirmasi.

Untuk informasi selengkapnya tentang Mode Pengembang, lihat Mengaktifkan perangkat Anda untuk pengembangan.

3. Buat dan luncurkan aplikasi WinUI pertama Anda

Templat proyek Visual Studio menyertakan semua file yang Anda butuhkan untuk membuat aplikasi dengan cepat. Bahkan, setelah membuat proyek dari templat aplikasi WinUI, Anda akan memiliki aplikasi yang dapat dijalankan, lalu menambahkan kode Anda.

Untuk membuat proyek baru menggunakan templat proyek Aplikasi Kosong WinUI C#:

  1. Buka Visual Studio dan pilih Buat proyek baru dari halaman peluncuran. (Jika Visual Studio sudah terbuka untuk editor, pilih Proyek Baru>File):>Membuat proyek baru

  2. Cari WinUI dan pilih Blank App, Packaged (WinUI 3 in Desktop) templat proyek C#, lalu klik Berikutnya: Aplikasi desktop WinUI 3 C# kosong dan dipaketkan

  3. Tentukan nama proyek, lalu klik Buat. Anda dapat secara opsional menentukan nama solusi dan direktori, atau meninggalkan default. Dalam gambar ini, Hello World proyek milik solusi Hello World , yang akan hidup di C:\Projects\: Tentukan detail proyek

  4. Klik tombol Debug "Mulai" untuk membangun dan menjalankan proyek Anda:
    Membangun dan menjalankan proyek Anda
    Proyek Anda Hello World akan dibangun, disebarkan ke komputer lokal Anda, dan berjalan dalam mode debug:
    Halo Dunia proyek yang dibangun dan dijalankan

  5. Untuk menghentikan penelusuran kesalahan, tutup jendela aplikasi, atau klik tombol debug "Hentikan" di Visual Studio.

4. Perbarui ke WinUI/SDK Aplikasi Windows terbaru

SDK Aplikasi Windows (dan WinUI, yang merupakan bagian darinya) didistribusikan sebagai paket NuGet. Ini berarti pembaruan dapat dirilis di luar sinkronisasi dengan Windows dan Visual Studio. Akibatnya, templat Visual Studio yang Anda gunakan untuk membuat proyek Anda mungkin tidak mereferensikan paket nuGet SDK Aplikasi Windows terbaru. Untuk memastikan Anda memiliki fitur dan perbaikan terbaru, Anda harus memperbarui paket NuGet setiap kali Membuat proyek baru di Visual Studio.

Untuk memperbarui paket NuGet SDK Aplikasi Windows untuk proyek Anda:

  • Di Visual Studio, dengan proyek Anda dimuat, pilih Alat>Pengelola>Paket NuGet Kelola Paket NuGet untuk Solusi....
  • Jika pembaruan tersedia, pembaruan akan muncul di halaman Pembaruan. Centang kotak di samping pembaruan yang tercantum. (Untuk menyertakan pembaruan prarilis, periksa opsi "Sertakan prarilis". Untuk mempelajari selengkapnya tentang apa yang disertakan dalam pembaruan, lihat catatan rilis.)
  • Klik tombol Perbarui , lalu klik Terapkan dalam dialog Pratinjau perubahan, lalu terima ketentuan lisensi untuk menyelesaikan penginstalan pembaruan.

Cuplikan layar manajer paket NuGet di Visual Studio memperlihatkan pembaruan paket SDK Aplikasi Windows.

Sekarang proyek Anda menggunakan fitur WinUI terbaru yang tersedia, dan siap bagi Anda untuk membuatnya sendiri.

Langkah berikutnya