Bagikan melalui


Tutorial: Membuat aplikasi Universal Windows Platform pertama Anda di Visual Studio dengan XAML dan C#

Dalam tutorial ini, sebagai pengantar lingkungan pengembangan terintegrasi Visual Studio (IDE), Anda membuat aplikasi "Halo Dunia" yang berjalan pada perangkat Windows 10 atau yang lebih baru. Untuk melakukannya, Anda menggunakan templat proyek Universal Windows Platform (UWP), Extensible Application Markup Language (XAML), dan bahasa pemrograman C#.

Nota

Jika Anda senang dengan fungsionalitas Anda saat ini di Universal Windows Platform (UWP), maka tidak perlu memigrasikan jenis proyek Anda ke Windows App SDK. WinUI 2.x, dan Windows SDK, mendukung jenis proyek UWP. Jika Anda ingin memulai dengan WinUI 3 dan Windows App SDK, maka Anda dapat mengikuti langkah-langkah dalam tutorial Windows App SDK.

Dalam tutorial ini, Anda:

  • Membuat proyek
  • Membuat aplikasi
  • Jalankan aplikasi

Prasyarat

Anda memerlukan Visual Studio untuk menyelesaikan tutorial ini. Kunjungi halaman unduhan Visual Studio untuk versi gratis.

Nota

Tutorial ini memerlukan templat proyek Aplikasi Kosong (Universal Windows). Selama penginstalan, pilih beban kerja pengembangan Universal Windows Platform.

Cuplikan layar Alat Penginstal Visual Studio yang memperlihatkan beban kerja pengembangan Universal Windows Platform.

Jika Anda sudah menginstal Visual Studio dan perlu menambahkannya, dari menu, pilih Alat >Dapatkan Alat dan Fitur, atau di jendela Buat proyek baru, pilih tautan Instal lebih banyak alat dan fitur.

Cuplikan layar jendela Buat proyek baru yang memperlihatkan tautan 'Instal lebih banyak alat dan fitur'.

Membuat proyek

Pertama, buat proyek Universal Windows Platform. Jenis proyek dilengkapi dengan semua file templat yang Anda butuhkan, bahkan sebelum Anda menambahkan apa pun!

  1. Buka Visual Studio, dan pada jendela mulai, pilih Buat proyek baru.

  2. Pada layar Buat proyek baru, masukkan Universal Windows di kotak pencarian, pilih templat C# untuk Aplikasi Kosong (Universal Windows), lalu pilih Berikutnya.

    Cuplikan layar kotak dialog 'Buat proyek baru' dengan 'jendela universal' dimasukkan di kotak pencarian, dan templat proyek 'Aplikasi Kosong (Universal Windows)' disorot.

  3. Beri nama proyek, HelloWorld, dan pilih Buat.

    Cuplikan layar kotak dialog 'Konfigurasikan proyek baru Anda' dengan 'HelloWorld' dimasukkan di bidang Nama proyek.

  4. Terima versi Target default dan pengaturan versi Minimum dalam kotak dialog Proyek Universal Windows Platform Baru.

    Cuplikan layar kotak dialog Proyek Platform Windows Universal Baru memperlihatkan versi Target default dan pengaturan versi Minimum.

    Nota

    Jika ini pertama kalinya Anda menggunakan Visual Studio untuk membuat aplikasi UWP, kotak dialog Pengaturan mungkin muncul. Pilih mode Pengembang, lalu pilih Ya.

    Cuplikan layar memperlihatkan kotak dialog Pengaturan UWP dengan opsi untuk mengaktifkan Mode Pengembang.

    Visual Studio menginstal paket Mode Pengembang tambahan untuk Anda. Setelah penginstalan paket selesai, tutup kotak dialog Pengaturan.

  1. Buka Visual Studio, dan pada jendela mulai, pilih Buat proyek baru.

  2. Pada layar Buat proyek baru, masukkan Universal Windows di kotak pencarian, pilih templat C# untuk Aplikasi Kosong (Universal Windows), lalu pilih Berikutnya.

    Cuplikan layar kotak dialog 'Buat proyek baru' dengan 'Universal Windows' dimasukkan di kotak pencarian, dan templat proyek 'Aplikasi Kosong (Universal Windows)' disorot.

  3. Beri nama proyek, HelloWorld, dan pilih Buat.

    Cuplikan layar kotak dialog 'Konfigurasikan proyek baru Anda' dengan 'HelloWorld' dimasukkan di bidang Nama proyek.

  4. Terima pengaturan versi Target default dan versi Minimum dalam kotak dialog Proyek Universal Windows Platform Baru .

    Cuplikan layar kotak dialog Proyek Platform Windows Universal Baru memperlihatkan versi Target default dan pengaturan versi Minimum.

    Nota

    Jika ini pertama kalinya Anda menggunakan Visual Studio untuk membuat aplikasi UWP, kotak dialog Aktifkan Mode Pengembang untuk Windows muncul. Pilih pengaturan bagi pengembang untuk membuka pengaturan . Aktifkan mode Pengembang, lalu pilih Ya.

    Cuplikan layar memperlihatkan kotak dialog Pengaturan UWP dengan opsi untuk mengaktifkan Mode Pengembang.

    Visual Studio menginstal paket Mode Pengembang tambahan untuk Anda. Setelah penginstalan paket selesai, tutup kotak dialog Pengaturan.

