Dalam tutorial ini, Anda akan mempelajari cara membuat dan menjalankan aplikasi .NET Multi-platform App UI (.NET MAUI) pertama Anda di Visual Studio 2022 di Windows atau Visual Studio Code di Windows, macOS, atau Linux. Ini akan membantu memastikan bahwa lingkungan pengembangan Anda disiapkan dengan benar.
Visual Studio 2022 17.12 atau yang lebih tinggi, dengan beban kerja UI Aplikasi Multi-platform .NET terinstal. Untuk informasi selengkapnya, lihat instalasi.
Membuat aplikasi
Dalam tutorial ini, Anda akan membuat aplikasi MAUI .NET pertama Anda di Visual Studio 2022 dan menjalankannya di emulator Android:
Mengembangkan aplikasi .NET MAUI untuk iOS di Windows memerlukan host build Mac. Jika Anda tidak secara khusus perlu menargetkan iOS dan tidak memiliki Mac, pertimbangkan untuk mulai menggunakan Android atau Windows sebagai gantinya.
Dalam tutorial ini, Anda akan membuat aplikasi MAUI .NET pertama Anda di Visual Studio dan menjalankannya di simulator iOS:
Dalam tutorial ini, Anda akan membuat aplikasi MAUI .NET pertama Anda di Visual Studio 2022 dan menjalankannya di Windows:
Luncurkan Visual Studio 2022. Di jendela mulai, klik Buat proyek baru untuk membuat proyek baru:
Di jendela Buat proyek baru, pilih MAUI di menu drop-down Semua jenis proyek, pilih templat Aplikasi .NET MAUI, dan klik tombol Berikutnya :
Di jendela Konfigurasikan proyek baru Anda, beri nama proyek Anda, pilih lokasi yang sesuai untuk proyek tersebut, dan klik tombol Berikutnya :
Di jendela Informasi tambahan, pilih versi .NET yang ingin Anda targetkan dan klik tombol Buat :
Tunggu hingga proyek dibuat dan dependensinya dipulihkan:
Di toolbar Visual Studio, gunakan menu drop-down Target Debug untuk memilih Emulator Android lalu entri Android Emulator :
Di toolbar Visual Studio, tekan tombol Android Emulator :
Visual Studio akan memulai proses penginstalan Android SDK dan Android Emulator default.
Di jendela Android SDK - Perjanjian Lisensi, tekan tombol Terima :
Dalam dialog Kontrol Akun Pengguna, tekan tombol Ya:
Tunggu hingga Visual Studio mengunduh Android SDK dan Android Emulator default.
Dalam dialog Kontrol Akun Pengguna, tekan tombol Ya:
Dalam dialog Platform Android SDK hilang, tekan tombol Instal:
Di jendela Android SDK - Perjanjian Lisensi, tekan tombol Terima :
Tunggu hingga Visual Studio menginstal komponen Android SDK.
Di jendela Perangkat Baru, tekan tombol Buat :
Tunggu hingga Visual Studio mengunduh, membuka zip, dan membuat emulator Android.
Tutup jendela Android Device Manager :
Di toolbar Visual Studio, tekan tombol Pixel 7 - API 35 (Android 15.0 - API 35):
Di jendela Android SDK - Perjanjian Lisensi, tekan tombol Terima :
Dalam dialog Kontrol Akun Pengguna, tekan tombol Ya:
Tunggu hingga Visual Studio diinstal untuk mengunduh Android SDK.
Di toolbar Visual Studio, tekan tombol Pixel 7 - API 35 (Android 15.0 - API 35) untuk membuat dan menjalankan aplikasi:
Visual Studio akan memulai emulator Android, membangun aplikasi, dan menyebarkan aplikasi ke emulator.
Di aplikasi yang sedang berjalan di emulator Android, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah.
Pemecahan Masalah
Jika aplikasi Anda gagal dikompilasi, tinjau Pemecahan masalah yang diketahui, yang mungkin memiliki solusi untuk masalah Anda. Jika masalah terkait dengan emulator Android, lihat Pemecahan masalah emulator Android.
Di toolbar Visual Studio, tekan tombol Windows Machine untuk membuat dan menjalankan aplikasi:
Di aplikasi yang sedang berjalan, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah:
Di toolbar Visual Studio, gunakan drop-down Target Debug untuk memilih Simulator iOS lalu simulator iOS tertentu:
Di toolbar Visual Studio, tekan tombol Mulai untuk simulator iOS yang Anda pilih untuk membuat dan menjalankan aplikasi Anda:
Visual Studio akan membangun aplikasi, memulai Simulator iOS jarak jauh untuk Windows, dan menyebarkan aplikasi ke simulator jarak jauh. Untuk informasi selengkapnya tentang Simulator iOS jarak jauh untuk Windows, lihat Simulator iOS Jarak Jauh untuk Windows.
Di aplikasi yang sedang berjalan, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah.
Dalam tutorial ini, Anda akan membuat aplikasi MAUI .NET pertama Anda di Visual Studio Code dan menjalankannya di emulator Android:
Dalam tutorial ini, Anda akan membuat aplikasi .NET MAUI pertama Anda di Visual Studio Code di Mac, dan menjalankannya pada simulator iOS:
Dalam tutorial ini, Anda akan membuat aplikasi .NET MAUI pertama Anda di Visual Studio Code di Mac, dan menjalankannya di macOS:
Dalam tutorial ini, Anda akan membuat aplikasi MAUI .NET pertama Anda di Visual Studio Code di Windows, dan menjalankannya di Windows:
Luncurkan Visual Studio Code. DiExplorer, tekan Buat Proyek .NET:
Atau, tekan CTRL+SHIFT+P di Windows, atau CMD+SHIFT+P di macOS, lalu perintah .NET: Proyek Baru....
Di palet perintah, pilih templat Aplikasi .NET MAUI:
Dalam dialog Lokasi Proyek , pilih lokasi tempat Anda ingin membuat proyek baru.
Penting
Proyek harus dibuat dalam folder kosong.
Di palet perintah, masukkan nama untuk proyek baru Anda dan tekan ENTER:
Di palet perintah, tekan Buat proyek:
Tunggu hingga proyek dibuat, menerima folder sebagai lokasi tepercaya jika diperlukan.
DiExplorer , perluas simpul akar proyek Anda lalu buka file C# seperti MainPage.xaml.cs:
Di Visual Studio Code, verifikasi bahwa lingkungan Android Anda dikonfigurasi dengan benar dengan menekan CTRL+SHIFT+P di Windows, atau CMD+SHIFT+P di macOS, lalu memilih .NET MAUI: Mengonfigurasi Android, diikuti dengan Refresh lingkungan Android. Setiap kesalahan yang terdeteksi harus diatasi.
Di bilah status di bagian bawah Visual Studio Code, tekan simbol kurung kurawal { } dan pastikan bahwa Target Debug diatur ke emulator Android tertentu:
Anda juga dapat mengatur target debug dengan menekan CTRL+SHIFT+P di Windows, atau CMD+SHIFT+P di macOS, dan memilih .NET MAUI: Pilih Perangkat Android dari palet perintah.
Buat dan jalankan aplikasi di Android dengan menekan F5 atau dengan menekan tombol Jalankan di sudut kanan atas Visual Studio Code:
Jika Anda diminta untuk memilih debugger di palet perintah, pilih C# lalu konfigurasi peluncuran untuk proyek Anda.
Di aplikasi yang sedang berjalan di emulator Android pilihan Anda, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah:
Colokkan perangkat Anda ke komputer Anda dan pilih sebagai target debug di Visual Studio Code.
Jalankan aplikasi.
Di Visual Studio Code, verifikasi bahwa lingkungan Apple Anda dikonfigurasi dengan benar dengan menekan CMD+SHIFT+P lalu memilih .NET MAUI: Mengonfigurasi Apple, diikuti dengan Refresh lingkungan Apple. Setiap kesalahan yang terdeteksi harus diatasi.
Di bilah status di bagian bawah Visual Studio Code, tekan simbol kurung kurawal { } dan pastikan bahwa Target Debug diatur ke simulator iOS tertentu:
Anda juga dapat mengatur target debug dengan menekan CMD+SHIFT+P dan memilih .NET MAUI: Pilih perangkat iOS dari palet perintah.
Buat dan jalankan aplikasi di iOS dengan menekan F5 atau dengan menekan tombol Jalankan di sudut kanan atas Visual Studio Code:
Jika Anda diminta untuk memilih debugger di palet perintah, pilih C# lalu konfigurasi peluncuran untuk proyek Anda.
Di aplikasi yang sedang berjalan di simulator iOS yang Anda pilih, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah:
Men-debug aplikasi di perangkat iOS
Untuk men-debug aplikasi di perangkat iOS:
Pastikan Anda telah menambahkan ID Apple ke Xcode di Pengaturan > Xcode > Akun.
Pastikan perangkat Anda telah terdaftar di tim Anda, jika Anda termasuk dalam Program Pengembang Apple.
Aktifkan Mode Pengembang di perangkat Anda. Saat pertama kali menjalankan aplikasi, Anda mungkin menerima pop-up di perangkat - pastikan Anda memilih Izinkan. Untuk informasi selengkapnya tentang Mode Pengembang, lihat Mengaktifkan Mode Pengembang pada perangkat di developer.apple.com.
Colokkan perangkat Anda ke komputer Anda dan pilih sebagai target debug di Visual Studio Code.
Jalankan aplikasi.
Di Visual Studio Code, verifikasi bahwa lingkungan Apple Anda dikonfigurasi dengan benar dengan menekan CMD+SHIFT+P lalu memilih .NET MAUI: Mengonfigurasi Apple, diikuti dengan Refresh lingkungan Apple. Setiap kesalahan yang terdeteksi harus diatasi.
Di bilah status di bagian bawah Visual Studio Code, tekan simbol kurung kurawal { } dan pastikan Target Debug diatur ke Mac Anda:
Anda juga dapat mengatur target debug dengan menekan CMD+SHIFT+P dan memilih .NET MAUI: Pilih perangkat macOS dari palet perintah.
Buat dan jalankan aplikasi di macOS dengan menekan F5 atau dengan menekan tombol Jalankan di sudut kanan atas Visual Studio Code:
Jika Anda diminta untuk memilih debugger di palet perintah, pilih C# lalu konfigurasi peluncuran untuk proyek Anda.
Di aplikasi yang sedang berjalan, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah:
Di bilah status di bagian bawah Visual Studio Code, tekan simbol kurung kurawal { } dan pastikan Target Debug diatur ke Windows:
Anda juga dapat mengatur target debug dengan menekan CTRL+SHIFT+P dan memilih .NET MAUI: Pilih Perangkat Windows dari palet perintah.
Buat dan jalankan aplikasi di Windows dengan menekan F5 atau dengan menekan tombol Jalankan di sudut kanan atas Visual Studio Code:
Jika Anda diminta untuk memilih debugger di palet perintah, pilih C# lalu konfigurasi peluncuran untuk proyek Anda.
Di aplikasi yang sedang berjalan, tekan tombol Klik saya beberapa kali dan amati bahwa jumlah klik tombol bertambah:
Pemecahan Masalah
Jika aplikasi Anda gagal untuk dikompilasi dan di-deploy, tinjau Pemecahan masalah yang sudah diketahui, yang mungkin memiliki solusi untuk masalah Anda.
Langkah berikutnya
Dalam tutorial ini, Anda telah mempelajari cara membuat dan menjalankan aplikasi .NET Multi-platform App UI (.NET MAUI) pertama Anda.
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.