dotnetup を使用してリポジトリ用の SDK をインストールする

Note

dotnetup はパブリック プレビュー段階です。 その機能と動作は、一般公開前に変更される可能性があります。

SDK チャネルを指定しない場合、dotnetup sdk install は現在のディレクトリからファイル システム ルートに向かって検索します。 最も近い既存の global.json ファイルが使用されます。 そのファイルの形式が正しくない場合、コマンドは親ディレクトリを検索する代わりに失敗します。 ファイルが存在しない場合は、 latestを使用します。

リポジトリの必要条件をインストールする

リポジトリ ディレクトリから、次のコマンドを実行します。

dotnetup sdk install

この global.json ファイルでは、dotnetup は 10.0.1xx 機能バンドを追跡します。

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

global.json パスは、格納されている要件のソースです。 ソースとインストールされているバージョンは、次の方法で確認できます。

dotnetup list

ロールフォワード マッピングを理解する

10.0.103 などの SDK バージョンの場合、dotnetup では rollForward を次のようにマップします。

rollForward 値 保存済みの dotnetup チャネル
省略またはlatestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable、patch、feature、minor、または major 完全一致のバージョン 10.0.103

正確な要件は固定されており、 dotnetup updateによって変更されません。 allowPrerelease プロパティは、dotnetup が導出するチャネルには影響しません。

sdk.paths を使用する

global.jsonにsdk.pathsが含まれている場合、dotnetup は、--install-path オプションがない場合に最初のパスを使用します。 global.json を含むディレクトリから相対値を解決します。

インストール パスの優先順位は次のとおりです。

  1. --install-path
  2. 最初の sdk.paths エントリ
  3. 既定の dotnetup 管理 .NET インストール ルート ディレクトリ

プレビューの制限事項

現在のパブリック プレビュー ビルドでは、最初の sdk.paths エントリをパスとして扱います。 $host$をセンチネルとして解釈したり、空のエントリをスキップしたりすることはありません。 既定の dotnetup マネージド インストール ルートを使用するには、sdk.paths を省略するか、--install-path を明示的に設定します。

global.json を更新する

sdk.versionまたはrollForwardを変更した後、リポジトリ ディレクトリからdotnetup sdk installを実行して新しい要件を適用します。 ガベージ コレクションが変更された global.json ソースを更新する前に、dotnetup sdk update が要件を格納していたため、その最初のパスでは以前の要件が引き続き使用される可能性があります。

派生チャネルに最新バージョンをインストールし、そのバージョンを global.jsonに書き戻すには、次を実行します。

dotnetup sdk install --update-global-json

後で、追跡されているすべてのリポジトリ要件とそのファイルを次の内容で更新します。

dotnetup sdk update --update-global-json

更新では sdk.version のみが変更されます。 既存の書式設定、その他のプロパティ、検出されたテキスト エンコーディングが保持されます。

一致するリポジトリの要件を削除する

アンインストール コマンドは、選択したインストール ルート内の一致するすべての globaljson 仕様を削除します。 1 つのリポジトリは対象としません。 一致する要件を既定のルートから削除するには、次を実行します。

dotnetup sdk uninstall 10.0.1xx --source globaljson

カスタム インストール ルートを選択するには、次を追加します: --install-path

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup は、残っている要件がそれらを必要としない場合にのみファイルを削除します。

参照

  • 最終更新: