Penginstalan

Mengembangkan aplikasi .NET Multi-platform App UI (.NET MAUI) lintas platform asli memerlukan Visual Studio 2022 17.12 atau yang lebih tinggi, atau Visual Studio Code terbaru dengan ekstensi .NET MAUI.

Visual Studio

Untuk mulai mengembangkan aplikasi .NET MAUI lintas platform asli di Windows, instal Visual Studio 2022 17.12 atau yang lebih tinggi dengan mengikuti langkah-langkah penginstalan .

Prasyarat

• Visual Studio 2022 17.12 atau lebih tinggi. Untuk informasi tentang sistem operasi yang didukung, perangkat keras, bahasa yang didukung, serta persyaratan dan panduan tambahan, lihat Persyaratan Sistem Visual Studio 2022.

Untuk membangun, menandatangani, dan menyebarkan aplikasi .NET MAUI untuk iOS dan Mac Catalyst, Anda juga 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.

Atau, untuk menyebarkan build debug aplikasi Anda langsung dari Windows ke perangkat iOS Anda dengan hot restart, Anda akan memerlukan:

• Akun Pengembang Apple dan pendaftaran Program Pengembang Apple berbayar.

Penginstalan

1. Untuk membuat aplikasi .NET MAUI, Anda harus mengunduh versi terbaru Visual Studio 2022:

   • Unduh Komunitas Visual Studio 2022

   • Unduh Visual Studio 2022 Professional

   • Unduh Visual Studio 2022 Enterprise

2. Instal Visual Studio, atau ubah penginstalan yang ada melalui alat penginstal Visual Studio, dan instal beban kerja pengembangan UI Aplikasi Multi-platform .NET dengan opsi penginstalan opsional defaultnya:

   

Visual Studio Code

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

1. Untuk membuat aplikasi .NET MAUI, Anda harus mengunduh versi terbaru Visual Studio Code:

   • Unduh Visual Studio Code

2. 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:

1. Luncurkan Visual Studio Code.

2. 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:

1. 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:

1. Unduh penginstal .NET .

2. 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:

1. Buka terminal.

2. 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:

1. Buka terminal.

2. 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:

1. Buka terminal.

2. 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.

Menyiapkan platform target

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:

• Unduh dan instal Java SDK Untuk informasi selengkapnya, lihat Mengunduh dan menginstal Java JDK.
• Unduh dan instal Android SDK. Untuk informasi selengkapnya, lihat Mengunduh dan menginstal Android SDK.
• Unduh dan instal emulator Android. Untuk informasi selengkapnya, lihat Mengunduh dan menginstal emulator Android.

Mengunduh dan menginstal Java SDK

Untuk mengunduh dan menginstal Java SDK, dan mengonfigurasi Visual Studio Code untuk menggunakannya:

1. 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.

2. Pastikan Anda telah mengonfigurasi jalur ke OpenJDK melalui salah satu pendekatan berikut:

   1. 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.

   2. 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.

   3. 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:

1. Unduh dan instal Android SDK melalui salah satu pendekatan berikut:

   1. 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.
   2. 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.
   3. Unduh dan instal Android SDK melalui Android Studio. Untuk informasi selengkapnya, lihat Menginstal Android Studio di developer.android.com.
   4. Unduh dan instal Android SDK melalui manajer paket pilihan Anda di Linux.

2. Pastikan Anda telah mengonfigurasi jalur ke Android SDK melalui salah satu pendekatan berikut:

   1. 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.
   2. 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.
   3. 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.

3. 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 pilih .NET MAUI: Konfigurasikan 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:

