Microsoft net framework mac os

Install .NET on macOS

In this article, you’ll learn how to install .NET on macOS. .NET is made up of the runtime and the SDK. The runtime is used to run a .NET app and may or may not be included with the app. The SDK is used to create .NET apps and libraries. The .NET runtime is always installed with the SDK.

The latest version of .NET is 5.0.

Supported releases

The following table is a list of currently supported .NET releases and the versions of macOS they’re supported on. These versions remain supported until the version of .NET reaches end-of-support.

• A вњ”пёЏ indicates that the version of .NET Core is still supported.
• A вќЊ indicates that the version of .NET Core isn’t supported.

Operating System	.NET Core 2.1	.NET Core 3.1	.NET 5.0
macOS 11.0 «Big Sur»	вњ”пёЏ 2.1 (Release notes)	вњ”пёЏ 3.1 (Release notes)	вњ”пёЏ 5.0 (Release notes)
macOS 10.15 «Catalina»	вњ”пёЏ 2.1 (Release notes)	вњ”пёЏ 3.1 (Release notes)	вњ”пёЏ 5.0 (Release notes)
macOS 10.14 «Mojave»	вњ”пёЏ 2.1 (Release notes)	вњ”пёЏ 3.1 (Release notes)	вњ”пёЏ 5.0 (Release notes)
macOS 10.13 «High Sierra»	вњ”пёЏ 2.1 (Release notes)	вњ”пёЏ 3.1 (Release notes)	вњ”пёЏ 5.0 (Release notes)
macOS 10.12 «Sierra»	вњ”пёЏ 2.1 (Release notes)	вќЊ 3.1 (Release notes)	вќЊ 5.0 (Release notes)

Unsupported releases

The following versions of .NET are вќЊ no longer supported. The downloads for these still remain published:

Runtime information

The runtime is used to run apps created with .NET. 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.

There are two different runtimes you can install on macOS:

ASP.NET Core runtime
Runs ASP.NET Core apps. Includes the .NET runtime.

.NET runtime
This runtime is the simplest runtime and doesn’t include any other runtime. It’s highly recommended that you install ASP.NET Core runtime for the best compatibility with .NET apps.

SDK information

The SDK is used to build and publish .NET apps and libraries. Installing the SDK includes both runtimes: ASP.NET Core and .NET.

Dependencies

.NET is supported on the following macOS releases:

A + symbol represents the minimum version.

.NET Core Version	macOS	Architectures	More information
5.0	High Sierra (10.13+)	x64	More information
3.1	High Sierra (10.13+)	x64	More information
3.0	High Sierra (10.13+)	x64	More information
2.2	Sierra (10.12+)	x64	More information
2.1	Sierra (10.12+)	x64	More information

Beginning with macOS Catalina (version 10.15), all software built after June 1, 2019 that is distributed with Developer ID, must be notarized. This requirement applies to the .NET runtime, .NET SDK, and software created with .NET.

The runtime and SDK installers for .NET 5.0 and .NET Core 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:

For more information about how enforced-notarization affects .NET (and your .NET apps), see Working with macOS Catalina Notarization.

libgdiplus

.NET applications that use the System.Drawing.Common assembly require libgdiplus to be installed.

An easy way to obtain libgdiplus is by using the Homebrew («brew») package manager for macOS. After installing brew, install libgdiplus by executing the following commands at a Terminal (command) prompt:

Install with an installer

macOS has standalone installers that can be used to install the .NET 5.0 SDK:

Download and manually install

As an alternative to the macOS installers for .NET, you can download and manually install the SDK and runtime. Manual installation is usually performed as part of continuous integration testing. For a developer or user, it’s generally better to use an installer.

First, download a binary release for either the SDK or the runtime from one of the following sites. If you install the .NET SDK, you will not need to install the corresponding runtime:

Next, extract the downloaded file and use the export command to set DOTNET_ROOT to the extracted folder’s location and then ensure .NET is in PATH. This should make the .NET CLI commands available at the terminal.

Alternatively, after downloading the .NET binary, the following commands may be run from the directory where the file is saved to extract the runtime. This will also make the .NET CLI commands available at the terminal and set the required environment variables. Remember to change the DOTNET_FILE value to the name of the downloaded binary:

The preceding export commands only make the .NET CLI commands available for the terminal session in which it was run.

You can edit your shell profile to permanently add the commands. There are a number of different shells available for Linux and each has a different profile. For example:

Bash Shell:

/.bashrc
Korn Shell:

/.kshrc or .profile
Z Shell:

Edit the appropriate source file for your shell and add :$HOME/dotnet to the end of the existing PATH statement. If no PATH statement is included, add a new line with export PATH=$PATH:$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.

Install with Visual Studio for Mac

Visual Studio for Mac installs the .NET SDK when the .NET workload is selected. To get started with .NET development on macOS, see Install Visual Studio 2019 for Mac.

