Untuk mulai mengembangkan aplikasi .NET MAUI lintas platform asli di Windows, instal Visual Studio 2022 17.8 atau yang lebih baru dengan mengikuti langkah-langkah penginstalan .
Prasyarat
- Visual Studio 2022 17.8 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, 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:
Penginstalan
Untuk membuat aplikasi .NET MAUI, Anda memerlukan versi terbaru Visual Studio 2022:
Instal Visual Studio, atau ubah penginstalan yang ada, dan instal beban kerja pengembangan UI Aplikasi Multi-platform .NET dengan opsi penginstalan opsional defaultnya:
Catatan
Visual Studio untuk Mac dijadwalkan untuk dihentikan pada 31 Agustus 2024 sesuai dengan Kebijakan Siklus Hidup Modern Microsoft. Visual Studio untuk Mac 17.6 akan terus didukung hingga 31 Agustus 2024, dengan pembaruan layanan untuk masalah keamanan dan platform yang diperbarui dari Apple. Untuk informasi selengkapnya, termasuk opsi alternatif untuk mengembangkan di Mac, lihat Apa yang terjadi pada Visual Studio untuk Mac?.
Untuk mulai mengembangkan aplikasi .NET MAUI lintas platform asli di macOS, instal Visual Studio 2022 untuk Mac 17.6 dengan mengikuti langkah-langkah penginstalan .
Prasyarat
- Visual Studio 2022 untuk Mac 17.6. Untuk informasi tentang sistem operasi yang didukung, perangkat keras, bahasa yang didukung, serta persyaratan dan panduan tambahan, lihat Persyaratan Sistem Visual Studio 2022 untuk Mac.
Untuk membangun, menandatangani, dan menyebarkan aplikasi .NET MAUI untuk iOS atau macOS, 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.
Penginstalan
Untuk membuat aplikasi .NET MAUI, Anda memerlukan Visual Studio untuk Mac terbaru:
Instal Visual Studio 2022 untuk Mac, atau ubah penginstalan yang ada, dan pastikan bahwa beban kerja berikut diinstal:
- .NET
- .NET MAUI
- Android
- iOS
Penting
Untuk penginstalan baru Visual Studio 2022 untuk Mac, memilih beban kerja .NET MAUI akan secara otomatis memilih beban kerja Android dan iOS, yang saat ini diperlukan untuk pengembangan .NET MAUI.
Instal .NET 8 melalui alat penginstal mandiri.
Setelah .NET 8 selesai menginstal, jalankan dotnet workload install maui
di terminal.
Penting
Untuk menggunakan Visual Studio untuk Mac dengan .NET 8, aktifkan kotak centang Preferensi > Visual Studio > Fitur > Pratinjau Lainnya > Gunakan .NET 8 SDK jika diinstal (memerlukan hidupkan ulang).
Jika Anda mengalami masalah jaringan saat menginstal di lingkungan perusahaan, tinjau penginstalan di balik firewall atau instruksi proksi.
Penginstalan di belakang firewall atau server proksi
Untuk menginstal Visual Studio 2022 untuk Mac di belakang firewall, titik akhir tertentu harus dapat diakses untuk memungkinkan unduhan alat dan pembaruan yang diperlukan untuk perangkat lunak Anda. Untuk informasi selengkapnya tentang mengonfigurasi jaringan Anda untuk mengizinkan akses ke titik akhir yang diperlukan, lihat Menginstal dan menggunakan Visual Studio untuk Mac di belakang firewall atau server proksi.
Catatan
Dukungan .NET MAUI di Visual Studio Code masih dalam pratinjau. Cobalah dan bagikan umpan balik Anda!
Instal Visual Studio Code dan ekstensi .NET MAUI
Instal Visual Studio Code.
Di tab Ekstensi, cari ".NET MAUI" dan instal ekstensi .NET MAUI. Ekstensi .NET MAUI secara otomatis menginstal ekstensi C# Dev Kit dan C# , yang diperlukan agar ekstensi .NET MAUI berjalan.
Catatan
Ekstensi .NET MAUI memerlukan ekstensi C# Dev Kit dan prarilis C#. Anda harus masuk ke C# Dev Kit untuk menggunakan fungsionalitas ekstensi .NET MAUI. Lihat posting blog ini untuk informasi selengkapnya tentang C# Dev Kit dan keluarga ekstensinya.
Menginstal beban kerja .NET dan .NET MAUI
Instal .NET 8.
Di Windows, disarankan untuk menggunakan alat penginstal Visual Studio untuk mengelola penginstalan beban kerja .NET dan .NET MAUI. Petunjuk tentang menggunakan alat penginstal Visual Studio dapat ditemukan di sini.
Instal beban kerja .NET MAUI.
Di Windows dan macOS, jalankan perintah berikut di terminal:
dotnet workload install maui
Di Linux, jalankan perintah berikut di terminal:
dotnet workload install maui-android
Untuk men-debug aplikasi .NET MAUI di Visual Studio Code, Anda harus memiliki platform target yang valid untuk sistem operasi komputer pengembangan Anda:
Sistem Operasi Anda |
Platform Target yang Didukung |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS dan macOS
Untuk men-debug ke target iOS atau macOS di 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 Mac App Store.
- Jalankan
xcode-select --install
di terminal untuk memperoleh alat baris perintah Xcode.
Android
Untuk men-debug ke target Android di Visual Studio Code:
- Instal Microsoft OpenJDK 17.
- Instal Android SDK melalui salah satu pendekatan berikut:
- (Disarankan) Buat proyek .NET MAUI baru (
dotnet new maui
) dan gunakan target InstallAndroidDependencies.
- Instal melalui Visual Studio (hanya Windows).
- Instal melalui Android Studio.
- Instal melalui manajer paket pilihan Anda di Linux.
Pemecahan Masalah
Anda mungkin menghadapi masalah saat menyiapkan ekstensi .NET MAUI untuk Visual Studio Code. Jika Anda masih menghadapi masalah setelah mengikuti langkah-langkah pemecahan masalah di bawah ini, silakan laporkan masalah.
Pembuatan proyek
Jika Anda mencoba membuat proyek baru dan penjelajah file terus muncul dalam perulangan tak terbatas, Anda mungkin tidak memilih folder kosong. Periksa apakah tidak ada file atau folder tersembunyi, buat folder baru, atau buat aplikasi .NET MAUI Anda dari baris perintah menggunakan dotnet new maui
.
Menggunakan target InstallAndroidDependencies
.NET 8 memiliki target build yang membantu menyiapkan lingkungan Android untuk Anda. Jalankan perintah berikut di terminal untuk mengonfigurasi komputer Anda dan menyiapkan lingkungan Android Anda:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Pada perintah di atas:
AndroidSdkDirectory="<AndroidSdkPath>"
: menginstal atau memperbarui dependensi Android ke jalur absolut yang ditentukan.
- Windows: AndroidSdkPath yang disarankan adalah
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: AndroidSdkPath yang disarankan adalah
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: menginstal Java ke jalur absolut yang ditentukan.
AcceptAndroidSDKLicenses=True
: menerima lisensi Android yang diperlukan untuk pengembangan.
Ada kesalahan bahwa Android SDK atau Java SDK tidak ditemukan
- Buka palet perintah (Ctrl/Cmd + Shift + P) dan cari
.NET MAUI: Configure Android
perintah . Pilih "Atur jalur Android SDK" dan "Atur jalur Android JDK" dan validasi bahwa mereka menunjuk ke penginstalan masing-masing.
- Folder Android SDK harus memiliki sub-folder seperti
build-tools
, , cmdline-tools
dan platform-tools
.
- Folder Java OpenJDK harus memiliki sub-folder seperti
bin
, , lib
dan banyak lagi.
- Di Windows, jika Anda menginstal melalui Visual Studio, Java SDK akan berada di
C:\Program Files\Microsoft\
dan Android SDK akan berada di C:\Program Files (x86)\Android\android-sdk
.
- Atur
JAVA_HOME
variabel lingkungan ke jalur Java OpenJDK yang valid.
- Atur
ANDROID_HOME
variabel lingkungan ke jalur Android SDK Anda.
- Periksa versi minimum dependensi Android yang diinstal:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Platform; android-34*
- .NET 7: platform-tools = 33.0.2
- .NET 8: platform-tools = 34.0.5
Ada kesalahan bahwa lisensi Android tidak diterima
Di prompt perintah atau terminal yang ditinggikan , navigasikan ke folder Android SDK cmdline-tools/latest/bin/
Anda dan jalankan sdkmanager --licenses
lalu ikuti perintah CLI.
Dependensi Android saya tidak dimuat di Penjelajah Solusi, tetapi aplikasi saya berfungsi dengan baik
Ini adalah masalah yang diketahui jika Anda menginstal pada %APPDATA%
Windows dan akan diperbaiki dalam rilis mendatang.
Penyiapan iOS/Xcode
- Jika Anda mendapatkan kesalahan bahwa Xcode tidak ditemukan, jalankan
xcode-select --install
di terminal, lalu periksa titik tersebut xcode-select -p
ke penginstalan Xcode Anda.
- Jika Anda masih menghadapi masalah, buka Xcode itu sendiri untuk memastikannya dimuat dengan benar. Setelah Xcode terbuka, navigasikan ke Xcode > Pengaturan > Lokasi dan periksa apakah bidang Alat Baris Perintah menunjuk ke Xcode yang benar.
- Ada masalah umum yang terkadang Anda harus membangun aplikasi iOS/macOS dua kali agar dapat disebarkan. Ini akan diperbaiki dalam rilis mendatang.
Masalah penelusuran kesalahan
- Penelusuran kesalahan dapat gagal dimulai karena beberapa alasan. Jika tidak ada kesalahan yang jelas di jendela Output, pertama-tama periksa apakah Anda menggunakan konfigurasi jalankan ".NET MAUI" di Visual Studio Code.
- Anda dapat mencoba build baris perintah dari terminal untuk melihat apakah kesalahan ada pada kode Anda atau ekstensi .NET MAUI. Misalnya, Anda dapat menjalankan
dotnet build -f:net8.0-android
untuk melihat apakah build Android Berhasil di luar Visual Studio Code. Jika build ini berhasil, silakan Laporkan Masalah
Batasan Umum
Ekstensi ini masih dalam pratinjau awal, jadi ada sejumlah batasan yang diketahui. Beri kami umpan balik Anda tentang fitur lain yang ingin Anda lihat saat kami terus membangun pengalaman baru ini.
- Kemampuan pengeditan XAML sangat ringan - Anda mendapatkan penyorotan sintaks dasar dan lengkapi otomatis. Kami sedang mengeksplorasi cara meningkatkan pengalaman XAML dalam rilis mendatang.
- Saat ini, Anda tidak dapat mengalihkan kerangka kerja target untuk IntelliSense (ini akan menampilkan penyorotan sintaks hanya untuk kerangka kerja target pertama yang tercantum dalam file .csproj Anda). Kemampuan ini sedang berlangsung.
- XAML dan .NET Hot Reload saat ini tidak didukung.
- Ekstensi ini belum sepenuhnya diuji dengan beta iOS dan Xcode terbaru.
Beri kami umpan balik Anda tentang fitur lain yang ingin Anda lihat saat kami terus membangun pengalaman baru ini!
Berikan Umpan Balik
Silakan baca FAQ C# Dev Kit dan periksa Masalah umum yang ada sebelum mengajukan masalah atau saran baru. Anda dapat mengajukan saran dan masalah dari dalam Visual Studio Code melalui dialog Masalah Laporan Bantuan>. Pastikan Anda memilih "Ekstensi" lalu ekstensi .NET MAUI di menu drop-down.