Partager via

Installer le Kit de développement logiciel (SDK) .NET ou le runtime .NET sur Ubuntu

  • Article

Cet article explique comment installer .NET sur Ubuntu.

Installez le SDK (qui inclut le runtime) si vous souhaitez développer des applications .NET. Ou, si vous avez uniquement besoin d’exécuter des applications, installez le runtime. Si vous installez le runtime, nous vous suggérons d’installer le runtime ASP.NET Core, car il inclut à la fois les runtimes .NET et ASP.NET Core.

Utilisez les commandes dotnet --list-sdks et dotnet --list-runtimes pour voir quelles versions sont installées. Pour plus d’informations, consultez Comment vérifier que .NET est déjà installé.

Important

L’utilisation d’un gestionnaire de package pour installer .NET à partir du flux de package Microsoft prend uniquement en charge l’architecture x64. Les autres architectures, comme Arm, ne sont pas prises en charge par le flux de package Microsoft. Utilisez les flux Ubuntu ou installez manuellement .NET. Faites attention aux problèmes de mélange de packages lors de l’utilisation de plusieurs flux. Pour plus d’informations, consultez Mélanges de packages .NET sur Linux.

Pour plus d’informations sur l’installation de .NET sans gestionnaire de package, consultez l’un des articles suivants :

Ubuntu 24.10

.NET est disponible dans les flux du gestionnaire de package Ubuntu. Le référentiel de packages Microsoft ne contient plus de packages .NET pour Ubuntu.

Les versions suivantes de .NET sont prises en charge ou disponibles pour Ubuntu 24.10 :

  • 9.0
  • 8.0

Important

.NET 9 est actuellement en préversion.

Lorsqu’une version Ubuntu n’est plus prise en charge, .NET n’est plus pris en charge avec cette version.

Installer le SDK

Le Kit de développement logiciel (SDK) .NET vous permet de développer des applications avec .NET. Si vous installez le SDK .NET, vous n’avez pas besoin d’installer le runtime correspondant. Pour installer le SDK .NET, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-9.0

Pour découvrir comment utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.

Installer le runtime

Le runtime ASP.NET Core vous permet d’exécuter des applications qui ont été développées avec .NET qui n’ont pas fourni le runtime. Les commandes suivantes installent le runtime ASP.NET Core, qui est le runtime le plus compatible pour .NET. Dans votre terminal, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-9.0

En guise d’alternative au runtime ASP.NET Core, vous pouvez installer le runtime .NET, qui n’inclut pas la prise en charge de ASP.NET Core : remplacez aspnetcore-runtime-9.0 dans la commande précédente par dotnet-runtime-9.0 :

sudo apt-get install -y dotnet-runtime-9.0

Pour découvrir comment utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Ubuntu 24.04

.NET est disponible dans les flux du gestionnaire de package Ubuntu ainsi que dans le dépôt de packages Microsoft. Toutefois, vous devez utiliser seulement l’un ou l’autre pour installer .NET. Microsoft vous recommande d’utiliser les flux du gestionnaire de package Ubuntu. Si vous souhaitez utiliser le dépôt de packages Microsoft, consultez Comment inscrire le dépôt de packages Microsoft.

Les versions suivantes de .NET sont prises en charge ou sont disponibles pour Ubuntu 24.04 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
backports
Flux Ubuntu		 Disponible dans
Flux Microsoft
8.0, 6.0 8.0 7.0, 6.0 Aucun

Lorsqu’une version Ubuntu n’est plus prise en charge, .NET n’est plus pris en charge avec cette version.

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Ubuntu 22.04

.NET est disponible dans les flux du gestionnaire de package Ubuntu ainsi que dans le dépôt de packages Microsoft. Toutefois, vous devez utiliser seulement l’un ou l’autre pour installer .NET. Microsoft vous recommande d’utiliser les flux du gestionnaire de package Ubuntu. Si vous souhaitez utiliser le dépôt de packages Microsoft, consultez Comment inscrire le dépôt de packages Microsoft.

Les versions suivantes de .NET sont prises en charge ou disponibles pour Ubuntu 22.04 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
8.0, 6.0 8.0, 7.0, 6.0 Aucun 8.0, 7.0, 6.0, 3.1