.NET SDK version	Visual Studio version
5.0	Visual Studio 2019 for Mac version 8.8 or higher.
3.1	Visual Studio 2019 for Mac version 8.4 or higher.
2.1	Visual Studio 2019 for Mac version 8.0 or higher.

Install alongside Visual Studio Code

Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code is available for Windows, macOS, and Linux.

While Visual Studio Code doesn’t come with an automated .NET installer like Visual Studio does, adding .NET support is simple.

Install with bash automation

The dotnet-install scripts are used for automation and non-admin installs of the runtime. You can download the script from the dotnet-install script reference page.

The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. You can choose a specific release by specifying the current switch. Include the runtime switch to install a runtime. Otherwise, the script installs the SDK.

The previous command installs the ASP.NET Core runtime for maximum compatability. The ASP.NET Core runtime also includes the standard .NET runtime.

Docker

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 can run in a Docker container. Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.

Microsoft provides images that are tailored for specific scenarios. For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.

For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.

Источник

Установка .NET в macOS

В этой статье вы узнаете, как установить .NET в macOS. .NET состоит из среды выполнения и пакета SDK. Среда выполнения используется для запуска приложения .NET и может не включаться в состав приложения. Пакет SDK используется для создания приложений и библиотек .NET. Среда выполнения .NET всегда устанавливается вместе с пакетом SDK.

.NET 5.0 является последней версией.

Поддерживаемые выпуски

В приведенной ниже таблице содержится список поддерживаемых сейчас выпусков .NET и версий macOS, в которых они поддерживаются. Эти версии будут поддерживаться до окончания срока поддержки .NET.

• Значок ✔️ означает, что версия .NET Core поддерживается.
• Значок ❌️ означает, что версия .NET Core не поддерживается.

Операционная система	.NET Core 2.1	.NET Core 3.1	.NET 5.0
macOS 11.0 «Big Sur»	✔️ 2.1 (заметки о выпуске)	✔️ 3.1 (заметки о выпуске)	✔️ 5.0 (заметки о выпуске)
macOS 10.15 «Catalina»	✔️ 2.1 (заметки о выпуске)	✔️ 3.1 (заметки о выпуске)	✔️ 5.0 (заметки о выпуске)
macOS 10.14 «Mojave»	✔️ 2.1 (заметки о выпуске)	✔️ 3.1 (заметки о выпуске)	✔️ 5.0 (заметки о выпуске)
macOS 10.13 «High Sierra»	✔️ 2.1 (заметки о выпуске)	✔️ 3.1 (заметки о выпуске)	✔️ 5.0 (заметки о выпуске)
macOS 10.12 «Sierra»	✔️ 2.1 (заметки о выпуске)	❌ 3.1 (заметки о выпуске)	❌ 5.0 (заметки о выпуске)

Неподдерживаемые выпуски

Следующие версии .NET больше не поддерживаются (❌). (но остаются доступными для скачивания):

Сведения о среде выполнения

Среда выполнения используется для запуска приложений, созданных с помощью .NET. При публикации приложения автор может включить среду выполнения в его состав. В противном случае устанавливать среду выполнения будет пользователь.

В macOS можно установить две разные среды выполнения:

Среда выполнения ASP.NET Core
Используется для запуска приложений ASP.NET Core. Включает среду выполнения .NET.

Среда выполнения .NET
Простейшая среда выполнения, в состав которой не входят какие-либо другие среды выполнения. Чтобы обеспечить максимальный уровень совместимости с приложениями .NET, настоятельно рекомендуется устанавливать среду выполнения ASP.NET Core.

Сведения о пакете SDK

Пакет SDK используется для создания и публикации приложений и библиотек .NET. При установке пакета SDK также устанавливаются обе среды выполнения: ASP.NET Core и .NET.

Зависимости

Платформа .NET поддерживается в следующих выпусках macOS:

Символ + представляет минимальную версию.

Версия .NET Core	macOS	Архитектуры	Дополнительные сведения
5,0	High Sierra (10.13+)	X64	Дополнительные сведения
3.1	High Sierra (10.13+)	X64	Дополнительные сведения
3.0	High Sierra (10.13+)	X64	Дополнительные сведения
2.2	Sierra (10.12+)	X64	Дополнительные сведения
2.1	Sierra (10.12+)	X64	Дополнительные сведения

Начиная с macOS Catalina (версия 10.15) все программное обеспечение, созданное после 1 июня 2019 года и распространяемое с идентификатором разработчика, должно быть заверено. Это требование относится к среде выполнения .NET, пакету SDK для .NET и программному обеспечению, созданному с помощью .NET.

Среда выполнения и установщики пакета SDK для .NET версии 5.0 и .NET Core 3.1, 3.0 и 2.1 были заверены с 18 февраля 2020 г. Более ранние версии не заверены. При запуске незаверенного приложения появится ошибка, аналогичная следующей:

Дополнительные сведения о том, как принудительное заверение влияет на .NET (и ваши приложения .NET), см. в разделе Работа с заверением macOS Catalina.

libgdiplus

Приложения .NET, которые используют сборку System.Drawing.Common, требуют установки libgdiplus.

Легко получить libgdiplus можно с помощью диспетчера пакетов Homebrew («brew») для macOS. После установки brew установите libgdiplus, выполнив следующие команды в окне терминала (аналог командной строки):

Установка с помощью установщика

В macOS есть автономные установщики, которые можно использовать для установки пакета SDK для .NET 5.0:

Скачивание и установка вручную

В качестве альтернативы установщикам macOS для .NET можно скачать и вручную установить пакет SDK и среду выполнения. Установка вручную как правило выполняется в рамках тестирования непрерывной интеграции. В большинстве случаев разработчикам и пользователям рекомендуется использовать установщик.

Сначала скачайте двоичный выпуск пакета SDK или среды выполнения с одного из следующих сайтов. При установке пакета SDK для .NET не нужно устанавливать соответствующую среду выполнения:

Затем извлеките скачанный файл и используйте команду export , чтобы задать для переменной DOTNET_ROOT расположение извлеченной папки, а затем проверьте включение .NET в переменную PATH. После этого команды .NET CLI станут доступны в терминале.

Кроме того, после скачивания двоичного файла .NET можно выполнить следующие команды из каталога, в котором сохранен файл, для извлечения среды выполнения. После этого команды .NET CLI также станут доступны в терминале, и будут заданы нужные переменные среды. Обязательно измените значение DOTNET_FILE на имя скачанного двоичного файла:

Приведенные выше команды export сделают команды .NET CLI доступными только для сеанса терминала, в котором производился запуск.

Вы можете изменить профиль оболочки, чтобы добавить команды окончательно. Существует несколько различных оболочек, доступных для Linux, и каждая из них имеет свой профиль. Пример:

Оболочка Bash:

/.bashrc
Оболочка Korn:

/.kshrc или .profile
Оболочка Z:

Измените соответствующий исходный файл оболочки и добавьте :$HOME/dotnet в конец существующего оператора PATH . Если оператор PATH не указан, добавьте новую строку с export PATH=$PATH:$HOME/dotnet .

Кроме того, добавьте export DOTNET_ROOT=$HOME/dotnet в конец файла.

Такой подход позволяет устанавливать разные версии в отдельные расположения и выбирать, какие из них следует использовать для каждого приложения.

Установка с помощью Visual Studio для Mac

Visual Studio для Mac устанавливает пакет SDK для .NET, если выбрана рабочая нагрузка .NET. Чтобы приступить к разработке в .NET на macOS, ознакомьтесь со статьей Установка Visual Studio 2019 для Mac.

Версия пакета SDK для .NET	Версия Visual Studio
5,0	Visual Studio 2019 для Mac версии 8.8 или более поздней.
3.1	Visual Studio 2019 для Mac версии 8.4 или более поздней.
2.1	Visual Studio 2019 для Mac версии 8.0 или более поздней.

Установка вместе с Visual Studio Code

Visual Studio Code — это эффективный и облегченный редактор исходного кода, который работает на компьютере. Visual Studio Code доступен для Windows, macOS и Linux.

Хотя Visual Studio Code не поставляется с автоматическим установщиком .NET, таким как Visual Studio, добавление поддержки .NET не вызывает затруднений.

Установка с помощью функции автоматизации Bash

Сценарии dotnet-install используются для автоматизации установок среды выполнения и их осуществления без прав администратора. Вы можете скачать сценарий со страницы справочника по сценариям dotnet-install.

Этот сценарий по умолчанию устанавливает последнюю версию с долгосрочной поддержкой (LTS), которой сейчас является .NET Core 3.1. Вы можете выбрать конкретный выпуск, указав параметр current . Включите параметр runtime для установки среды выполнения. В противном случае сценарий устанавливает пакет SDK.

Приведенная выше команда устанавливает среду выполнения ASP.NET Core для максимальной совместимости. Среда выполнения ASP.NET Core также включает в себя стандартную среду выполнения .NET.

Docker

Контейнеры обеспечивают простой способ изоляции приложения от остальной части основной системы. Контейнеры на одном компьютере совместно использую только ядро, а также используют ресурсы, которые передаются в приложение.

.NET можно выполнять в контейнере Docker. Официальные образы Docker для .NET публикуются в реестре контейнеров Microsoft (MCR), и доступ к ним можно получить в репозитории Microsoft .NET Core Docker Hub. Каждый репозиторий содержит рабочие образы для разных сочетаний .NET (пакета SDK или среды выполнения) и операционной системы.

Корпорация Майкрософт предоставляет образы, которые предназначены для конкретных сценариев. Например репозиторий ASP.NET Core содержит образы, которые предназначены для запуска приложений ASP.NET Core в рабочей среде.

Дополнительные сведения об использовании .NET Core в контейнере Docker см. в статьях Введение в .NET и Docker и Примеры.

Источник