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 build
• dotnet pack
• dotnet publish
• dotnet restore
• dotnet run
• dotnet test

如果命令在資訊清單下載完成之前完成，則會停止下載。 下次執行其中一個命令時，會再次嘗試下載。 您可以設定環境變數來 停用這些背景下載 或 控制其頻率。 根據預設，它們一天不會發生一次以上。

您可以使用 選項來防止 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