Important

Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 et Ubuntu 22.04, comprenez que les versions du SDK proposées par Canonical sont toujours dans la bande de fonctionnalités .1xx. Si vous souhaitez utiliser une version plus récente de la bande de fonctionnalités, utilisez le flux Microsoft pour installer le SDK. Veillez à consulter les informations de l’article Mélanges de packages .NET sur Linux pour comprendre les implications du basculement entre les flux de dépôt.

Lorsqu’une version Ubuntu n’est plus prise en charge, .NET n’est plus pris en charge avec cette version.

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu70
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Ubuntu 20.04

Le référentiel de packages Ubuntu par défaut ne contient pas cette version de .NET. Utilisez à la place le référentiel de packages Microsoft.

Les versions suivantes de .NET sont prises en charge ou disponibles pour Ubuntu 20.04 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
8.0, 6.0 None None 8.0, 7.0. 6.0, 5.0, 3.1, 2.1

Lorsqu’une version Ubuntu n’est plus prise en charge, .NET n’est plus pris en charge avec cette version.

Ajouter le dépôt de packages Microsoft

L’installation avec APT peut se faire à l’aide de quelques commandes. Avant d’installer .NET, exécutez les commandes suivantes pour ajouter la clé de signature du package Microsoft à votre liste de clés approuvées et ajouter le référentiel de packages.

Ouvrez un terminal et exécutez les commandes suivantes :

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu66
  • libssl1.1
  • libstdc++6
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Versions non prises en charge

Les versions suivantes de .NET ne sont ❌ plus prises en charge :

  • .NET 7
  • .NET 6 (à compter du 12 novembre 2024)
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Comment installer d’autres versions

Les noms de package .NET sont normalisés dans toutes les distributions Linux. Le tableau suivant liste les packages :

Toutes les versions de .NET peuvent être téléchargées sur la page https://dotnet.microsoft.com/download/dotnet, mais nécessitent une installation manuelle. Vous pouvez essayer d’utiliser le gestionnaire de package pour installer une autre version de .NET. Cependant, il est possible que la version demandée ne soit pas disponible.

Les packages ajoutés aux flux du gestionnaire de package sont nommés dans un format hackable, par exemple : {product}-{type}-{version}.

  • product
    Type de produit .NET à installer. Les options valides sont les suivantes :

    • dotnet
    • aspnetcore

  • type
    Choisit le SDK ou le runtime. Les options valides sont les suivantes :

    • sdk (disponible seulement pour le produit dotnet)
    • runtime

  • version
    Version du SDK ou du runtime à installer. Les options valides sont toutes les versions publiées, telles que :

    • 8.0
    • 6.0
    • 3.1
    • 2.1

    Il est possible que le Kit de développement logiciel (SDK) ou le runtime que vous essayez de télécharger ne soit pas disponible pour votre distribution Linux. Pour obtenir la liste des distributions prises en charge, consultez Installer .NET sur Linux.

Exemples

  • Installer le runtime ASP.NET Core 8.0 : aspnetcore-runtime-8.0
  • Installer le runtime .NET Core 2.1 : dotnet-runtime-2.1
  • Installer le SDK .NET 5 : dotnet-sdk-5.0
  • Installer le SDK .NET Core 3.1 : dotnet-sdk-3.1

Remarque

Certains packages peuvent ne pas être disponibles sur votre distribution Linux.

Package manquant

Si la combinaison de versions de package ne fonctionne pas, elle n’est pas disponible. Par exemple, il n’existe pas de Kit de développement logiciel (SDK) ASP.NET Core. Les composants du Kit de développement logiciel (SDK) pour ASP.NET Core sont inclus dans le Kit de développement logiciel (SDK) .NET. La valeur aspnetcore-sdk-8.0 est incorrecte et doit être dotnet-sdk-8.0. Pour obtenir la liste des distributions Linux prises en charge par .NET, consultez Dépendances et exigences de .NET.

Installation manuelle

Si votre version d’Ubuntu n’est pas prise en charge, vous devez probablement installer .NET en extrayant manuellement les fichiers binaires en utilisant le script d’installation. Pour plus d’informations, consultez Installer .NET sur Linux sans utiliser un gestionnaire de package.

Ubuntu 23.10

Avertissement

Cette version d’Ubuntu n’est plus prise en charge.

L’exécution de .NET sur cette version d’Ubuntu n’est plus prise en charge.

