Installer .NET sur macOS

Dans cet article, vous allez apprendre à installer .NET sur macOS. .NET est constitué du runtime et du kit SDK. Le runtime est utilisé pour exécuter une application .NET et peut être inclus avec l’application ou pas. Le kit SDK est utilisé pour créer des applications et des bibliothèques .NET. Le runtime .NET est toujours installé avec le kit SDK.

La dernière version de .NET est 5,0.

Versions prises en charge

Le tableau suivant répertorie les versions de .NET actuellement prises en charge et les versions de macOS sur lesquelles elles sont prises en charge. Ces versions restent prises en charge jusqu’à la fin de la prise en chargede la version de .net.

  • Une ✔️ indique que la version de .NET Core est toujours prise en charge.
  • Une ❌ indique que la version de .net Core n’est pas prise en charge.
Système d’exploitation .NET Core 2.1 .NET Core 3.1 .NET 5.0
macOS 11,0 « Big sur » ✔️ 2,1 (notes de publication) ✔️ 3,1 (notes de publication) ✔️ 5,0 (notes de publication)
macOS 10.15 « Catalina » ✔️ 2,1 (notes de publication) ✔️ 3,1 (notes de publication) ✔️ 5,0 (notes de publication)
macOS 10.14 « Mojave » ✔️ 2,1 (notes de publication) ✔️ 3,1 (notes de publication) ✔️ 5,0 (notes de publication)
macOS 10.13 « High Sierra » ✔️ 2,1 (notes de publication) ✔️ 3,1 (notes de publication) ✔️ 5,0 (notes de publication)
macOS 10.12 "Sierra" ✔️ 2,1 (notes de publication) ❌ 3,1 (notes de publication) ❌ 5,0 (notes de publication)

Mises en production non prises en charge

Les versions suivantes de .NET ne sont ❌ plus prises en charge. Les téléchargements sont toujours publiés :

Informations d’exécution

Le runtime est utilisé pour exécuter des applications créées avec .NET. Quand un auteur d’application publie une application, il peut inclure le Runtime avec son application. Si elles n’incluent pas le runtime, c’est à l’utilisateur d’installer le Runtime.

Il existe deux runtimes différents que vous pouvez installer sur macOS :

  • runtime ASP.NET Core
    exécute ASP.NET Core applications. Comprend le Runtime .NET.

  • Runtime .NET
    Ce Runtime est le runtime le plus simple et n’inclut pas d’autre Runtime. il est fortement recommandé d’installer ASP.NET Core runtime pour une meilleure compatibilité avec les applications .net.

Informations sur le SDK

Le kit de développement logiciel (SDK) est utilisé pour générer et publier des applications et des bibliothèques .NET. l’installation du kit de développement logiciel (SDK) comprend les deux runtimes: ASP.NET Core et .net.

Dépendances

.NET est pris en charge sur les versions macOS suivantes :

Notes

Un + symbole représente la version minimale.

Version de .NET Core macOS Architectures Plus d’informations
5.0 High Sierra (10.13 +) x64 Plus d’informations
3.1 High Sierra (10.13 +) x64 Plus d’informations
3.0 High Sierra (10.13 +) x64 Plus d’informations
2.2 Sierra (10.12 +) x64 Plus d’informations
2.1 Sierra (10.12 +) x64 Plus d’informations

À partir de macOS Catalina (version 10,15), tous les logiciels générés après le 1er juin 2019, qui sont distribués avec l’ID de développeur, doivent être certifiés. Cette exigence s’applique au Runtime .NET, au kit de développement logiciel (SDK) .NET et aux logiciels créés avec .NET.

Les programmes d’installation du runtime et du SDK pour .NET 5,0 et .NET Core 3,1, 3,0 et 2,1 ont été certifiés depuis le 18 février 2020. Les versions antérieures publiées ne sont pas certifiées. Si vous exécutez une application non authentifiée, une erreur semblable à l’image suivante s’affiche :

alerte de notaire Catalina macOS

Pour plus d’informations sur la façon dont l’application de la notaire affecte .NET (et vos applications .NET), consultez utilisation de la méthode de notaire Catalina MacOS.

libgdiplus

Les applications .NET qui utilisent l’assembly System. Drawing. Common nécessitent l’installation de libgdiplus.

pour obtenir facilement des libgdiplus, vous pouvez utiliser le gestionnaire de package Homebrew (« brass ») pour macOS. Après l’installation de la commande infuse, installez libgdiplus en exécutant les commandes suivantes à une invite de commandes :

brew update
brew install mono-libgdiplus

Installer avec un programme d’installation

macOS possède des programmes d’installation autonomes qui peuvent être utilisés pour installer le kit de développement logiciel (SDK) .NET 5,0 :

Télécharger et installer manuellement

Comme alternative aux programmes d’installation macOS pour .NET, vous pouvez télécharger et installer manuellement le kit de développement logiciel (SDK) et le Runtime. L’installation manuelle est généralement effectuée dans le cadre du test d’intégration continue. Pour un développeur ou un utilisateur, il est généralement préférable d’utiliser un programme d’installation.

Tout d’abord, téléchargez une version binaire pour le kit de développement logiciel (SDK) ou le runtime à partir de l’un des sites suivants. Si vous installez le kit de développement logiciel (SDK) .NET, vous n’aurez pas besoin d’installer le runtime correspondant :

Ensuite, extrayez le fichier téléchargé et utilisez la export commande pour définir DOTNET_ROOT l’emplacement du dossier extrait, puis vérifiez que .net est dans le chemin d’accès. Les commandes de l’interface CLI .NET doivent donc être disponibles sur le terminal.

Sinon, après avoir téléchargé le fichier binaire .NET, les commandes suivantes peuvent être exécutées à partir du répertoire dans lequel le fichier est enregistré pour extraire le Runtime. Cela rend également les commandes de l’interface de commande .NET CLI disponibles sur le terminal et définissent les variables d’environnement requises. N’oubliez pas de remplacer la DOTNET_FILE valeur par le nom du fichier binaire téléchargé:

DOTNET_FILE=dotnet-sdk-5.0.302-osx-x64.tar.gz
export DOTNET_ROOT=$(pwd)/dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT

Conseil

Les export commandes précédentes rendent uniquement les commandes de l’interface de commande .net CLI disponibles pour la session Terminal dans laquelle elle a été exécutée.

Vous pouvez modifier votre profil de Shell pour ajouter définitivement les commandes. Un certain nombre de shells différents sont disponibles pour Linux et chacun d’eux a un profil différent. Par exemple :

  • Interpréteur de commandes bash : ~/.bash_profile, ~ fichier/.bashrc
  • Shell Korn: ~/.kshrc ou . Profile
  • Z Shell: ~/.zshrc ou . zprofile

Modifiez le fichier source approprié pour votre shell et ajoutez :$HOME/dotnet à la fin de l' PATH instruction existante. Si aucune PATH instruction n’est incluse, ajoutez une nouvelle ligne avec export PATH=$PATH:$HOME/dotnet .

Ajoutez également export DOTNET_ROOT=$HOME/dotnet à la fin du fichier.

Cette approche vous permet d’installer différentes versions dans des emplacements distincts et de choisir explicitement celle qui doit être utilisée par l’application.

installer avec Visual Studio pour Mac

Visual Studio pour Mac installe le kit de développement logiciel (SDK) .net lorsque la charge de travail .net est sélectionnée. pour commencer à utiliser le développement .net sur macOS, consultez installer Visual Studio 2019 pour Mac.

Version du Kit de développement logiciel (SDK) .NET Version de Visual Studio
5.0 Visual Studio 2019 pour Mac version 8,8 ou ultérieure.
3.1 Visual Studio 2019 pour Mac version 8,4 ou ultérieure.
2.1 Visual Studio 2019 pour Mac version 8,0 ou ultérieure.

fonctionnalité de charge de travail macOS Visual Studio 2019 pour Mac avec .net

Installer en même temps que Visual Studio Code

Visual Studio Code est un éditeur de Code source puissant et léger qui s’exécute sur votre bureau. Visual Studio Code est disponible pour Windows, macOS et Linux.

même si Visual Studio Code n’est pas fourni avec un programme d’installation automatisé de .net comme Visual Studio, l’ajout de la prise en charge de .net est simple.

  1. Téléchargez et installez Visual Studio code.
  2. Téléchargez et installez le kit de développement logiciel (SDK) .net.
  3. installez l’extension C# à partir de la place de marché Visual Studio Code.

Installer avec l’automatisation bash

Les scripts dotnet-install sont utilisés pour l’automatisation et les installations non administratives du Runtime. Vous pouvez télécharger le script à partir de la page de référence du script dotnet-install.

Par défaut, le script installe la dernière version de support à long terme (LTS) , qui est .net Core 3,1. Vous pouvez choisir une version spécifique en spécifiant le current commutateur. Incluez le runtime commutateur pour installer un Runtime. Dans le cas contraire, le script installe le Kit de développement logiciel (SDK).

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

Notes

la commande précédente installe le runtime ASP.NET Core pour une compatibilité maximale. le runtime ASP.NET Core comprend également le runtime .net standard.

Docker

Les conteneurs offrent un moyen léger d’isoler votre application du reste du système hôte. Les conteneurs sur le même ordinateur partagent simplement le noyau et utilisent les ressources fournies à votre application.

.NET peut s’exécuter dans un conteneur d’ancrage. les images officielles de la station d’accueil .net sont publiées dans le Microsoft Container Registry (MCR) et peuvent être découvrables dans le référentiel du Hub de l' ancreur principal Microsoft .NET. Chaque référentiel contient des images pour différentes combinaisons possibles de .NET (kit de développement logiciel ou runtime) et du système d’exploitation.

Microsoft fournit des images adaptées à des scénarios particuliers. Par exemple, celles du référentiel ASP.NET Core sont conçues pour exécuter des applications ASP.NET Core en production.

Pour plus d’informations sur l’utilisation de .NET Core dans un conteneur d’ancrage, consultez Introduction à .net et à l’ancreur et aux exemples.

Étapes suivantes