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

• Install на Windows
• Установка в macOS
• Установка на Linux

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

Последняя версия .NET — 10.

Download .NET

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

В следующей таблице перечислены поддерживаемые .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 "Сонома"	9.0, 8.0

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

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

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

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

Существует две среды выполнения, которые можно установить в macOS, и оба входят в пакет SDK.

• ASP.NET Core Runtime
  Запускает ASP.NET Core приложения. Включает среду выполнения .NET. Недоступно в качестве установщика.

• .NET Runtime
  Это запускает обычные .NET приложения, но не специализированные приложения, такие как приложения, созданные на основе ASP.NET Core.

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

Установка пакета SDK включает как стандартную среду выполнения .NET, так и среду выполнения ASP.NET Core. Например, если установлен пакет SDK 9.0 .NET, то установлены .NET Runtime 9.0 и ASP.NET Core 9.0 Runtime. Однако любая другая версия среды выполнения не будет установлена с пакетом SDK и потребует отдельной установки.

Выбор способа установки .NET

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

Если вы не уверены, какой метод следует выбрать после просмотра списков в следующих разделах, вы, вероятно, хотите использовать пакет установщика .NET.

Разработчикам

• Visual Studio Code — набор средств разработки на C#

  Установите расширение C#Dev Kit для Visual Studio Code разработки приложений .NET. Расширение может использовать уже установленный пакет SDK или установить его для вас.

Пользователи и разработчики

• установщик .NET

  Используйте автономный установщик для установки .NET. Этот метод является типичным способом установки .NET на компьютере разработчика или пользователя.

• Install .NET со скриптом

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

• Install .NET вручную

  Используйте этот метод установки, если необходимо установить .NET в определенную папку и запустить его отдельно от других копий .NET.

Установка .NET

Пакеты установщика доступны для macOS, простой способ установки .NET.

1. Откройте веб-браузер и перейдите по адресу https://dotnet.microsoft.com/download/dotnet.

2. Выберите ссылку на версию .NET, которую вы хотите установить, например .NET 10.0.

   

   Эта ссылка приводит вас на страницу со ссылками для скачивания этой версии .NET

   Если вы собираетесь установить пакет SDK, выберите последнюю версию .NET. Пакет SDK поддерживает создание приложений для предыдущих версий .NET.

   Совет

   Если вы не уверены, какую версию нужно скачать, выберите последнюю версию.

3. На этой странице представлены ссылки на скачивание пакета SDK и среды выполнения. Здесь вы скачайте пакет SDK .NET или среду выполнения .NET.

   

   На предыдущем изображении выделено два раздела. Если вы скачиваете набор SDK, обратитесь к разделу 1. Сведения о среде выполнения .NET см. в разделе 2.

   • Раздел 1 (ПАКЕТ SDK)

     Этот раздел — это область загрузки пакета SDK. В столбце установщиков для строки macOS перечислены две архитектуры: Arm64 и x64.

     • Если вы используете процессор Apple, например M1 или M3 Pro, выберите Arm64.
     • Если вы используете процессор Intel, выберите x64.

   • Раздел 2 (время выполнения)

     Этот раздел содержит загрузки среды выполнения. Обратите внимание, что ссылки на столбец установщиков в строке macOS пусты! Этот раздел пуст, так как среда выполнения ASP.NET Core предоставляется только в пакете SDK или через бинариную установку.

     Прокрутите вниз, чтобы найти стандартную .NET Runtime для скачивания.

     

     • Если вы используете процессор Apple, например M1 или M3 Pro, выберите Arm64.
     • Если вы используете процессор Intel, выберите x64.

4. После завершения скачивания откройте его.

5. Выполните действия в установщике.

   

Установка .NET вручную

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

Совет

Используйте скрипт install-dotnet.sh для автоматического выполнения этих действий.

1. Откройте веб-браузер и перейдите по адресу https://dotnet.microsoft.com/download/dotnet.

2. Выберите ссылку на версию .NET, которую вы хотите установить, например .NET 8.0.

   Эта ссылка приводит вас на страницу со ссылками для скачивания этой версии .NET

   Если вы собираетесь установить пакет SDK, выберите последнюю версию .NET. Пакет SDK поддерживает создание приложений для предыдущих версий .NET.

   Совет

   Если вы не уверены, какую версию нужно скачать, выберите последнюю версию.

   

3. Выберите ссылку на пакет SDK или среду выполнения, которую вы хотите установить. Найдите столбец Двоичных файлов в строке macOS.

   

   • Если вы используете процессор Apple, например M1 или M3 Pro, выберите Arm64.
   • Если вы используете процессор Intel, выберите x64.

4. Откройте терминал и перейдите к месту загрузки .NET двоичного файла.

5. Извлеките тарбол, чтобы .NET в системе. В следующем примере используется .

   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
   

Ниже приведены все команды в виде одного скрипта bash:

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

Проверьте .NET, перейдя в папку ~/.dotnet и выполнив команду dotnet --info:

chdir ~/.dotnet
./dotnet --info

Внимание

Некоторые программы могут использовать переменные среды для поиска .NET в системе, а команда dotnet может не работать при открытии нового терминала. Сведения об устранении этой проблемы см. в разделе Make .NET доступной системы.

Установка .NET для Visual Studio Code

Visual Studio Code — это мощный и упрощенный редактор исходного кода, который работает на рабочем столе. Visual Studio Code можно использовать пакет SDK, уже установленный в вашей системе. Кроме того, расширение C# Dev Kit установит .NET, если он еще не установлен.

Инструкции по установке .NET через Visual Studio Code см. в разделе Getting Started with C# в VS Code.

Заверение

Программное обеспечение, созданное для macOS, распределенное с идентификатором разработчика, должно быть нотировано, включая приложения, созданные с помощью .NET.

Если вы запускаете неунарное приложение, отобразится окно ошибки, аналогичное следующему изображению:

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

Проверка

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

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

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. Страница заметок о выпуске .NET 9 на GitHub в https://github.com/dotnet/core/tree/main/release-notes/9.0#releases содержит раздел с именем Releases. Таблица в этом разделе ссылается на файлы загрузки и контрольные суммы для каждого выпуска .NET 9. На следующем рисунке показана таблица выпуска .NET 8 в качестве ссылки:

   

2. Выберите ссылку для версии .NET, которую вы скачали.

   В предыдущем разделе используется пакет SDK .NET 9.0.306, который находится в выпуске .NET 9.0.10.

3. На странице выпуска вы увидите версию пакета SDK для среды выполнения .NET и .NET и ссылку на файл контрольной суммы. На следующем рисунке показана таблица выпуска .NET 8 в качестве ссылки:

   

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
   

Компьютеры Mac на основе процессоров Arm

В следующих разделах описаны вещи, которые следует учитывать при установке .NET на компьютере Mac на основе Arm.

Различия в путях

На компьютере Mac на основе Arm все версии Arm64 .NET устанавливаются в обычную папку /usr/local/share/dotnet/. Однако при установке x64 версии пакета SDK .NET он устанавливается в папку /usr/local/share/dotnet/x64/dotnet/.

Переменные пути

Переменные среды, добавляющие .NET в системный путь, например переменную PATH, может потребоваться изменить, если у вас установлены версии пакета SDK для .NET x64 и Arm64. Кроме того, некоторые средства используют переменную среды DOTNET_ROOT, которая также должна быть обновлена, чтобы указать соответствующую папку установки пакета SDK .NET.

Устранение неполадок

Ниже приведены разделы, которые помогут устранить неполадки.

• Компьютеры Mac на основе Arm
• Make .NET доступны

Сделать .NET доступным для всей системы

Иногда приложения в системе, включая терминал, необходимо найти место установки .NET. Пакет установщика .NET macOS Installer должен автоматически настроить систему. Однако если вы использовали метод установки мануальный метод установки или скрипт установки .NET, необходимо добавить каталог, в который .NET был установлен в переменную PATH.

Некоторые приложения могут искать переменную DOTNET_ROOT при попытке определить, где установлен .NET.

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

• Оболочка Bash: ~/.profile, /etc/profile
• Оболочка Korn: ~/.kshrc или .profile
• Оболочка Z: ~/.zshrc или .zprofile

Задайте следующие две переменные среды в профиле оболочки:

• DOTNET_ROOT

  Эта переменная установлена в папку .NET, например $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Эта переменная должна включать как папку, DOTNET_ROOT так и папку DOTNET_ROOT/tools :

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

Связанный контент

• How, чтобы проверить, уже ли установлен .NET.
• Работа с заверением macOS Catalina.
• Tutorial: создание консольного приложения .NET.
• Tutorial: контейнеризация приложения .NET.