.NET est disponible dans les flux du gestionnaire de package Ubuntu ainsi que dans le dépôt de packages Microsoft. Toutefois, vous devez utiliser seulement l’un ou l’autre pour installer .NET. Microsoft vous recommande d’utiliser les flux du gestionnaire de package Ubuntu. Si vous souhaitez utiliser le dépôt de packages Microsoft, consultez Comment inscrire le dépôt de packages Microsoft.

Les versions suivantes de .NET ont été prises en charge ou disponibles pour Ubuntu 23.10 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
8.0, 6.0 8.0, 7.0, 6.0 Aucun 8.0, 7.0, 6.0

Important

Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 et Ubuntu 22.04, comprenez que les versions du SDK proposées par Canonical sont toujours dans la bande de fonctionnalités .1xx. Si vous souhaitez utiliser une version plus récente de la bande de fonctionnalités, utilisez le flux Microsoft pour installer le SDK. Veillez à consulter les informations de l’article Mélanges de packages .NET sur Linux pour comprendre les implications du basculement entre les flux de dépôt.

Lorsqu’une version Ubuntu n’est plus prise en charge, .NET n’est plus pris en charge avec cette version.

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Ubuntu 23.04

Avertissement

Cette version d’Ubuntu n’est plus prise en charge.

L’exécution de .NET sur cette version d’Ubuntu n’est plus prise en charge.

.NET est disponible dans les flux du gestionnaire de package Ubuntu ainsi que dans le dépôt de packages Microsoft. Toutefois, vous devez utiliser seulement l’un ou l’autre pour installer .NET. Microsoft vous recommande d’utiliser les flux du gestionnaire de package Ubuntu. Si vous souhaitez utiliser le dépôt de packages Microsoft, consultez Comment inscrire le dépôt de packages Microsoft.

Les versions suivantes de .NET ont été prises en charge ou disponibles pour Ubuntu 23.04 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
8.0, 6.0 7.0, 6.0 Aucun 8.0, 7.0, 6.0

Important

Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 et Ubuntu 22.04, comprenez que les versions du SDK proposées par Canonical sont toujours dans la bande de fonctionnalités .1xx. Si vous souhaitez utiliser une version plus récente de la bande de fonctionnalités, utilisez le flux Microsoft pour installer le SDK. Veillez à consulter les informations de l’article Mélanges de packages .NET sur Linux pour comprendre les implications du basculement entre les flux de dépôt.

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Ubuntu 22.10

Avertissement

Cette version d’Ubuntu n’est plus prise en charge.

L’exécution de .NET sur cette version d’Ubuntu n’est plus prise en charge.

.NET est disponible dans les flux du gestionnaire de package Ubuntu ainsi que dans le dépôt de packages Microsoft. Toutefois, vous devez utiliser seulement l’un ou l’autre pour installer .NET. Microsoft vous recommande d’utiliser les flux du gestionnaire de package Ubuntu. Si vous souhaitez utiliser le dépôt de packages Microsoft, consultez Comment inscrire le dépôt de packages Microsoft.

Les versions suivantes de .NET sont prises en charge ou disponibles pour Ubuntu 22.10 :

Versions .NET prises en charge Disponible dans
flux Ubuntu intégré		 Disponible dans
Rétroports .NET
Flux Ubuntu		 Disponible dans
Flux Microsoft
6.0 7.0, 6.0 Aucun 7.0, 6.0, 3.1

Important

Si vous utilisez le Kit de développement logiciel (SDK) .NET 8 et Ubuntu 22.04, comprenez que les versions du SDK proposées par Canonical sont toujours dans la bande de fonctionnalités .1xx. Si vous souhaitez utiliser une version plus récente de la bande de fonctionnalités, utilisez le flux Microsoft pour installer le SDK. Veillez à consulter les informations de l’article Mélanges de packages .NET sur Linux pour comprendre les implications du basculement entre les flux de dépôt.

Non disponible.

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Si vous installez manuellement .NET ou si vous publiez une application autonome, vous devrez toutefois vous assurer que les bibliothèques suivantes sont installées :

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu71
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Les dépendances peuvent être installées avec la commande apt install. L’extrait de code suivant illustre l’installation de la bibliothèque zlib1g :

sudo apt install zlib1g

Si l’application .NET utilise l’assembly System.Drawing.Common, libgdiplus doit également être installé. Étant donné que System.Drawing.Common n’est plus pris en charge sur Linux, cela fonctionne uniquement sur .NET 6 et nécessite de définir le commutateur de configuration du runtime System.Drawing.EnableUnixSupport.

Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système.

Étapes suivantes