dotnet workload install

[アーティクル]
04/08/2023

この記事の対象: ✔️ .NET 6 SDK 以降のバージョン

Name

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 コマンドによって 1 つまたは複数の "オプションのワークロード" がインストールされます。オプションのワークロードを .NET SDK の上にインストールすると、.NET MAUI や Blazor WebAssembly AOT などのさまざまなアプリケーションの種類をサポートできます。

インストールできるワークロードを確認するには、dotnet workload search を使用します。

管理者特権で実行する場合

保護されたディレクトリにインストールされる 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 のバージョンを指定できます。

広告マニフェスト

ワークロードのインストールに必要なアセットの名前とバージョンは、"マニフェスト" に保持されます。既定では、dotnet workload install コマンドによって、ワークロードのインストール前に、利用可能な最新のマニフェストがダウンロードされます。マニフェストのローカルコピーによって、ワークロードのアセットを検索してダウンロードするために必要な情報が提供されます。

dotnet workload list コマンドは、インストールされているワークロードのバージョンと現在使用可能なバージョンを比較します。インストールされているバージョンよりも新しいバージョンが使用可能であることが判明した場合は、コマンドの出力にその事実をアドバタイズします。 dotnet workload list の新しいバージョンの通知は、.NET 6 以降で利用できます。

これらの通知を有効にするために、マニフェストの利用可能な最新バージョンがダウンロードされ、"広告マニフェスト" として格納されます。これらのダウンロードは、次のいずれかのコマンドが実行されると、バックグラウンドで非同期的に行われます。

マニフェストのダウンロードが完了する前にコマンドが終了した場合、ダウンロードは停止します。次にこれらのコマンドのいずれかが実行されたときに、ダウンロードが再試行されます。環境変数を設定して、これらのバックグラウンドダウンロードを無効にしたり、その頻度を制御したりすることができます。既定では、1 日に複数回発生することはありません。

--skip-manifest-update オプションを使用すると、dotnet workload install コマンドでマニフェストがダウンロードされないようにすることができます。

この dotnet workload update コマンドは広告マニフェストもダウンロードします。このダウンロードは、更新プログラムが利用可能かどうかを確認するために必要なため、実行を防止するオプションはありません。ただし、--advertising-manifests-only オプションを使用してワークロードの更新をスキップしたり、マニフェストのダウンロードのみを実行したりすることができます。このオプションは、.NET 6 以降で使用できます。

引数

WORKLOAD_ID...

ワークロードの ID またはインストールする複数の ID。使用可能なワークロードを確認するには、dotnet workload search を使用します。

オプション

--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
```