Bagikan melalui

dotnet workload install

  • Artikel

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], dan diag[nostic]. Default adalah minimal. Jika Anda menentukan detailed atau diagnostic 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 dan maui-ios:

    dotnet workload install maui-android maui-ios