Menyebarkan dan men-debug aplikasi .NET MAUI Anda di Windows
Anda dapat menggunakan komputer pengembangan Windows lokal untuk menyebarkan dan men-debug aplikasi .NET Multi-platform App UI (.NET MAUI). Artikel ini menjelaskan cara mengonfigurasi Windows untuk men-debug aplikasi .NET MAUI.
Saat men-debug dan menyebarkan proyek MAUI .NET baru ke Windows, perilaku defaultnya adalah menyebarkan aplikasi yang dipaketkan. Untuk informasi tentang aplikasi paket, lihat Aplikasi Windows: pengemasan, penyebaran, dan proses.
Mengonfigurasi Windows untuk penyebaran aplikasi kemasan
Anda harus mengaktifkan Mode Pengembang di Windows agar dapat menyebarkan aplikasi Windows .NET MAUI yang dipaketkan. Windows 10 dan Windows 11 didukung.
Windows 11
Mode Pengembang diaktifkan di aplikasi Pengaturan, di bawah Privasi & keamanan>Untuk pengembang. Untuk mengaktifkan Mode Pengembang di Windows 11:
- Buka Menu Mulai.
- Ketik pengaturan Pengembang di kotak pencarian dan pilih.
- Aktifkan Mode Pengembang.
- Jika Anda menerima pesan peringatan tentang Mode Pengembang, baca, dan pilih Ya jika Anda memahami peringatan.
Windows 10
Mode Pengembang diaktifkan di aplikasi Pengaturan , di bawah Perbarui & Keamanan>Untuk pengembang. Untuk mengaktifkan Mode Pengembang di Windows 10:
- Buka Menu Mulai.
- Cari Pengaturan pengembang, pilih pengaturan tersebut.
- Aktifkan Mode Pengembang.
- Jika Anda menerima pesan peringatan tentang Mode Pengembang, baca, dan pilih Ya jika Anda memahami peringatan.
Target Windows
Di Visual Studio, atur Target Debug ke Kerangka Kerja (...)>net8.0-windows. Ada nomor versi dalam entri item, yang mungkin atau mungkin tidak cocok dengan cuplikan layar berikut:
Di Visual Studio, atur Target Debug ke Kerangka Kerja (...)>net9.0-windows. Ada nomor versi dalam entri item, yang mungkin atau mungkin tidak cocok dengan cuplikan layar berikut:
Mengonversi aplikasi Windows .NET MAUI yang dikemas menjadi unpackaged
Untuk mengonversi aplikasi paket Windows .NET MAUI yang ada ke aplikasi yang tidak dikemas di Visual Studio:
Di Penjelajah Solusi, klik kanan proyek aplikasi .NET MAUI Anda dan pilih Properti. Kemudian, navigasikan ke tab Target Windows Aplikasi > dan pastikan bahwa Buat paket Windows MSIX tidak dicentang:
Visual Studio akan memodifikasi file proyek aplikasi Anda (*.csproj) untuk mengatur $(WindowsPackageType) properti build ke None:
<PropertyGroup>
<WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>
Selain itu, file Properti/launchSettings.json aplikasi Anda akan memiliki nilai yang commandName diubah dari MsixPackage menjadi Project:
{
"profiles": {
"Windows Machine": {
"commandName": "Project",
"nativeDebugging": false
}
}
}
Penting
Jika aplikasi Anda menentukan beberapa profil pengaturan peluncuran, Anda harus memperbarui commandName nilai secara manual dari MsixPackage ke Project untuk setiap profil.
Mengonversi aplikasi Windows .NET MAUI yang tidak dikemas menjadi dikemas
Jika aplikasi Anda perlu menggunakan API yang hanya tersedia dengan aplikasi paket Windows dan Anda berencana mendistribusikan aplikasi melalui Microsoft Store, Anda harus mengonversi aplikasi yang belum dikemas ke aplikasi paket. Ini dapat dicapai di Visual Studio:
Di Penjelajah Solusi, klik kanan proyek aplikasi .NET MAUI Anda dan pilih Properti. Kemudian, navigasikan ke tab Target Windows Aplikasi > dan pastikan bahwa Buat paket Windows MSIX dicentang:
Visual Studio akan memodifikasi file proyek aplikasi Anda (.csproj) untuk menghapus <WindowsPackageType>None</WindowsPackageType> baris. Selain itu, file Properti/launchSettings.json aplikasi Anda akan memiliki nilai yang commandName diubah dari Project menjadi MsixPackage:
{
"profiles": {
"Windows Machine": {
"commandName": "MsixPackage",
"nativeDebugging": false
}
}
}
Penting
Jika aplikasi Anda menentukan beberapa profil pengaturan peluncuran, Anda harus memperbarui commandName nilai secara manual dari Project ke MsixPackage untuk setiap profil.
Saat menyebarkan aplikasi Windows .NET MAUI yang dipaketkan, Anda harus mengaktifkan Mode Pengembang di Windows. Untuk informasi selengkapnya, lihat Mengonfigurasi Windows untuk penyebaran aplikasi paket.
Saat men-debug dan menyebarkan proyek MAUI .NET baru ke Windows, perilaku defaultnya adalah menyebarkan aplikasi yang tidak dikemas. Untuk informasi tentang aplikasi yang tidak dikemas, lihat Aplikasi Windows: pengemasan, penyebaran, dan proses.
Target Windows
Di Visual Studio, atur Target Debug ke Kerangka Kerja (...)>net8.0-windows. Ada nomor versi dalam entri item, yang mungkin atau mungkin tidak cocok dengan cuplikan layar berikut:
Di Visual Studio, atur Target Debug ke Kerangka Kerja (...)>net9.0-windows. Ada nomor versi dalam entri item, yang mungkin atau mungkin tidak cocok dengan cuplikan layar berikut:
Mengonversi aplikasi Windows .NET MAUI yang tidak dikemas menjadi dikemas
Jika aplikasi Anda perlu menggunakan API yang hanya tersedia dengan aplikasi paket Windows dan Anda berencana mendistribusikan aplikasi melalui Microsoft Store, Anda harus mengonversi aplikasi yang belum dikemas ke aplikasi paket. Ini dapat dicapai di Visual Studio:
Di Penjelajah Solusi, klik kanan proyek aplikasi .NET MAUI Anda dan pilih Properti. Kemudian, navigasikan ke tab Target Windows Aplikasi > dan pastikan bahwa Buat paket Windows MSIX dicentang:
Visual Studio akan memodifikasi file proyek aplikasi Anda (.csproj) untuk menghapus <WindowsPackageType>None</WindowsPackageType> baris. Selain itu, file Properti/launchSettings.json aplikasi Anda akan memiliki nilai yang commandName diubah dari Project menjadi MsixPackage:
{
"profiles": {
"Windows Machine": {
"commandName": "MsixPackage",
"nativeDebugging": false
}
}
}
Penting
Jika aplikasi Anda menentukan beberapa profil pengaturan peluncuran, Anda harus memperbarui commandName nilai secara manual dari Project ke MsixPackage untuk setiap profil.
Saat menyebarkan aplikasi Windows .NET MAUI yang dipaketkan, Anda harus mengaktifkan Mode Pengembang di Windows. Untuk informasi selengkapnya, lihat Mengonfigurasi Windows untuk penyebaran aplikasi paket.
Mengonversi aplikasi Windows .NET MAUI yang dikemas menjadi unpackaged
Untuk mengonversi aplikasi paket Windows .NET MAUI yang ada ke aplikasi yang tidak dikemas di Visual Studio:
Di Penjelajah Solusi, klik kanan proyek aplikasi .NET MAUI Anda dan pilih Properti. Kemudian, navigasikan ke tab Target Windows Aplikasi > dan pastikan bahwa Buat paket Windows MSIX tidak dicentang:
Visual Studio akan memodifikasi file proyek aplikasi Anda (*.csproj) untuk mengatur $(WindowsPackageType) properti build ke None:
<PropertyGroup>
<WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>
Selain itu, file Properti/launchSettings.json aplikasi Anda akan memiliki nilai yang commandName diubah dari MsixPackage menjadi Project:
{
"profiles": {
"Windows Machine": {
"commandName": "Project",
"nativeDebugging": false
}
}
}
Penting
Jika aplikasi Anda menentukan beberapa profil pengaturan peluncuran, Anda harus memperbarui commandName nilai secara manual dari MsixPackage ke Project untuk setiap profil.
Mengonfigurasi Windows untuk penyebaran aplikasi kemasan
Anda harus mengaktifkan Mode Pengembang di Windows agar dapat menyebarkan aplikasi Windows .NET MAUI yang dipaketkan. Windows 10 dan Windows 11 didukung.
Windows 11
Mode Pengembang diaktifkan di aplikasi Pengaturan, di bawah Privasi & keamanan>Untuk pengembang. Untuk mengaktifkan Mode Pengembang di Windows 11:
- Buka Menu Mulai.
- Ketik pengaturan Pengembang di kotak pencarian dan pilih.
- Aktifkan Mode Pengembang.
- Jika Anda menerima pesan peringatan tentang Mode Pengembang, baca, dan pilih Ya jika Anda memahami peringatan.
Windows 10
Mode Pengembang diaktifkan di aplikasi Pengaturan , di bawah Perbarui & Keamanan>Untuk pengembang. Untuk mengaktifkan Mode Pengembang di Windows 10:
- Buka Menu Mulai.
- Cari Pengaturan pengembang, pilih pengaturan tersebut.
- Aktifkan Mode Pengembang.
- Jika Anda menerima pesan peringatan tentang Mode Pengembang, baca, dan pilih Ya jika Anda memahami peringatan.