1. Di terminal, navigasikan ke {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. 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.

3. 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:

1. 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.

2. Di terminal, jalankan perintah berikut untuk memperoleh alat baris perintah Xcode:

   xcode-select --install
   

3. 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.

4. 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:

Visual Studio Code (Eksperimental)

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.

Untuk mulai mengembangkan aplikasi .NET MAUI lintas platform asli di Windows, macOS, atau Linux, instal Visual Studio Code terbaru dengan mengikuti langkah instalasi.

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

Menginstal Visual Studio Code

1. Untuk membuat aplikasi .NET MAUI, Anda harus mengunduh versi terbaru Visual Studio Code:

   • Unduh Visual Studio Code

2. 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:

1. Luncurkan Visual Studio Code.

2. 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.

Ikuti langkah-langkah dalam panduan

Setelah Anda menginstal ekstensi .NET MAUI, Anda akan disambut oleh panduan .NET MAUI, "Mulai menggunakan .NET MAUI".

Penting

Untuk mengakses pengalaman penyiapan yang ditingkatkan, pengaturan Maui > Configuration: Improved Setup Experienceharus diaktifkan.

Klik dan ikuti perintah di setiap langkah untuk sepenuhnya mengonfigurasi lingkungan .NET MAUI dan platform target Anda:

1. Menyambungkan akun Anda ke ekstensi C# Dev Kit
2. Menyiapkan lingkungan .NET Anda
3. Menyiapkan lingkungan .NET MAUI Anda
4. Menyiapkan lingkungan iOS dan macOS Anda
5. Menyiapkan lingkungan Android Anda

Catatan

Anda harus berada di Mac untuk melihat dan mengikuti langkah Menyiapkan lingkungan iOS dan macOS Anda .

Langkah Siapkan lingkungan Android Anda akan menyiapkan semua yang Anda butuhkan agar berhasil dengan Android sebagai platform target, dan langkah Siapkan lingkungan iOS dan macOS Anda akan menyiapkan semua yang Anda butuhkan agar berhasil dengan iOS dan Mac sebagai platform target.

Panduan ini juga dapat diakses dari palet perintah. Pilih Selamat Datang: Buka Penelusuran... diikuti dengan Mulai menggunakan .NET MAUI.

Akses pengalaman penyiapan yang ditingkatkan

1. Di Visual Studio Code, tekan Ctrl+Shift+P di Windows, atau Cmd+Shift+P di macOS, pilih Preferensi: Buka Pengaturan (UI).

   

2. Arahkan ke Ekstensi > .NET MAUI dan periksa Pengaturan Maui > Configuration: Improved Setup Experience.

   

3. Kembali ke panduan Mulai menggunakan .NET MAUI . Pastikan Anda dapat melihat Menyiapkan lingkungan Android di antara langkah-langkah lain dalam panduan.

   

Hubungkan akun Anda ke C# Dev Kit

Menggunakan C# Dev Kit mengharuskan Anda masuk dengan akun Microsoft yang memiliki langganan Visual Studio aktif:

1. 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:

1. Unduh penginstal .NET .

2. 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:

1. Buka terminal.

2. 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:

1. Buka terminal.

2. 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:

1. Buka terminal.

2. 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.

Menyiapkan lingkungan Android Anda

Untuk menyiapkan lingkungan pengembangan Android, cukup klik tombol Konfigurasikan Lingkungan Android dari langkah Siapkan panduan Lingkungan Android Anda untuk memasukkan alur akuisisi Android lengkap.

Alur akuisisi Android akan menganalisis lingkungan Android Anda dan menawarkan untuk menginstal semua komponen yang hilang:

• Android SDK dan Java SDK: Komponen Android SDK dan Java SDK diperlukan.

  • Alur akuisisi Android akan meminta Anda untuk menginstal komponen-komponen ini secara langsung, atau untuk memilih penginstalan yang sudah ada sebelumnya yang mungkin sudah Anda miliki.

    

  • Untuk mengonfigurasi penginstalan SDK dan JDK Anda lebih lanjut, lihat petunjuk tentang cara menginstal dan mengonfigurasi Android secara manual.

• Emulator Android: Menginstal emulator Android disarankan, dan diperlukan tanpa adanya perangkat fisik.

  • Alur akuisisi Android akan meminta Anda untuk menginstal emulator default secara langsung.

    

  • Untuk mengonfigurasi emulator lebih lanjut, ikuti petunjuk untuk menginstal emulator Android secara manual.

Penting

Lisensi Android harus ditinjau dan diterima secara manual di Terminal. Saat diminta, tinjau setiap lisensi. Untuk menerima, ketik 'y', dan tekan 'Enter'.

Ketika lingkungan Android Anda telah dikonfigurasi dengan benar, Anda akan diberitahukan, "Lingkungan Android Anda untuk .NET MAUI sudah siap!"

Lihat panel Output untuk detail selengkapnya tentang status lingkungan Android Anda.

Menyiapkan lingkungan iOS dan macOS Anda

Untuk menyiapkan Mac Anda untuk pengembangan .NET MAUI di iOS dan Mac Catalyst dengan Visual Studio Code:

1. 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.

2. Di terminal, jalankan perintah berikut untuk memperoleh alat baris perintah Xcode:

   xcode-select --install
   

3. 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.

4. Di Visual Studio Code, verifikasi bahwa lingkungan Xcode Anda dikonfigurasi hanya dengan mengklik Konfigurasikan Lingkungan iOS dan macOS dari langkah panduan Siapkan Lingkungan iOS dan macOS Anda .

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.

Ketika lingkungan Xcode Anda telah dikonfigurasi dengan benar, Anda akan diberi tahu, "Lingkungan iOS dan macOS Anda untuk .NET MAUI sudah siap!"

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:

Langkah berikutnya

Untuk mempelajari cara membuat dan menjalankan aplikasi MAUI .NET pertama Anda di Visual Studio 2022 di Windows, atau Visual Studio Code, klik tombol di bawah ini.

Membangun aplikasi pertama Anda