Membuat aplikasi

Saatnya untuk mulai mengembangkan. Tambahkan kontrol tombol, tambahkan tindakan ke tombol, lalu mulai aplikasi "Halo Dunia" untuk melihat seperti apa tampilannya.

Menambahkan tombol ke kanvas Desain

  1. Di Penjelajah Solusi, klik dua kali MainPage.xaml untuk membuka tampilan terpisah.

    Cuplikan layar jendela Penjelajah Solusi memperlihatkan properti, referensi, aset, dan file dalam proyek HelloWorld dengan file MainPage.xaml dipilih.

    Ada dua panel: Perancang XAML, yang mencakup kanvas desain, dan Editor XAML, tempat Anda dapat menambahkan atau mengubah kode.

    Cuplikan layar memperlihatkan MainPage.xaml terbuka di Visual Studio IDE dan panel Desainer XAML memperlihatkan permukaan desain kosong dan panel Editor XAML memperlihatkan beberapa kode XAML.

  2. Pilih Toolbox untuk membuka jendela fly-out Toolbox.

    Cuplikan layar memperlihatkan tab untuk jendela fly-out 'Kotak Alat' yang disorot di sisi kiri Panel Perancang XAML.

    Jika Anda tidak melihat opsi Kotak Alat, Anda dapat membukanya dari bilah menu. Untuk melakukannya, pilih Tampilkan>Toolbar. Atau, tekan Ctrl+Alt+X.

  3. Pilih ikon Pin untuk mengaitkan jendela Kotak Alat.

    Cuplikan layar menunjukkan ikon Pin yang disorot di bilah atas jendela Toolbox.

  4. Pilih tombol kontrol lalu seret ke kanvas desain.

    Cuplikan layar memperlihatkan 'Tombol' disorot di jendela Kotak Peralatan dan kontrol Tombol pada kanvas desain.

    Jika Anda melihat kode di Editor XAML, Anda melihat bahwa tombol muncul di sana juga:

    Cuplikan layar memperlihatkan kode untuk Tombol yang baru ditambahkan yang disorot di editor XAML.

  1. Klik dobel pada MainPage.xaml di Penjelajah Solusiuntuk membuka tampilan terpisah.

    Cuplikan layar jendela Penjelajah Solusi memperlihatkan properti, referensi, aset, dan file dalam proyek HelloWorld. File MainPage.xaml dipilih.

    Ada dua panel: Perancang XAML, yang mencakup kanvas desain, dan Editor XAML, tempat Anda dapat menambahkan atau mengubah kode.

    Cuplikan layar memperlihatkan MainPage.xaml terbuka di Visual Studio IDE. Panel Perancang XAML memperlihatkan permukaan desain kosong dan panel Editor XAML memperlihatkan beberapa kode XAML.

  2. Pilih Toolbox untuk membuka jendela pop-up Toolbox.

    Cuplikan layar memperlihatkan tab untuk jendela fly-out 'Kotak Alat' yang disorot di sisi kiri Panel Perancang XAML.

    Jika Anda tidak melihat opsi Kotak Alat, Anda dapat membukanya dari bilah menu. Untuk melakukannya, pilih Tampilkan>Toolbar. Atau, tekan Ctrl+Alt+X.

  3. Pilih ikon Pin untuk menambatkan jendela Kotak Alat.

    Cuplikan layar memperlihatkan ikon Sematkan yang ditegaskan di bilah atas jendela Kotak Perkakas.

  4. Pilih tombol kontrol lalu seret ke kanvas desain.

    Cuplikan layar memperlihatkan 'Tombol' disorot di jendela Kotak Alat dan kontrol Tombol pada kanvas desain.

    Jika Anda melihat kode di Editor XAML, Anda melihat bahwa Tombol juga muncul di sana:

    Cuplikan layar memperlihatkan kode untuk Tombol yang baru ditambahkan yang disorot di editor XAML.

Menambahkan label ke tombol

  1. Di Editor XAML, ubah nilai Button Content dari Tombol menjadi Halo Dunia!

    Cuplikan layar memperlihatkan kode XAML untuk Tombol di editor XAML, dengan properti Konten diubah menjadi Halo Dunia!

  2. Perhatikan bahwa tombol di XAML Designer juga berubah.

    Cuplikan layar memperlihatkan kontrol Tombol pada kanvas Desainer XAML dengan label tombol diubah menjadi Halo Dunia!

  1. Di Editor XAML, ubah nilai Button Content dari Tombol menjadi Hello World!

    Cuplikan layar memperlihatkan kode XAML untuk Tombol di editor XAML dengan nilai properti Konten diubah menjadi 'Halo Dunia!'.

  2. Perhatikan bahwa tombol di XAML Designer juga berubah.

    Cuplikan layar memperlihatkan kontrol Tombol pada kanvas Desainer XAML dengan label tombol diubah menjadi Halo Dunia!

