Untuk mulai mengembangkan aplikasi .NET MAUI lintas platform asli di Windows, macOS, atau Linux, instal Visual Studio Code terbaru dengan mengikuti langkah instalasi.
Prasyarat
Untuk membangun, menandatangani, dan menyebarkan aplikasi .NET MAUI untuk iOS dan Mac Catalyst, Anda memerlukan:
- Mac yang kompatibel dengan Xcode. Untuk informasi selengkapnya, lihat dokumentasi persyaratan minimum Apple.
- Versi Xcode tertentu, yang bergantung pada versi .NET MAUI yang Anda gunakan. Untuk informasi, lihat Versi rilis.
-
ID Apple dan pendaftaran Program Pengembang Apple berbayar. ID Apple diperlukan untuk menyebarkan app ke perangkat, dan mengirimkan app ke Apple Store.
Menginstal Visual Studio Code
Untuk membuat aplikasi .NET MAUI, Anda harus mengunduh versi terbaru Visual Studio Code:
Instal Visual Studio Code. Untuk petunjuk terperinci tentang cara menginstal Visual Studio Code, lihat Visual Studio Code di Windows, Visual Studio Code di macOS, dan Visual Studio Code di Linux.
Menginstal ekstensi .NET MAUI
Sebelum dapat membuat aplikasi .NET MAUI di Visual Studio Code, Anda harus menginstal ekstensi .NET MAUI:
Luncurkan Visual Studio Code.
Di Visual Studio Code, buka tab Ekstensi dan cari ".NET MAUI". Kemudian pilih ekstensi .NET MAUI dan instal dengan menekan tombol Instal:
Ekstensi .NET MAUI secara otomatis menginstal ekstensi C# Dev Kit dan C# , yang diperlukan agar ekstensi .NET MAUI berjalan. Untuk informasi selengkapnya tentang C# Dev Kit, lihat C# Dev Kit untuk Visual Studio Code.
Hubungkan akun Anda ke C# Dev Kit
Menggunakan C# Dev Kit mengharuskan Anda masuk dengan akun Microsoft yang memiliki langganan Visual Studio aktif:
Di tab Selamat Datang untuk memulai dengan .NET MAUI, tekan tombol Sambungkan:
Ikuti perintah untuk masuk ke akun Microsoft Anda. Untuk informasi lebih lanjut, lihat Masuk ke C# Dev Kit.
Untuk informasi selengkapnya tentang lisensi C# Dev Kit, lihat tanya jawab umum C# Dev Kit.
Menyiapkan lingkungan .NET Anda
Anda akan memerlukan .NET SDK yang diinstal pada komputer Anda untuk mengembangkan aplikasi MAUI .NET. Jika Anda tidak menginstal .NET SDK di komputer Anda, pendekatan yang disukai untuk menginstalnya di Windows adalah melalui Alat Penginstal Visual Studio. Untuk informasi selengkapnya, lihat Penginstalan.
Atau, untuk menginstal .NET SDK secara manual:
Unduh penginstal .NET .
Instal .NET SDK dengan menjalankan penginstal .NET. Untuk informasi selengkapnya, lihat Menginstal .NET di Windows, Linux, dan macOS.
Saran
Di Linux, Anda dapat menginstal .NET SDK menggunakan instruksi penginstalan skrip .
Untuk memverifikasi bahwa .NET SDK diinstal:
Buka terminal.
Di terminal, jalankan perintah berikut:
dotnet --version
Anda akan melihat versi .NET SDK yang telah Anda instal.
Catatan
Mungkin perlu untuk menghidupkan ulang komputer Anda sebelum memverifikasi bahwa .NET SDK diinstal.
Menyiapkan lingkungan .NET MAUI Anda
Anda akan memerlukan .NET MAUI SDK yang diinstal pada komputer Anda untuk mengembangkan aplikasi .NET MAUI. Jika Anda tidak menginstal .NET MAUI SDK di komputer Anda, pendekatan yang disukai untuk menginstalnya di Windows adalah melalui Penginstal Visual Studio. Untuk informasi selengkapnya, lihat Penginstalan.
Atau, untuk menginstal .NET MAUI SDK secara manual:
Buka terminal.
Di terminal di Windows, jalankan perintah berikut:
dotnet workload install maui
Di terminal di macOS, jalankan perintah berikut:
sudo dotnet workload install maui
Di terminal di Linux, jalankan perintah berikut:
dotnet workload install maui-android
Untuk memverifikasi bahwa .NET MAUI SDK diinstal:
Buka terminal.
Di terminal, jalankan perintah berikut:
dotnet workload list
Di Windows dan macOS, Anda akan melihat workload ID maui tercantum bersama versi yang diinstal. Namun, jika Anda telah menginstalnya melalui Penginstal Visual Studio di Windows, ID beban kerja berikut dicantumkan:
android
maui-windows
maccatalyst
ios
Di Linux, Anda akan melihat ID beban kerja maui-android terdaftar bersama dengan versi yang diinstal.
Untuk membangun dan men-debug aplikasi .NET MAUI, Anda harus memiliki platform target yang valid relatif terhadap sistem operasi komputer pengembangan Anda. Tabel berikut mencantumkan platform target yang didukung pada setiap sistem operasi:
| Sistem Operasi Anda |
Platform Target yang Didukung |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
Membuat aplikasi .NET MAUI untuk Android, dan untuk platform Apple, mengharuskan Anda untuk melakukan pengaturan dan konfigurasi tambahan.
Android
Untuk memproses menyiapkan komputer Anda untuk pengembangan .NET MAUI di Android dengan Visual Studio Code adalah:
Mengunduh dan menginstal Java SDK
Untuk mengunduh dan menginstal Java SDK, dan mengonfigurasi Visual Studio Code untuk menggunakannya:
Unduh dan instal Microsoft OpenJDK 17. Untuk informasi tentang menginstal OpenJDK, lihat Menginstal Microsoft Build OpenJDK.
Atau, daripada mengunduh dan menginstal Java SDK secara manual, Anda dapat menggunakan target build InstallAndroidDependencies untuk menginstal Java SDK (dan Android SDK). Untuk informasi selengkapnya, lihat Menggunakan target InstallAndroidDependencies.
Penting
Pastikan Anda mencatat lokasi tempat OpenJDK diinstal, karena ini diperlukan pada langkah berikutnya.
Pastikan Anda telah mengonfigurasi jalur ke OpenJDK melalui salah satu pendekatan berikut:
Atur variabel lingkungan JAVA_HOME untuk menentukan jalur Java SDK untuk komputer Anda. Ini adalah pendekatan yang direkomendasikan, yang mendefinisikan jalur Java SDK di tingkat komputer.
Catatan
Jika Anda menginstal OpenJDK di Windows melalui MSI, Anda dapat memilih untuk mengaktifkan pengaturan penginstal variabel lingkungan JAVA_HOME.
Di Visual Studio Code, tekan CTRL+SHIFT+P di Windows, atau CMD+SHIFT+P di macOS, lalu pilih .NET MAUI: Konfigurasikan Android, diikuti dengan Pilih lokasi Java SDK untuk mengatur jalur Java SDK di tingkat pengguna/ruang kerja.
Konfigurasikan jalur Java SDK di file .csproj Anda dengan mengatur properti $(JavaSdkDirectory) MSBuild ke jalur OpenJDK. Ini akan menentukan jalur Java SDK di tingkat proyek.
Mengunduh dan menginstal Android SDK
Untuk mengunduh dan menginstal Android SDK, dan mengonfigurasi Visual Studio Code untuk menggunakannya:
Unduh dan instal Android SDK melalui salah satu pendekatan berikut:
- Unduh dan instal Android SDK dengan membuat proyek MAUI .NET baru lalu gunakan target build
InstallAndroidDependencies, yang membantu menyiapkan lingkungan Android Anda. Ini adalah pendekatan yang direkomendasikan. Untuk informasi selengkapnya, lihat Menggunakan target InstallAndroidDependencies.
- Unduh dan instal Android SDK di Windows dengan menginstal beban kerja pengembangan .NET MAUI di Visual Studio, lalu membuat dan menjalankan aplikasi .NET MAUI di Android. Proses ini akan memastikan bahwa Android SDK dan emulator Android diinstal.
- Unduh dan instal Android SDK melalui Android Studio. Untuk informasi selengkapnya, lihat Menginstal Android Studio di developer.android.com.
- Unduh dan instal Android SDK melalui manajer paket pilihan Anda di Linux.
Pastikan Anda telah mengonfigurasi jalur ke Android SDK melalui salah satu pendekatan berikut:
- Atur variabel lingkungan
ANDROID_HOME untuk menentukan jalur Android SDK untuk komputer Anda. Ini adalah pendekatan yang direkomendasikan, yang mendefinisikan jalur Android SDK di tingkat komputer.
- Di Visual Studio Code, tekan CTRL+SHIFT+P di Windows, atau CMD+SHIFT+P di macOS, lalu pilih .NET MAUI: Konfigurasikan Android, diikuti dengan Pilih lokasi Android SDK untuk mengatur jalur Android SDK di tingkat pengguna/ruang kerja.
- Konfigurasikan jalur Android SDK di file .csproj Anda dengan mengatur properti
$(AndroidSdkDirectory) MSBuild ke jalur Android SDK. Ini akan menentukan jalur Android SDK di tingkat proyek.
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 palet perintah, pilih .NET MAUI: Konfigurasikan Android diikuti oleh Pilih lokasi Android SDK dan Pilih lokasi Android SDK dan validasi bahwa lokasi tersebut mengarah ke penginstalan masing-masing dengan benar. Di Windows, jika Anda menginstal SDK melalui Visual Studio, OpenJDK akan terletak di C:\Program Files\Microsoft dan Android SDK akan terletak di C:\Program Files (x86)\Android\android-sdk.
- Pastikan folder Android SDK Anda memiliki sub-folder seperti build-tools, cmdline-tools, dan platform-tools.
- Pastikan folder OpenJDK Anda memiliki sub-folder seperti bin, lib, dan banyak lagi.
- Pastikan variabel lingkungan
ANDROID_HOME diatur ke jalur Android SDK Anda.
- Pastikan variabel lingkungan
JAVA_HOME diatur ke jalur Java SDK Anda.
- Jika lisensi Android belum diterima, di terminal dengan hak akses admin, navigasikan ke folder cmdline-tools/{version}/bin Android SDK Anda dan jalankan
sdkmanager --licenses dan ikuti petunjuk CLI.
Menggunakan target InstallAndroidDependencies
Pendekatan yang disarankan untuk menginstal dependensi yang diperlukan untuk proyek .NET MAUI Anda di Android adalah dengan menjalankan InstallAndroidDependencies target MSBuild. Target ini akan menginstal Android SDK untuk Anda, jika belum diinstal.
Di terminal, buat proyek MAUI .NET baru:
dotnet new maui -n "MyMauiApp"
Di terminal, ubah direktori ke MyMauiApp, dan buat aplikasi sambil menentukan target build InstallAndroidDependencies:
cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Catatan
Target InstallAndroidDependencies MSBuild juga dapat menginstal Java SDK jika properti JavaSdkDirectory MSBuild disediakan.
Pada perintah di atas:
-
-p:AndroidSdkDirectory="/path/to/sdk" melakukan instalasi atau pembaruan dependensi Android ke jalur absolut tertentu. Jalur yang disarankan %LOCALAPPDATA% /Android/Sdk di Windows, dan $HOME/Library/Android/sdk di macOS.
-
-p:AcceptAndroidSDKLicenses=True menerima lisensi Android yang diperlukan untuk pengembangan.
- (opsional)
-p:JavaSdkDirectory="/path/to/sdk" menginstal Java SDK ke jalur absolut yang ditentukan.
Cobalah untuk menghindari penggunaan jalur yang berisi spasi atau karakter non-ASCII.
Mengunduh dan menginstal emulator Android
Untuk mengunduh dan menginstal emulator Android untuk menjalankan aplikasi Anda:
Di terminal, navigasikan ke {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.
Di terminal, gunakan perintah sdkmanager untuk mengunduh dan menginstal emulator Android:
Di Windows, jalankan perintah berikut:
sdkmanager --install emulator
sdkmanager --install "system-images;android-35;google_apis;x86_64"
Di macOS, jalankan perintah berikut:
./sdkmanager --install emulator
./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
Catatan
Perintah di atas mengasumsikan Apple Silicon Mac. Untuk Intel Mac, ganti arm64-v8a dengan x86_64.
Untuk informasi selengkapnya tentang perintah , lihat sdkmanager di developer.android.com.
Di terminal, gunakan perintah avdmanager untuk membuat emulator Android baru:
Di Windows, jalankan perintah berikut:
avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
Di macOS, jalankan perintah berikut:
./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
Catatan
Perintah di atas mengasumsikan Apple Silicon Mac. Untuk Intel Mac, ganti arm64-v8a dengan x86_64.
Untuk informasi selengkapnya tentang perintah , lihat avdmanager di developer.android.com.
iOS dan macOS
Untuk menyiapkan Mac Anda untuk pengembangan .NET MAUI di iOS dan Mac Catalyst dengan Visual Studio Code:
Instal versi Xcode yang diperlukan oleh versi .NET MAUI yang Anda gunakan. Untuk informasi, lihat Versi rilis. Rilis Xcode stabil terbaru dapat diunduh dari Apple App Store.
Di terminal, jalankan perintah berikut untuk memperoleh alat baris perintah Xcode:
xcode-select --install
Luncurkan Xcode dan terima perjanjian lisensi apa pun. Jika simulator tidak mulai menginstal, navigasikan ke Xcode > Pengaturan > Komponen dan instal runtime simulator yang Anda pilih.
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:
- Pastikan Anda telah menjalankan
xcode-select --install di terminal.
- Jika Anda menerima kesalahan bahwa Xcode belum ditemukan, jalankan
xcode-select -p di terminal dan periksa apakah Xcode mengembalikan jalur ke penginstalan Xcode Anda.
- Buka Xcode untuk memastikannya dimuat dengan benar, lalu navigasi ke Pengaturan Xcode Lokasi dan periksa apakah bidang Alat Baris Perintah menunjuk ke penginstalan Xcode yang benar.
Pemecahan Masalah
Jika Anda mengalami masalah saat menginstal ekstensi .NET MAUI di Visual Studio Code, informasi selengkapnya tentang masalah dapat ditemukan dengan menavigasi ke jendela Output ( CTRL+SHIFT+U di Windows atau CMD+SHIFT+U di macOS) dan memilih .NET MAUI di menu drop-down.
Memberikan tanggapan
Untuk memberikan umpan balik tentang ekstensi .NET MAUI dari dalam Visual Studio Code, navigasikan ke dialog Bantuan Melaporkan Masalah. Kemudian, pastikan Anda memilih "Laporan Bug" sebagai nilai untuk drop-down, "Ekstensi VS Code" sebagai nilai drop-down untuk, dan ".NET MAUI" sebagai nilai drop-down untuk Extension:
