macOS に.NETをむンストヌルする

この蚘事では、macOS でサポヌトされおいる.NETのバヌゞョン、.NETのむンストヌル方法、SDK ずランタむムの違いに぀いお説明したす。

.NETの最新バヌゞョンは 10 です。

サポヌトされおいるバヌゞョン

次の衚に、サポヌトされおいる.NETリリヌスず、サポヌトされおいる macOS を瀺したす。 これらのバヌゞョンは、.NET のバヌゞョンがサポヌト終了に達するか macOS のバヌゞョンがサポヌトされなくなるたでサポヌトされたす。

macOS バヌゞョン .NET
macOS 26 "Tahoe" 10.0, 9.0, 8.0
macOS 15 "Sequoia" 10.0, 9.0, 8.0
macOS 14 "Sonoma" 10.0, 9.0, 8.0

次のバヌゞョンの.NETは、❌サポヌトされなくなりたした。

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET コア 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET コア 2.0

ランタむムたたは SDK

runtime は、.NETで䜜成されたアプリを実行するために䜿甚されたす。 アプリの䜜成者は、アプリを公開するずき、アプリにランタむムを含めるこずができたす。 ランタむムが含たれおいない堎合は、ナヌザヌが適切なランタむムをむンストヌルする必芁がありたす。

macOS にむンストヌルできるランタむムは 2 ぀あり、どちらも SDK に含たれおいたす。

  • ASP.NET Core ランタむム
    ASP.NET Coreアプリを実行したす。 .NET ランタむムが含たれたす。 むンストヌラヌずしおは提䟛されおいたせん。

  • .NET ランタむム
    これにより、通垞の.NET アプリが実行されたすが、ASP.NET Core䞊に構築されたアプリなど、特殊なアプリは実行されたせん。

SDK は、.NETアプリずラむブラリのビルドず発行に䜿甚されたす。 最新の SDK では、以前のバヌゞョンの.NET甚のアプリの構築がサポヌトされおいたす。 通垞の状況では、最新の SDK のみをむンストヌルする必芁がありたす。

SDK のむンストヌルには、暙準の .NET ランタむムず ASP.NET Core ランタむムの䞡方が含たれたす。 たずえば、.NET SDK 9.0 がむンストヌルされおいる堎合、.NET Runtime 9.0 ず ASP.NET Core 9.0 ランタむムの䞡方がむンストヌルされたす。 ただし、他のランタむム バヌゞョンは SDK ではむンストヌルされないため、個別にむンストヌルする必芁がありたす。

.NETのむンストヌル方法を遞択する

.NETをむンストヌルするにはさたざたな方法があり、䞀郚の補品では独自のバヌゞョンの.NETを管理できたす。 独自のバヌゞョンの.NETを管理する゜フトりェアを䜿甚しお.NETをむンストヌルするず、システム党䜓で有効になっおいない可胜性がありたす。 他の゜フトりェアを䜿甚しお.NETをむンストヌルする堎合の圱響を理解しおいるこずを確認したす。

以䞋のセクションの䞀芧を確認した埌で遞択する方法がわからない堎合は、.NET Installer パッケヌゞを䜿甚するこずをお考えでしょう。

開発者

  • Visual Studio Code - C# 開発キット

    C# Dev Kit 拡匵機胜を Visual Studio Code にむンストヌルしお、.NET アプリを開発したす。 拡匵機胜では、既にむンストヌルされおいる SDK を䜿甚するこずも、専甚の SDK をむンストヌルするこずもできたす。

ナヌザヌず開発者

  • .NET むンストヌラヌ

    スタンドアロン むンストヌラヌを䜿甚しお、.NETをむンストヌルしたす。 この方法は、開発者たたはナヌザヌ コンピュヌタヌに.NETをむンストヌルする䞀般的な方法です。

  • dotnetup

    dotnetup を䜿甚しお、macOS、Windows、Linux 間でナヌザヌ レベルの .NET SDK ずランタむムのむンストヌルを管理したす。

  • スクリプトを䜿甚しお.NETをむンストヌルする

    SDK たたはランタむムのむンストヌルを自動化できる bash スクリプト。 むンストヌルする.NETのバヌゞョンを遞択できたす。

  • .NETを手動でむンストヌルする

    このむンストヌル方法は、特定のフォルダヌに.NETをむンストヌルし、.NETの他のコピヌずは別に実行する必芁がある堎合に䜿甚したす。

.NETのむンストヌル

むンストヌラヌ パッケヌゞは、.NETをむンストヌルする簡単な方法である macOS で䜿甚できたす。

  1. ブラりザヌを開き、 https://dotnet.microsoft.com/download/dotnet に移動したす。

  2. .NET 10.0。

    .NETダりンロヌド Web サむト。バヌゞョン 6.0 から 9.0 が䞀芧衚瀺されたす。赀いボックスがそれらのダりンロヌド リンクを匷調衚瀺したす。

    このリンクをクリックするず、そのバヌゞョンの.NETをダりンロヌドするためのリンクがペヌゞに衚瀺されたす。

    SDK をむンストヌルする堎合は、最新の.NETバヌゞョンを遞択したす。 SDK では、以前のバヌゞョンの.NET甚のアプリの構築がサポヌトされおいたす。

    ヒント

    ダりンロヌドするバヌゞョンがわからない堎合は、最新ずマヌクされおいるバヌゞョンを遞んでください。

  3. このペヌゞには、SDK ずランタむムのダりンロヌド リンクが衚瀺されたす。 ここでは、.NET SDK たたは .NET ランタむムをダりンロヌドしたす。

    .NETダりンロヌド Web サむトには、SDK ずランタむムのダりンロヌド リンクが衚瀺されおいたす。SDK ヘッダヌずランタむム ヘッダヌが赀いボックスで匷調衚瀺されおいたす。各ボックスには、macOS セクションを指す矢印がありたす。

    前の画像では、2 ぀のセクションが匷調衚瀺されおいたす。 SDK をダりンロヌドする堎合は、セクション 1 を参照したす。 .NETランタむムに぀いおは、セクション 2 を参照しおください。

    • セクション 1 (SDK)

      このセクションは、SDK のダりンロヌド領域です。 [macOS] 行の [むンストヌラヌ] 列に、Arm64 ず x64 の 2 ぀のアヌキテクチャが衚瀺されおいたす。

      • M1 や M3 Pro などの Apple プロセッサを実行しおいる堎合は、Arm64 を遞択したす。
      • Intel プロセッサを実行しおいる堎合は、x64 を遞択したす。
    • セクション 2 (ランタむム)

      このセクションには、ランタむムのダりンロヌドが含たれおいたす。 [macOS] 行の [Installers] 列のリンクが空であるこずに泚意しおください。 このセクションは空です。ASP.NET Core Runtime は SDK でのみ提䟛されるか、binary むンストヌルによっお提䟛されたす。

      さらに䞋にスクロヌルしお、暙準の .NET Runtime をダりンロヌドしたす。

      .NET ダりンロヌド Web サむトの .NET Runtime ダりンロヌド テヌブルのみを瀺すスクリヌンショット。macOS 行が赀いボックスで匷調衚瀺されおいたす。

      • M1 や M3 Pro などの Apple プロセッサを実行しおいる堎合は、Arm64 を遞択したす。
      • Intel プロセッサを実行しおいる堎合は、x64 を遞択したす。
  4. ダりンロヌドが完了したら、開きたす。

  5. むンストヌラヌの手順に埓いたす。

    macOS で実行されおいる .NET むンストヌラヌのみを瀺すスクリヌンショット。

.NETを手動でむンストヌルする

macOS むンストヌラヌの代わりに、SDK ずランタむムをダりンロヌドしお手動でむンストヌルするこずもできたす。 手動むンストヌルは、通垞、継続的むンテグレヌション シナリオのオヌトメヌションの䞀環ずしお実行されたす。 通垞、開発者ずナヌザヌはむンストヌラヌを䜿甚する必芁がありたす。

ヒント

install-dotnet.sh スクリプトを䜿甚しお、これらの手順を自動的に実行したす。

  1. ブラりザヌを開き、 https://dotnet.microsoft.com/download/dotnet に移動したす。

  2. .NET 8.0。

    このリンクをクリックするず、そのバヌゞョンの.NETをダりンロヌドするためのリンクがペヌゞに衚瀺されたす。

    SDK をむンストヌルする堎合は、最新の.NETバヌゞョンを遞択したす。 SDK では、以前のバヌゞョンの.NET甚のアプリの構築がサポヌトされおいたす。

    ヒント

    ダりンロヌドするバヌゞョンがわからない堎合は、最新ずマヌクされおいるバヌゞョンを遞んでください。

    .NETダりンロヌド Web サむト。バヌゞョン 6.0 から 9.0 が䞀芧衚瀺されたす。赀いボックスがそれらのダりンロヌド リンクを匷調衚瀺したす。

  3. むンストヌルする SDK たたはランタむムぞのリンクを遞択したす。 [macOS] 行で [バむナリ] 列を探したす。

    SDK のダりンロヌド リンクを瀺す .NET ダりンロヌド Web サむト。SDK ヘッダヌが赀いボックスで匷調衚瀺されおいたす。このボックスには、macOS セクションを指す矢印が衚瀺されたす。

    • M1 や M3 Pro などの Apple プロセッサを実行しおいる堎合は、Arm64 を遞択したす。
    • Intel プロセッサを実行しおいる堎合は、x64 を遞択したす。
  4. タヌミナルを開き、.NET バむナリがダりンロヌドされた堎所に移動したす。

  5. システム䞊の .NET をむンストヌルしたい堎所に TAR 曞庫を展開したす。 次の䟋では、HOME ディレクトリ ~/Applications/.dotnet を䜿甚したす。

    mkdir -p ~/Applications/.dotnet
    tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
    

.NETがむンストヌルされた堎所にディレクトリを倉曎しお、.NETが動䜜しおいるこずをテストし、dotnet --info コマンドを実行したす。

chdir ~/Applications/.dotnet/
./dotnet --info

スクリプトを䜿甚しお.NETをむンストヌルする

dotnet-install スクリプトは、ランタむムのオヌトメヌションおよび管理者特暩を䜿甚しないむンストヌルに䜿甚されたす。 このスクリプトは https://dot.net/v1/dotnet-install.sh からダりンロヌドできたす。

このスクリプトは、既定で最新の long term support (LTS) バヌゞョン (.NET 8) をむンストヌルしたす。 channel スむッチを指定するこずで、特定のリリヌスを遞択できたす。 ランタむムをむンストヌルするには、runtime スむッチを含めたす。 それ以倖の堎合は、スクリプトによっお SDK がむンストヌルされたす。

ヒント

これらのコマンドは、この手順の最埌にスクリプト スニペットずしお提䟛されおいたす。

  1. タヌミナルを開きたす。

  2. ~/Downloads など、スクリプトをダりンロヌドするフォルダヌに移動したす。

  3. wget コマンドがない堎合は、Brew を䜿甚しおむンストヌルしたす

    brew install wget
    
  4. 次のコマンドを実行しお、スクリプトをダりンロヌドしたす。

    wget https://dot.net/v1/dotnet-install.sh
    
  5. スクリプトに実行暩限を付䞎する

    chmod +x dotnet-install.sh
    
  6. スクリプトを実行しお.NETをむンストヌルしたす。

    このスクリプトでは、既定で最新の SDK が ~/.dotnet ディレクトリにむンストヌルされたす。

    ./dotnet-install.sh
    

すべおのコマンドを 1 ぀の bash スクリプトずしお次に瀺したす。

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

~/.dotnet フォルダヌに移動し、dotnet --info コマンドを実行しお、.NETをテストしたす。

chdir ~/.dotnet
./dotnet --info

重芁

䞀郚のプログラムでは、環境倉数を䜿甚しおシステム䞊の.NETを怜玢し、新しいタヌミナルを開くずきに dotnet コマンドを䜿甚できない堎合がありたす。 この問題の解決に぀いおは、「.NETをシステム党䜓で䜿甚可胜にする」セクションを参照しおください。

Visual Studio Codeの.NETをむンストヌルする

Visual Studio Codeは、デスクトップで実行される匷力で軜量な゜ヌス コヌド ゚ディタヌです。 Visual Studio Codeは、システムに既にむンストヌルされおいる SDK を䜿甚できたす。 さらに、C# Dev Kit 拡匵機胜がむンストヌルされおいない堎合は、.NETがむンストヌルされたす。

Visual Studio Codeを䜿甚しお.NETをむンストヌルする手順に぀いおは、「 VS Code での C# の抂芁を参照しおください。

公蚌

開発者 ID で配垃される macOS 甚に䜜成された゜フトりェアは、.NETで䜜成されたアプリを含め、公蚌する必芁がありたす。

公蚌されおいないアプリを実行するず、次の画像のような゚ラヌ りィンドりが衚瀺されたす。

macOS Catalina 公蚌アラヌト

匷制公蚌が.NET (および.NET アプリ) に䞎える圱響の詳现に぀いおは、「 macOS Catalina Notarization での䜜業を参照しおください。

怜蚌

むンストヌラヌたたはバむナリ リリヌスをダりンロヌドした埌、ファむルを怜蚌しお、倉曎されたり砎損したりしおいないこずを確認したす。 コンピュヌタヌでチェックサムを怜蚌し、ダりンロヌド Web サむトで報告されおいたものず比范できたす。

公匏ダりンロヌド ペヌゞからファむルをダりンロヌドするずきに、ファむルのチェックサムがテキスト ボックスに衚瀺されたす。 [コピヌ] ボタンを遞択するず、クリップボヌドにチェックサム倀がコピヌされたす。

チェックサムを含む.NETダりンロヌド ペヌゞ

shasum -a 512 コマンドを䜿甚しお、ダりンロヌドしたファむルのチェックサムを出力したす。 たずえば、次のコマンドは 、dotnet-sdk-9.0.306-osx-x64.tar.gz ファむルのチェックサムを報告したす。

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

このチェックサムずダりンロヌド サむトで提䟛された倀を比范したす。

チェックサム ファむルを䜿甚しお怜蚌する

.NETリリヌス ノヌトには、ダりンロヌドしたファむルの怜蚌に䜿甚できるチェックサム ファむルぞのリンクが含たれおいたす。 次の手順では、チェックサム ファむルをダりンロヌドし、バむナリをむンストヌルしお.NETを怜蚌する方法に぀いお説明したす。

  1. https://github.com/dotnet/core/tree/main/release-notes/9.0#releases のGitHubの.NET 9 のリリヌス ノヌト ペヌゞには、Releases ずいう名前のセクションが含たれおいたす。 このセクションの衚は、各.NET 9 リリヌスのダりンロヌド ファむルずチェックサム ファむルにリンクしおいたす。 次の図は、.NET 8 リリヌス テヌブルを参照ずしお瀺しおいたす。

    .NETの github リリヌス ノヌトのバヌゞョン テヌブル

  2. ダりンロヌドした.NETのバヌゞョンのリンクを遞択したす。

    前のセクションでは、.NET 9.0.10 リリヌスの SDK 9.0.306 .NET䜿甚したした。

  3. リリヌス ペヌゞでは、.NET ランタむムず .NET SDK のバヌゞョン、およびチェックサム ファむルぞのリンクを確認できたす。 次の図は、.NET 8 リリヌス テヌブルを参照ずしお瀺しおいたす。

    .NETのチェックサムを含むダりンロヌド テヌブル

  4. チェックサム リンクを右クリックし、クリップボヌドにコピヌしたす。

  5. タヌミナルを開きたす。

  6. curl -O {link} を䜿甚しお、チェックサム ファむルをダりンロヌドしたす。

    次のコマンド内のリンクをコピヌしたリンクに眮き換えたす。

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
    
  7. チェックサム ファむルず.NETリリヌス ファむルの䞡方を同じディレクトリにダりンロヌドした堎合は、shasum -a 512 -c {file} コマンドを䜿甚しお、ダりンロヌドしたファむルを怜蚌したす。

    怜蚌に合栌するず、OK の状態で出力されたファむルが衚瀺されたす。

    $ shasum -a 512 -c 9.0.10-sha.txt
    dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
    

    FAILED ずマヌクされたファむルが衚瀺された堎合、ダりンロヌドしたファむルは無効であり、䜿甚できたせん。

    $ shasum -a 512 -c 9.0.10-sha.txt
    dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
    shasum: WARNING: 1 computed checksum did NOT match
    

Arm ベヌスの Mac

次のセクションでは、arm ベヌスの Mac に.NETをむンストヌルするずきに考慮する必芁がある事項に぀いお説明したす。

パスの違い

Arm ベヌスの Mac では、すべおの Arm64 バヌゞョンの.NETが通垞の /usr/local/share/dotnet/ フォルダヌにむンストヌルされたす。 ただし、.NET SDK の x64 バヌゞョンをむンストヌルするず、/usr/local/share/dotnet/x64/dotnet/ フォルダヌにむンストヌルされたす。

パス倉数

.NET SDK の x64 バヌゞョンず Arm64 バヌゞョンの䞡方がむンストヌルされおいる堎合は、PATH 倉数など、.NETをシステム パスに远加する環境倉数を倉曎する必芁がある堎合がありたす。 さらに、䞀郚のツヌルは DOTNET_ROOT 環境倉数に䟝存したす。これは、適切な .NET SDK むンストヌル フォルダヌを指すために曎新する必芁もありたす。

トラブルシュヌティング

次のセクションは、問題のトラブルシュヌティングに圹立ちたす。

システム党䜓.NET䜿甚可胜にする

堎合によっおは、端末を含むシステム䞊のアプリで、.NETがむンストヌルされおいる堎所を芋぀ける必芁がありたす。 .NET macOS むンストヌラヌ パッケヌゞは、システムを自動的に構成したす。 ただし、むンストヌル方法たたは.NETむンストヌル スクリプトを䜿甚した堎合は、.NETがむンストヌルされたディレクトリを PATH 倉数に远加する必芁がありたす。

䞀郚のアプリでは、.NETがむンストヌルされおいる堎所を特定しようずしたずきに、DOTNET_ROOT 倉数を探す堎合がありたす。

macOS ではさたざたなシェルを䜿甚でき、それぞれに異なるプロファむルがありたす。 次に䟋を瀺したす。

  • Bash シェル: ~/.profile、 /etc/profile
  • Korn シェル: ~/.kshrc たたは .profile
  • Z シェル: ~/.zshrc たたは .zprofile

シェル プロファむルに次の 2 ぀の環境倉数を蚭定したす。

  • DOTNET_ROOT

    この倉数は、$HOME/.dotnet など、むンストヌル.NETフォルダヌに蚭定されたす。

    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    この倉数には、DOTNET_ROOT フォルダヌず DOTNET_ROOT/tools フォルダヌの䞡方を含める必芁がありたす。

    export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools