dotnet workload install
Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru
Nama
dotnet workload install
- Memasang beban kerja opsional.
Sinopsis
dotnet workload install <WORKLOAD_ID>...
[--configfile <FILE>] [--disable-parallel]
[--ignore-failed-sources] [--include-previews] [--interactive]
[--no-cache] [--skip-manifest-update] [--source <SOURCE>]
[--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet workload install -?|-h|--help
Deskripsi
Perintah dotnet workload install
memasang satu atau beberapa beban kerja opsional. Beban kerja opsional dapat dipasang di atas .NET SDK untuk memberikan dukungan untuk berbagai jenis aplikasi, seperti .NET MAUI dan Blazor WebAssembly AOT.
Saat perintah dalam workload-set
mode pembaruan, versi beban kerja terinstal:
- Berasal dari set beban kerja terbaru atau versi set beban kerja yang ditentukan dalam global.json atau
--version
opsi. - Mungkin bukan versi terbaru yang tersedia dari setiap beban kerja individu. Misalnya,
install
perintah tidak akan menginstal beban kerja yang lebih baru yang ditetapkan jika Anda sebelumnya menggunakan--version
bendera.
Untuk informasi selengkapnya, lihat set beban kerja .NET SDK. workload-set
mode pembaruan tersedia sejak 8.0.400 SDK.
Gunakan pencarian beban kerja dotnet untuk mempelajari beban kerja apa yang tersedia untuk dipasang.
Kapan harus berjalan ditingkatkan
Untuk pemasangan macOS dan Linux SDK yang dipasang ke direktori yang dilindungi, perintah perlu dijalankan ditingkatkan (gunakan sudo
perintah ). Pada Windows, perintah tidak perlu berjalan ditingkatkan meskipun SDK dipasang ke direktori Program Files. Untuk Windows, perintah menggunakan alat penginstal MSI untuk lokasi tersebut.
Hasil bervariasi menurut versi SDK
Perintah dotnet workload
beroperasi dalam konteks versi SDK tertentu. Misalkan Anda telah memasang .NET 6.0.100 SDK dan .NET 6.0.200 SDK. Perintah dotnet workload
akan memberikan hasil yang berbeda bergantung pada versi SDK mana yang Anda pilih. Perilaku ini berlaku untuk versi utama dan minor dan perbedaan band fitur, bukan untuk menambal perbedaan versi. Misalnya, .NET SDK 6.0.101 dan 6.0.102 memberikan hasil yang sama, sedangkan 6.0.100 dan 6.0.200 memberikan hasil yang berbeda. Anda dapat menentukan versi SDK dengan menggunakan file global.json.
Manifes iklan
Nama dan versi aset yang diperlukan pemasangan beban kerja dipertahankan dalam manifes. Secara default, dotnet workload install
perintah mengunduh manifes terbaru yang tersedia sebelum memasang beban kerja. Salinan manifes lokal kemudian menyediakan informasi yang diperlukan untuk menemukan dan mengunduh aset untuk beban kerja.
Perintah dotnet workload list
membandingkan versi beban kerja yang dipasang dengan versi yang saat ini tersedia. Saat menemukan bahwa versi yang lebih baru dari versi yang dipasang tersedia, ia mengiklankan fakta itu dalam output perintah. Pemberitahuan versi yang lebih baru ini dotnet workload list
tersedia mulai dari .NET 6.
Untuk mengaktifkan pemberitahuan ini, versi manifes terbaru yang tersedia diunduh dan disimpan sebagai manifes iklan. Unduhan ini terjadi secara asinkron di latar belakang saat salah satu perintah berikut dijalankan.
Jika perintah selesai sebelum pengunduhan manifes selesai, unduhan dihentikan. Unduhan dicoba lagi saat berikutnya salah satu perintah ini dijalankan. Anda dapat mengatur variabel lingkungan untuk menonaktifkan unduhan latar belakang ini atau mengontrol frekuensinya. Secara default, mereka tidak terjadi lebih dari sekali sehari.
Anda dapat mencegah dotnet workload install
perintah melakukan unduhan manifes dengan menggunakan --skip-manifest-update
opsi .
Perintah ini dotnet workload update
juga mengunduh manifes iklan. Unduhan diperlukan untuk mempelajari apakah pembaruan tersedia, sehingga tidak ada opsi untuk mencegahnya berjalan. Namun, Anda dapat menggunakan --advertising-manifests-only
opsi untuk melewati pembaruan beban kerja dan hanya melakukan unduhan manifes. Opsi ini tersedia mulai dari .NET 6.
Argumen
WORKLOAD_ID
...ID beban kerja atau beberapa ID yang akan dipasang. Gunakan pencarian beban kerja dotnet untuk mempelajari beban kerja apa yang tersedia untuk dipasang.
Opsi
--configfile <FILE>
File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.
--disable-parallel
Mencegah pemulihan beberapa proyek secara paralel.
-?|-h|--help
Mencetak deskripsi cara menggunakan perintah.
--ignore-failed-sources
Memperlakukan kegagalan sumber paket sebagai peringatan.
--include-previews
Memungkinkan manifes beban kerja prarilis.
--interactive
Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi.
--no-cache
Mencegah penembolokan paket dan permintaan http.
--skip-manifest-update
Lewati pembaruan manifes beban kerja. Manifes beban kerja menentukan aset dan versi apa yang perlu dipasang untuk setiap beban kerja.
-s|--source <SOURCE>
Menentukan URI sumber paket NuGet yang akan digunakan. Pengaturan ini mengambil alih semua sumber yang ditentukan dalam file nuget.config. Beberapa sumber dapat disediakan dengan menentukan opsi ini beberapa kali.
--temp-dir <PATH>
Tentukan direktori sementara yang digunakan untuk mengunduh dan mengekstrak paket NuGet (harus aman).
-v|--verbosity <LEVEL>
Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah
q[uiet]
,m[inimal]
,n[ormal]
,d[etailed]
, dandiag[nostic]
. Default adalahminimal
. Jika Anda menentukandetailed
ataudiagnostic
verbositas, perintah menampilkan informasi tentang paket Nuget yang diunduhnya.
--version
Versi set beban kerja untuk diinstal atau diperbarui. Jika Anda menentukan versi set beban kerja di global.json, Anda tidak dapat menggunakan
--version
opsi untuk menentukan versi set beban kerja. Untuk memungkinkan penggunaan--version
opsi dalam hal ini, jalankan perintah di luar jalur yang berisi file global.json. Tersedia sejak 8.0.400 SDK. Untuk informasi selengkapnya, lihat set beban kerja .NET SDK.
Contoh
Pasang beban kerja
maui
:dotnet workload install maui
Pasang beban kerja
maui-android
danmaui-ios
:dotnet workload install maui-android maui-ios