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 MAUIBlazor 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。 如果您指定 detaileddiagnostic 詳細資訊,命令會顯示其下載之 Nuget 套件的相關資訊。

範例

  • maui安裝工作負載:

    dotnet workload install maui
    
  • maui-android安裝 和 maui-ios 工作負載:

    dotnet workload install maui-android maui-ios