Menambahkan penanganan aktivitas

Penanganan aktivitas terdengar rumit, tetapi hanya nama lain untuk kode yang dipanggil saat peristiwa terjadi. Dalam hal ini, ini menambahkan tindakan ke Halo Dunia! tombol.

  1. Klik dua kali kontrol tombol pada kanvas desain.

  2. Edit kode penanganan aktivitas di MainPage.xaml.cs, halaman code-behind.

    Di sinilah hal-hal menjadi menarik. Pengelola peristiwa default terlihat seperti ini:

    Cuplikan layar memperlihatkan kode C# untuk penanganan aktivitas Button_Click default.

    Ubah, sehingga terlihat seperti ini:

    Cuplikan layar memperlihatkan kode C# untuk penanganan aktivitas Button_Click asinkron baru.

    Berikut adalah kode untuk disalin dan ditempelkan:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
       MediaElement mediaElement = new MediaElement();
       var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
       Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
       mediaElement.SetSource(stream, stream.ContentType);
       mediaElement.Play();
    }
    
  1. Klik dua kali tombol kontrol pada kanvas desain.

  2. Edit kode penanganan aktivitas di MainPage.xaml.cs, halaman code-behind.

    Di sinilah hal-hal menjadi menarik. Penanganan aktivitas default terlihat seperti ini:

    Cuplikan layar memperlihatkan kode C# untuk penanganan aktivitas Button_Click default.

    Ubah, sehingga terlihat seperti ini:

    Cuplikan layar memperlihatkan kode C# untuk penanganan aktivitas Button_Click asinkron baru.

    Berikut adalah kode untuk disalin dan ditempelkan:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
       MediaElement mediaElement = new MediaElement();
       var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
       Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
       mediaElement.SetSource(stream, stream.ContentType);
       mediaElement.Play();
    }
    

Apa yang baru saja kita lakukan?

Kode ini menggunakan beberapa API Windows untuk membuat objek sintesis ucapan lalu memberinya beberapa teks untuk dikatakan. Untuk informasi selengkapnya tentang menggunakan SpeechSynthesis, lihat System.Speech.Synthesis.

Jalankan aplikasi

Saatnya untuk membangun, menyebarkan, dan meluncurkan aplikasi UWP "Halo Dunia" untuk melihat seperti apa tampilan dan suaranya. Begini caranya.

  1. Gunakan tombol Putar untuk memulai aplikasi di komputer lokal. Terdapat teks Komputer Lokal.

    Cuplikan layar memperlihatkan kotak drop-down terbuka di samping tombol Putar dengan 'Komputer Lokal' dipilih.

    Atau, Anda dapat memilih Debug>Mulai Debugging dari bilah menu atau menekan F5 untuk memulai aplikasi Anda.

  2. Tampilan aplikasi Anda muncul segera setelah layar pembuka lenyap. Aplikasi ini akan terlihat mirip dengan ilustrasi ini:

    Cuplikan layar memperlihatkan aplikasi UWP 'Hello World' yang sedang berjalan.

  3. Pilih tombol Hello World.

    Perangkat Windows 10 atau yang lebih baru Anda secara harfiah mengatakan, "Halo, Dunia!"

  4. Untuk menutup aplikasi, pilih tombol Hentikan Debugging di toolbar. Atau, pilih Debug>Hentikan debugging dari bilah menu, atau tekan Shift+F5.

Saatnya untuk membangun, menyebarkan, dan meluncurkan aplikasi UWP "Halo Dunia" untuk melihat seperti apa tampilan dan suaranya. Begini caranya.

  1. Gunakan tombol Putar (memiliki teks Komputer Lokal) untuk memulai aplikasi di komputer lokal.

    Cuplikan layar memperlihatkan kotak drop-down terbuka di samping tombol Putar dengan 'Komputer Lokal' dipilih.

    Atau, Anda dapat memilih Debug>Mulai Debugging dari bilah menu atau menekan F5 untuk memulai aplikasi Anda.

  2. Lihat aplikasi Anda, yang muncul segera setelah layar pembuka menghilang. Aplikasi akan terlihat mirip dengan gambar ini:

    Cuplikan layar memperlihatkan aplikasi UWP 'Hello World' yang sedang berjalan.

  3. Pilih tombol Hello World.

    Perangkat Windows 10 atau yang lebih baru Anda secara harfiah mengatakan, "Halo, Dunia!"

  4. Untuk menutup aplikasi, pilih tombol Hentikan Debug di toolbar. Atau, pilih Debug>Hentikan debugging dari bilah menu, atau tekan Shift+F5.

Langkah berikutnya

Selamat atas penyelesaian tutorial ini! Kami harap Anda mempelajari beberapa dasar tentang UWP dan Ide Visual Studio. Untuk mempelajari lebih lanjut, lanjutkan dengan tutorial berikut: