macOS に .NET Core をインストールするInstall .NET Core on macOS

この記事では、macOS に .NET Core をインストールする方法について説明します。In this article, you'll learn how to install .NET Core on macOS. .NET Core は、ランタイムと SDK で構成されています。.NET Core is made up of the runtime and the SDK. ランタイムは .NET Core アプリを実行するために使用され、アプリに含まれている場合と含まれていない場合があります。The runtime is used to run a .NET Core app and may or may not be included with the app. SDK は、.NET Core アプリとライブラリの作成に使用されます。The SDK is used to create .NET Core apps and libraries. .NET Core ランタイムは、常に SDK と共にインストールされます。The .NET Core runtime is always installed with the SDK.

.NET Core の最新バージョンは 3.1 です。The latest version of .NET Core is 3.1.

サポートされているリリースSupported releases

次の表に、現在サポートされている .NET Core リリースと、それらがサポートされている macOS のバージョンの一覧を示します。The following table is a list of currently supported .NET Core releases and the versions of macOS they're supported on. これらのバージョンは、いずれかのバージョンの .NET Core がサポート終了に達するまで、サポートされています。These versions remain supported either the version of .NET Core reaches end-of-support.

  • ✔️ は、.NET Core のバージョンがまだサポートされていることを示します。A ✔️ indicates that the version of .NET Core is still supported.
  • ❌ は、.NET Core のバージョンがサポートされていないことを示します。A ❌ indicates that the version of .NET Core isn't supported.
オペレーティング システムOperating System .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 .NET 5 Preview.NET 5 Preview
macOS 10.15 "Catalina"macOS 10.15 "Catalina" ✔️ 2.1 (リリース ノート)✔️ 2.1 (Release notes) ✔️ 3.1 (リリース ノート)✔️ 3.1 (Release notes) ✔️ 5.0 Preview (リリース ノート)✔️ 5.0 Preview (Release notes)
macOS 10.14 "Mojave"macOS 10.14 "Mojave" ✔️ 2.1 (リリース ノート)✔️ 2.1 (Release notes) ✔️ 3.1 (リリース ノート)✔️ 3.1 (Release notes) ✔️ 5.0 Preview (リリース ノート)✔️ 5.0 Preview (Release notes)
macOS 10.13 "High Sierra"macOS 10.13 "High Sierra" ✔️ 2.1 (リリース ノート)✔️ 2.1 (Release notes) ✔️ 3.1 (リリース ノート)✔️ 3.1 (Release notes) ✔️ 5.0 Preview (リリース ノート)✔️ 5.0 Preview (Release notes)
macOS 10.12 "Sierra"macOS 10.12 "Sierra" ✔️ 2.1 (リリース ノート)✔️ 2.1 (Release notes) ❌ 3.1 (リリース ノート)❌ 3.1 (Release notes) ❌ 5.0 Preview (リリース ノート)❌ 5.0 Preview (Release notes)

サポートされていないリリースUnsupported releases

次のバージョンの .NET Core は ❌ サポート対象外となりました。The following versions of .NET Core are ❌ no longer supported. これらのダウンロードは、まだ公開されています。The downloads for these still remain published:

ランタイムに関する情報Runtime information

ランタイムは、.NET Core で作成されたアプリを実行するために使用されます。The runtime is used to run apps created with .NET Core. アプリの作成者は、アプリを公開するとき、アプリにランタイムを含めることができます。When an app author publishes an app, they can include the runtime with their app. ランタイムが含まれていない場合は、ユーザーがランタイムをインストールする必要があります。If they don't include the runtime, it's up to the user to install the runtime.

macOS には、3 つの異なるランタイムをインストールできます。There are three different runtimes you can install on macOS:

ASP.NET Core ランタイムASP.NET Core runtime
ASP.NET Core アプリを実行します。Runs ASP.NET Core apps. .NET Core ランタイムが含まれます。Includes the .NET Core runtime.

.NET Core ランタイム.NET Core runtime
このランタイムは最も単純なランタイムであり、他のランタイムは含まれていません。This runtime is the simplest runtime and doesn't include any other runtime. .NET Core アプリとの互換性を最善にするには、"ASP.NET Core ランタイム" をインストールすることを強くお勧めします。It's highly recommended that you install ASP.NET Core runtime for the best compatibility with .NET Core apps.

SDK に関する情報SDK information

SDK は、.NET Core アプリとライブラリを作成して公開するために使用されます。The SDK is used to build and publish .NET Core apps and libraries. SDK のインストールには、次の両方のランタイムが含まれます: ASP.NET Core と .NET Core。Installing the SDK includes both runtimes: ASP.NET Core and .NET Core.

依存関係Dependencies

.NET Core は、次の macOS のリリースでサポートされています。.NET Core is supported on the following macOS releases:

注意

+ 記号は、最小バージョンを表します。A + symbol represents the minimum version.

.NET Core のバージョン.NET Core Version macOSmacOS アーキテクチャArchitectures
3.13.1 High Sierra (10.13+)High Sierra (10.13+) X64x64 詳細情報More information
3.03.0 High Sierra (10.13+)High Sierra (10.13+) X64x64 詳細情報More information
2.22.2 Sierra (10.12+)Sierra (10.12+) X64x64 詳細情報More information
2.12.1 Sierra (10.12+)Sierra (10.12+) X64x64 詳細情報More information

macOS Catalina (バージョン 10.15) 以降では、2019 年 6 月 1 日より後に作成され、Developer ID と共に配布されたすべてのソフトウェアは公証される必要があります。Beginning with macOS Catalina (version 10.15), all software built after June 1, 2019 that is distributed with Developer ID, must be notarized. この要件は、.NET Core ランタイム、.NET Core SDK、および .NET Core を使用して作成されたソフトウェアに適用されます。This requirement applies to the .NET Core runtime, .NET Core SDK, and software created with .NET Core.

.NET Core (ランタイムと SDK の両方) バージョン 3.1、3.0、2.1 のインストーラーは、2020 年 2 月 18 日から公証されています。The installers for .NET Core (both runtime and SDK) versions 3.1, 3.0, and 2.1, have been notarized since February 18, 2020. それより前にリリースされたバージョンは、公証されていません。Prior released versions aren't notarized. 公証されていないアプリを実行すると、次のイメージのようなエラーが表示されます。If you run a non-notarized app, you'll see an error similar to the following image:

macOS Catalina の公証に関するアラート

公証の強制が .NET Core (および .NET Core アプリ) に与える影響の詳細については、macOS Catalina の公証への対応に関するページを参照してください。For more information about how enforced-notarization affects .NET Core (and your .NET Core apps), see Working with macOS Catalina Notarization.

libgdipluslibgdiplus

System.Drawing.Common アセンブリを使用する .NET Core アプリケーションでは、libgdiplus をインストールする必要があります。.NET Core applications that use the System.Drawing.Common assembly require libgdiplus to be installed.

libgdiplus を取得する簡単な方法は、macOS の Homebrew ("brew") パッケージ マネージャーを使用することです。An easy way to obtain libgdiplus is by using the Homebrew ("brew") package manager for macOS. brew をインストールしたら、端末 (コマンド) プロンプトで次のコマンドを実行して libgdiplus をインストールします。After installing brew, install libgdiplus by executing the following commands at a Terminal (command) prompt:

brew update
brew install mono-libgdiplus

インストーラーを使用してインストールするInstall with an installer

macOS には、.NET Core 3.1 SDK のインストールに使用できるスタンドアロン インストーラーが用意されています。macOS has standalone installers that can be used to install the .NET Core 3.1 SDK:

手動でダウンロードしてインストールするDownload and manually install

.NET Core 用 macOS インストーラーの代わりに、SDK とランタイムをダウンロードして手動でインストールすることもできます。As an alternative to the macOS installers for .NET Core, you can download and manually install the SDK and runtime. 手動インストールは、通常、継続的インテグレーション テストの一環として実行されます。Manual install is usually performed as part of continuous integration testing. 開発者またはユーザーの場合、通常はインストーラーを使用することをお勧めします。For a developer or user, it's generally better to use an installer.

.NET Core SDK をインストールする場合、対応するランタイムをインストールする必要はありません。If you install .NET Core SDK, you don't need to install the corresponding runtime. まず、次のいずれかのサイトから SDK またはランタイムのバイナリ リリースをダウンロードします。First, download a binary release for either the SDK or the runtime from one of the following sites:

次に、ダウンロードしたファイルを抽出し、export コマンドを使用して .NET Core で使用される変数を設定してから、.NET Core が PATH に含まれていることを確認します。Next, extract the downloaded file and use the export command to set variables used by .NET Core and then ensure .NET Core is in PATH.

ランタイムを抽出し、.NET Core CLI コマンドをターミナルで使用できるようにするには、最初に .NET Core のバイナリ リリースをダウンロードします。To extract the runtime and make the .NET Core CLI commands available at the terminal, first download a .NET Core binary release. 次に、ターミナルを開き、ファイルが保存されているディレクトリから次のコマンドを実行します。Then, open a terminal and run the following commands from the directory where the file was saved. アーカイブ ファイル名は、ダウンロードした内容によって異なる場合があります。The archive file name may be different depending on what you downloaded.

次のコマンドを使用して、ランタイムを抽出しますUse the following command to extract the runtime:

mkdir -p "$HOME/dotnet" && tar zxf aspnetcore-runtime-3.1.5-osx-x64.tar.gz -C "$HOME/dotnet"
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

次のコマンドを使用して、SDK を抽出しますUse the following command to extract the SDK:

mkdir -p "$HOME/dotnet" && tar zxf dotnet-sdk-3.1.301-osx-x64.tar.gz -C "$HOME/dotnet"
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

ヒント

上記の export コマンドでは、それを実行したターミナル セッションでのみ .NET Core CLI コマンドを使用できるようになります。The preceding export commands only make the .NET Core CLI commands available for the terminal session in which it was run.

シェル プロファイルを編集して、コマンドを永続的に追加することができます。You can edit your shell profile to permanently add the commands. Linux ではさまざまなシェルを使用でき、それぞれに異なるプロファイルがあります。There are a number of different shells available for Linux and each has a different profile. 次に例を示します。For example:

  • Bash シェル: ~/.bash_profile~/.bashrcBash Shell: ~/.bash_profile, ~/.bashrc
  • Korn シェル: ~/.kshrc または .profileKorn Shell: ~/.kshrc or .profile
  • Z シェル: ~/.zshrc または .zprofileZ Shell: ~/.zshrc or .zprofile

シェルの適切なソース ファイルを編集し、既存の PATH ステートメントの末尾に :$HOME/dotnet を追加します。Edit the appropriate source file for your shell and add :$HOME/dotnet to the end of the existing PATH statement. PATH ステートメントが含まれていない場合は、export PATH=$PATH:$HOME/dotnet を含む新しい行を追加します。If no PATH statement is included, add a new line with export PATH=$PATH:$HOME/dotnet.

また、ファイルの末尾に export DOTNET_ROOT=$HOME/dotnet を追加します。Also, add export DOTNET_ROOT=$HOME/dotnet to the end of the file.

この方法では、別々の場所に異なるバージョンをインストールして、どのアプリケーションにどれを使用するかを明示的に選択できます。This approach lets you install different versions into separate locations and choose explicitly which one to use by which application.

Visual Studio for Mac を使用してインストールするInstall with Visual Studio for Mac

Visual Studio for Mac では、 [.NET Core] ワークロードを選択すると、.NET Core SDK がインストールされます。Visual Studio for Mac installs the .NET Core SDK when the .NET Core workload is selected. macOS で .NET Core の開発を始めるには、「Visual Studio 2019 for Mac をインストールする」を参照してください。To get started with .NET Core development on macOS, see Install Visual Studio 2019 for Mac. 最新リリースである .NET Core 3.1 の場合は、Visual Studio for Mac 8.4 Preview を使用する必要があります。For the latest release, .NET Core 3.1, you must use the Visual Studio for Mac 8.4 Preview.

macOS Visual Studio 2019 for Mac と .NET Core ワークロード機能macOS Visual Studio 2019 for Mac with .NET Core workload feature

Visual Studio Code と共にインストールするInstall alongside Visual Studio Code

Visual Studio Code は、デスクトップ上で動作する強力で軽量なソース コード エディターです。Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code は、Windows、macOS、Linux で利用できます。Visual Studio Code is available for Windows, macOS, and Linux.

Visual Studio Code には、Visual Studio のような自動化された .NET Core インストーラーは付属していませんが、.NET Core のサポートを簡単に追加できます。While Visual Studio Code doesn't come with an automated .NET Core installer like Visual Studio does, adding .NET Core support is simple.

  1. Visual Studio Code をダウンロードしてインストールしますDownload and install Visual Studio Code.
  2. .NET Core SDK をダウンロードしてインストールしますDownload and install the .NET Core SDK.
  3. Visual Studio Code マーケットプレースから C# 拡張機能をインストールしますInstall the C# extension from the Visual Studio Code marketplace.

bash オートメーションを使用してインストールするInstall with bash automation

dotnet-install スクリプトは、ランタイムの自動化および管理者以外によるインストールに使用されます。The dotnet-install scripts are used for automation and non-admin installs of the runtime. スクリプトは、dotnet-install スクリプト参照ページからダウンロードできます。You can download the script from the dotnet-install script reference page.

スクリプトでは、既定で最新の 長期サポート (LTS) バージョン (.NET Core 3.1) がインストールされます。The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. current スイッチを指定することで、特定のリリースを選択できます。You can choose a specific release by specifying the current switch. ランタイムをインストールするには、runtime スイッチを含めます。Include the runtime switch to install a runtime. それ以外の場合は、スクリプトによって SDK がインストールされます。Otherwise, the script installs the SDK.

./dotnet-install.sh --channel 3.1 --runtime aspnetcore

注意

上のコマンドでは、互換性を最大限に高めるために ASP.NET Core ランタイムをインストールします。The command above installs the ASP.NET Core runtime for maximum compatability. ASP.NET Core ランタイムには、標準の .NET Core ランタイムも含まれています。The ASP.NET Core runtime also includes the standard .NET Core runtime.

DockerDocker

コンテナーを使用すると、アプリケーションをホスト システムの他の部分から簡単に分離できます。Containers provide a lightweight way to isolate your application from the rest of the host system. 同じコンピューター上のコンテナーでは、カーネルだけが共有され、アプリケーションに提供されたリソースが使用されます。Containers on the same machine share just the kernel and use resources given to your application.

.NET Core は Docker コンテナー内で実行できます。.NET Core can run in a Docker container. 公式の .NET Core Docker イメージは Microsoft Container Registry (MCR) に公開され、Microsoft .NET Core の Docker Hub リポジトリで見つけられます。Official .NET Core Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. 各リポジトリには、.NET (SDK またはランタイム) と自分が使用できる OS のさまざまな組み合わせのイメージが含まれています。Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.

Microsoft は、特定のシナリオに対応したイメージを用意しています。Microsoft provides images that are tailored for specific scenarios. たとえば、ASP.NET Core リポジトリには、運用環境での ASP.NET Core アプリの実行用にビルドされたイメージが用意されています。For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.

Docker コンテナー内で .NET Core を使用する方法の詳細については、「.NET および Docker の概要」とサンプルに関するページを参照してください。For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.

次の手順Next steps