dotnet 工作負載安裝
本文適用于: ✔️.NET 6 SDK 和更新版本
名稱
dotnet workload install
- 安裝選擇性工作負載。
概要
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>]
dotnet workload install -?|-h|--help
描述
此命令 dotnet workload install
會安裝一或多個 選擇性工作負載。 選擇性工作負載可以安裝在 .NET SDK 之上,以提供各種應用程式類型的支援,例如 .NET MAUI 和 Blazor WebAssembly AOT。
使用 dotnet 工作負載搜尋 來瞭解哪些工作負載可供安裝。
何時執行提升許可權
針對已安裝至受保護目錄的 macOS 和 Linux SDK 安裝,命令必須執行提升許可權 (使用 sudo
命令) 。 在Windows上,即使 SDK 已安裝至Program Files目錄,命令也不需要執行提升許可權。 針對 Windows,此命令會針對該位置使用 MSI 安裝程式。
結果會因 SDK 版本而異
命令 dotnet workload
會在特定 SDK 版本的內容中運作。 假設您已安裝 .NET 6.0.100 SDK 和 .NET 6.0.200 SDK。 這些 dotnet workload
命令會根據您選取的 SDK 版本,提供不同的結果。 此行為適用于主要和次要版本和功能頻差異,而不是修補程式版本差異。 例如,.NET SDK 6.0.101 和 6.0.102 會提供相同的結果,而 6.0.100 和 6.0.200 則提供不同的結果。 您可以使用global.json檔案或 --sdk-version
命令的選項 dotnet workload
來指定 SDK 版本。
廣告資訊清單
工作負載安裝所需的資產名稱和版本會在 資訊清單中維護。 根據預設, dotnet workload install
命令會先下載最新的可用資訊清單,再安裝工作負載。 然後,資訊清單的本機複本會提供尋找和下載工作負載資產所需的資訊。
此命令 dotnet workload list
會比較已安裝工作負載的版本與目前可用的版本。 當它發現版本比已安裝的版本還新時,它會在命令輸出中公告該事實。 中的 dotnet workload list
這些較新版本通知可從 .NET 6 開始取得。
若要啟用這些通知,會下載最新的可用資訊清單版本,並儲存為 廣告資訊清單。 執行下列任何命令時,這些下載會以非同步方式在背景進行。
如果命令在資訊清單下載完成之前完成,則會停止下載。 下次執行其中一個命令時,會再次嘗試下載。 您可以設定環境變數來 停用這些背景下載 或 控制其頻率。 根據預設,它們一天不會發生一次以上。
您可以使用 選項來防止 dotnet workload install
命令執行資訊清單下載 --skip-manifest-update
。
此命令 dotnet workload update
也會下載廣告資訊清單。 需要下載才能瞭解是否有可用的更新,因此沒有選項可防止它們執行。 不過,您可以使用 --advertising-manifests-only
選項來略過工作負載更新,並且只執行資訊清單下載。 此選項可從 .NET 6 開始使用。
引數
WORKLOAD_ID
...要安裝的工作負載識別碼或多個識別符。 使用 dotnet 工作負載搜尋 來瞭解可用的工作負載。
選項。
--configfile <FILE>
NuGet組態檔 (nuget.config) 使用。 如果指定,則只會使用此檔案中的設定。 如果未指定,將會使用來自目前目錄的組態檔階層。 如需詳細資訊,請參閱常見NuGet組態。
--disable-parallel
防止平行還原多個專案。
-?|-h|--help
列印出如何使用 命令的描述。
--ignore-failed-sources
將套件來源失敗視為警告。
--include-previews
允許發行前版本工作負載資訊清單。
--interactive
可讓命令停止,並等候使用者輸入或進行動作。 例如完成驗證。
--no-cache
防止快取套件和 HTTP 要求。
--skip-manifest-update
略過更新工作負載資訊清單。 工作負載資訊清單會定義每個工作負載需要安裝哪些資產和版本。
-s|--source <SOURCE>
指定要使用之NuGet套件來源的 URI。 此設定會覆寫 nuget.config 檔案中指定的所有來源。 多次指定這個選項,即可提供多個來源。
--temp-dir <PATH>
指定用來下載和擷取NuGet套件的臨時目錄, (必須是安全的) 。
-v|--verbosity <LEVEL>
設定命令的詳細資訊層級。 允許的值為
q[uiet]
、m[inimal]
、n[ormal]
、d[etailed]
和diag[nostic]
。 預設為minimal
。 如果您指定detailed
或diagnostic
詳細資訊,命令會顯示其下載之 Nuget 套件的相關資訊。
範例
maui
安裝工作負載:dotnet workload install maui
maui-android
安裝 和maui-ios
工作負載:dotnet workload install maui-android maui-ios