dotnetup の概要

Note

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

dotnetupは、ユーザー レベルの.NETインストール用のクロスプラットフォーム ツールチェーン マネージャーです。 システムマネージド .NET ディレクトリに書き込むことなく、.NET SDK とランタイムをインストールします。 また、後で関連ファイルを更新または削除できるように、選択したインストール オプションも追跡します。

dotnetupを使用して次の手順を実行します。

  • 安定版、プレビュー版、日次バージョン、または特定の .NET バージョンをインストールします。
  • 1 つのマネージド インストールで複数の SDK とランタイムの要件をまとめて管理できます。
  • 最も近い global.json ファイルで必要な SDK をインストールします。
  • 正確なバージョン要件を変更せずに、追跡対象チャネルを更新します。
  • ターミナルとアプリケーションがマネージド dotnetを見つける方法を構成します。
  • dotnetを変更せずに、マネージドPATHを実行します。

Start

対話型セットアップを実行します：

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

セットアップでは、インストールする SDK チャネルと、管理対象の dotnet コマンドにアクセスする方法を尋ねます。

簡潔で非対話型のセットアップを行う場合は、SDK をインストールし、現在のシェルを設定します。

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

シェル プロファイルを変更したくない場合は、フォワーディング コマンドを使用します。

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

モード、解決されたバージョン、アーキテクチャ、インストール パス、およびシェル コマンドは、システムと使用可能なリリースによって異なります。

dotnetup が.NETを管理する方法

dotnetup は、指定した SDK のインストールを追跡します。 この追跡機能により、dotnetup は多数のインストールを同時に更新できます。 また、dotnetup は使用されていないインストールやサポート対象外のインストールを安全に削除できます。

詳細については、「 dotnetup のしくみ」を参照してください。

ゴール Article
dotnetup が用途に合うか判断する dotnetup を使用するタイミング
dotnetup をインストールし、最初のセットアップを実行する dotnetup を使い始める
チャネル、インストール ルート、トラッキングについて dotnetup のしくみ
リポジトリのglobal.jsonを使用する リポジトリ SDK の要件を管理する
SDK とランタイムをインストールする .NET コンポーネントをインストールする
インストールを更新または削除する インストールを更新
dotnetup 自体を更新または削除する dotnetup を更新または削除する
PATH と DOTNET_ROOT を構成する dotnetup 環境を管理する
プレビューまたは毎日のビルドを試す プレビュービルドと日次ビルドを使用する
一般的な問題を修正する dotnetup のトラブルシューティング
dotnetup が収集するデータについて説明します dotnetup テレメトリ
コマンド構文を検索する dotnetup コマンド リファレンス

Availability

dotnetup はパブリック プレビューとして利用できます。 コマンド、オプション、動作はプレビュー リリース間で変更される可能性があり、一般公開リリースのサポート ライフサイクルは最終的ではありません。

dotnetupをインストールするには、「dotnetup の使用を開始する」を参照してください。 インストールした後、dotnetup --version を実行してバージョンを確認し、dotnetup --help を実行して使用可能なコマンドを確認します。

  • 最終更新: