dotnetup を使ってみる

Note

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

dotnetupは、ユーザー レベルの.NETインストール用のクロスプラットフォーム ツールチェーン マネージャーです。 システム パッケージ マネージャーを使用せずに、.NET SDK とランタイムをインストール、更新、および削除します。

Prerequisites

  • 次のいずれかのオペレーティング システムとアーキテクチャ:

    オペレーティング システム Architectures
    Windows x64、Arm64
    macOS x64、Arm64
    Linux (glibc) x64、Arm64
    Alpine Linux などの Linux (musl) x64、Arm64

  • ターミナル。

  • ダウンロード スクリプトを実行するには、macOS または Linux では Bash、Windows では PowerShell を使用します。

  • macOS または Linux では、curl または wget してファイルをダウンロードし、sha512sum または shasum してダウンロードしたファイルを検証します。

dotnetupには、.NET ランタイムと同じオペレーティング システム要件があります。 OS 固有の要件については、Windows に .NET をインストールする、macOS に .NET をインストールする、または Linux に .NET をインストールするを参照してください。

Important

Windowsでは、既定のセットアップでは everywhere アクセス モードが使用されます。 このモード:

  • システム PATHを更新するには昇格が必要です。
  • dotnetup で管理されたインストールは、Visual Studio などがインストールするコンピューター全体の .NET インストールよりも優先されます。 dotnetupによってインストールされていないマシン全体の SDK またはランタイムを必要とするプロジェクトとアプリは、ビルドまたは実行に失敗します。
  • システム PATHを変更します。これはすべてのユーザーに適用されます。 他のユーザーが起動する昇格されたプロセスは、ユーザー プロファイルから .NET を参照する可能性があります。

これらの影響を回避するには、セットアップ時に none または shell アクセス モードを選択してください。 everywhereを選択した場合は、セットアップで提案された場合は、既存のインストールを移行してください。 詳細については、「Everywhere モードに関する考慮事項」を参照してください。

dotnetup をダウンロードする

ダウンロード スクリプトでは、既定で最新の preview ビルドがインストールされます。 ダウンロードした実行可能ファイルをその SHA-512 チェックサムで検証し、~/.dotnetupにインストールします。

macOS または Linux で、次のコマンドを実行します。

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Windowsで、次のコマンドを実行します。

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

macOS または Linux に最新の daily ビルドをインストールするには、次のコマンドを実行します。

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Windowsに最新のdaily ビルドをインストールするには、次のコマンドを実行します。

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

毎日のビルドではリリース検証が完了せず、コード署名もされていません。 日次ビルドは、短期間のテストにのみ使用します。

スクリプトは、 dotnetup を PATHに追加する手順を出力します。 手順を適用した後、新しいターミナルを開きます。

初回セットアップを実行する

対話型セットアップを実行してください:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

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

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

パス、進行状況の表示、環境のガイダンスは、システムと選択したモードによって異なります。

推奨されるアクセス モードは、Windows ではeverywhereです。 macOS および Linux では、none がサポート対象のシェルを検出した場合は dotnetup、それ以外は shell です。

いいえ、セットアップをカスタマイズ を選択して、SDK チャネル、アクセス モード、移行オプションを選択します。

SDK チャネルを選択する

SDK チャネルは、インストールする SDK とその更新方法を dotnetup に伝えます。

チャネルフォーム 例 Result
最新の安定版 latest 最新の有効な安定版 SDK
最新の LTS lts 最新のアクティブな安定版 LTS SDK
最新のプレビュー preview 最新のプレビュー SDK
最新の日次 daily 利用可能な最新の毎日の SDK
メジャー 10 指定されたメジャー バージョンの最新の SDK
メジャーとマイナー 10.0 指定されたメジャー バージョンとマイナー バージョンの最新の SDK
機能バー 10.0.1xx 指定された機能バンド内の最新の SDK
特定のバージョン 10.0.103 指定した SDK バージョンのみ
初期 SDK なし none セットアップ中にインストールをスキップする

更新中に固定バージョンが進むわけではありません。 受け付けられるすべての形式については、dotnetup チャネルとバージョンを参照してください。

.NETにアクセスする方法を選択する

アクセス モードは、ターミナルとアプリケーションが dotnetup で管理される.NETインストールを見つける方法を制御します。

アクセス モード Behavior
none これらの環境変数は変更しません。 .NET でdotnetup dotnetを実行します。
shell シェル プロファイルを変更して、これらの環境変数を設定します。 そのシェルから開始されたプロセスでは、dotnetup によってインストールされた .NET SDK とランタイムが使用されます。
everywhere システムの PATH を変更し、ユーザー レベルの環境変数 DOTNET_ROOT を設定します。 Windowsでのみ使用できます。

everywhere モードの詳細と考慮事項については、dotnetup 環境の構成を参照してください。

既存のインストールを移行する

セットアップでは、既存のマシン全体の .NET SDK とランタイムのインストールを dotnetup で管理されたインストールに移行することを提案できます。 everywhereを参照してください。 モードで移行が特に重要である理由について説明しています。

セットアップの確認

セットアップによって環境が変更された後、新しいターミナルを開きます。

shellモードまたはeverywhereモードでは、次を実行:

dotnet --version
dotnetup list

none モードの場合は、次を実行します:

dotnetup dotnet -- --version
dotnetup list

セットアップを変更するには、dotnetup initをもう一度実行します。

  • 最終更新: