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

Cet article explique comment installer .NET sur Debian. Lorsqu’une version Debian n’est plus prise en charge, .NET n’est plus pris en charge avec cette version. Toutefois, ces instructions peuvent vous aider à exécuter .NET sur ces versions, même si elles ne sont pas prises en charge.

Installez le SDK (qui inclut le runtime) si vous souhaitez développer des applications .NET. Ou, si vous n’avez besoin d’exécuter que 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 .NET et ASP.NET Core runtimes.

Si vous avez déjà installé le Kit de développement logiciel (SDK) ou runtime, utilisez les commandes et dotnet --list-runtimes les dotnet --list-sdks commandes pour voir quelles versions sont installées. Pour plus d’informations, consultez Comment vérifier que .NET est déjà installé.

Important

Les installations du gestionnaire de package sont uniquement prises en charge sur l’architecture x64 . D’autres architectures, telles que Arm, doivent installer .NET par d’autres moyens, comme Snap, un script d’installation ou via une installation binaire manuelle.

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

Distributions prises en charge

Le tableau suivant répertorie les versions actuellement prises en charge de .NET et les versions de Debian sur lesquelles elles sont prises en charge. Ces versions restent prises en charge jusqu’à ce que la version de .NET atteigne la fin de la prise en charge ou que la version de Debian atteigne la fin de vie.

  • Un ✔️ indique que la version de Debian ou .NET est toujours prise en charge.
  • Un ❌ indique que la version de Debian ou .NET n’est pas prise en charge sur cette version Debian.
  • Quand une version de Debian et une version de .NET sont toutes ✔️ deux prises en charge, cette combinaison de système d’exploitation et de .NET est prise en charge.
Debian .NET Core 3.1 .NET 6
✔️ 11 ✔️ 3.1 ✔️ 6.0
✔️ 10 ✔️ 3.1 ✔️ 6.0
✔️ 9 ✔️ 3.1 ✔️ 6.0
8 ❌ 3.1 ❌ 6.0

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

  • .NET 5
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Installer des versions préliminaires

Les versions préliminaires et release candidate de .NET ne sont pas disponibles dans les gestionnaires de package. Vous pouvez installer des préversions et des candidats de mise en production de .NET de l’une des manières suivantes :

Supprimer les versions en préversion

Lorsque vous utilisez un gestionnaire de package pour gérer votre installation de .NET, vous risquez de rencontrer un conflit si vous avez déjà installé une préversion. Le gestionnaire de package peut interpréter la version non préliminaire comme une version antérieure de .NET. Pour installer la version non préliminaire, désinstallez d’abord les versions préliminaires. Pour plus d’informations sur la désinstallation de .NET, consultez La procédure de suppression du runtime et du Kit de développement logiciel (SDK) .NET.

Debian 11 ✔️

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 de 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/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Installer le SDK

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

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

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package dotnet-sdk-6.0, consultez la section résolution des problèmes APT .

Installer le runtime

Le runtime ASP.NET Core vous permet d’exécuter des applications qui ont été effectué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-6.0

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package aspnetcore-runtime-6.0, consultez la section résolution des problèmes APT .

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

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

Debian 10 ✔️

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 de 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/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Installer le SDK

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

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

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package dotnet-sdk-6.0, consultez la section résolution des problèmes APT .

Installer le runtime

Le runtime ASP.NET Core vous permet d’exécuter des applications qui ont été effectué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-6.0

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package aspnetcore-runtime-6.0, consultez la section résolution des problèmes APT .

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

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

Debian 9 ✔️

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 de 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 -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/9/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

Installer le SDK

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

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

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package dotnet-sdk-6.0, consultez la section résolution des problèmes APT .

Installer le runtime

Le runtime ASP.NET Core vous permet d’exécuter des applications qui ont été effectué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-6.0

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package aspnetcore-runtime-6.0, consultez la section résolution des problèmes APT .

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

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

Debian 8 ❌

❌ Notez que cette version de Debian n’est plus prise en charge.

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 de package Microsoft à votre liste de clés approuvées et ajouter le référentiel de package.

Ouvrez un terminal et exécutez les commandes suivantes :

wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/8/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

Installer le SDK

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

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

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package dotnet-sdk-2.1, consultez la section résolution des problèmes APT .

Installer le runtime

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

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

Important

Si vous recevez un message d’erreur similaire à Impossible de localiser le package aspnetcore-runtime-2.1, consultez la section résolution des problèmes APT .

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

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

Comment installer d’autres versions

Toutes les versions de .NET sont disponibles pour le téléchargement https://dotnet.microsoft.com/download/dotnet, mais nécessitent une installation manuelle. Vous pouvez essayer et utiliser le gestionnaire de package pour installer une autre version de .NET. Toutefois, la version demandée peut ne pas être disponible.

Les packages ajoutés aux flux du gestionnaire de packages 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 Kit de développement logiciel (SDK) ou le runtime. Les options valides sont les suivantes :

    • SDK
    • runtime
  • version
    Version du Kit de développement logiciel (SDK) ou du runtime à installer. Cet article fournit toujours les instructions pour la dernière version prise en charge. Les options valides sont toutes les versions publiées, telles que :

    • 5,0
    • 3.1
    • 3.0
    • 2.1

    Il est possible que le SDK/runtime que vous essayez de télécharger n’est pas disponible pour votre distribution Linux. Pour obtenir la liste des distributions prises en charge, consultez Installer .NET sur Linux.

Exemples

  • Installez le runtime ASP.NET Core 5.0 :aspnetcore-runtime-5.0
  • Installez le runtime .NET Core 2.1 : dotnet-runtime-2.1
  • Installez le Kit de développement logiciel (SDK) .NET 5 : dotnet-sdk-5.0
  • Installez le Kit de développement logiciel (SDK) .NET Core 3.1 : dotnet-sdk-3.1

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) du Kit de développement logiciel (SDK) .NET sont inclus. La valeur aspnetcore-sdk-2.2 est incorrecte et doit être dotnet-sdk-2.2. Pour obtenir la liste des distributions Linux prises en charge par .NET, consultez les dépendances et les exigences .NET.

Utiliser APT pour mettre à jour .NET

Quand une nouvelle version de correctif est disponible pour .NET, vous pouvez simplement la mettre à niveau via APT avec les commandes suivantes :

sudo apt-get update
sudo apt-get upgrade

Si vous avez mis à niveau votre distribution Linux depuis l’installation de .NET, vous devrez peut-être reconfigurer le référentiel de package Microsoft. Exécutez les instructions d’installation de votre version de distribution actuelle pour effectuer une mise à niveau vers le référentiel de package approprié pour les mises à jour .NET.

Résolution des problèmes APT

Cette section fournit des informations sur les erreurs courantes que vous pouvez obtenir lors de l’utilisation d’APT pour installer .NET.

Impossible de trouver le package

Important

Les installations du gestionnaire de packages ne sont prises en charge que sur l’architecture x64 . D’autres architectures, telles que Arm, doivent installer .NET par d’autres moyens tels que Snap, un script d’installation ou via une installation binaire manuelle.

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

Impossible de localiser \ Certains packages n’ont pas pu être installés

Si vous recevez un message d’erreur similaire à Impossible de localiser le package {dotnet-package} ou Certains packages n’ont pas pu être installés, exécutez les commandes suivantes.

Il existe deux espaces réservés dans l’ensemble de commandes suivant.

  • {dotnet-package}
    Cela représente le package .NET que vous installez, par exemple aspnetcore-runtime-3.1. Ceci est utilisé dans la commande suivante sudo apt-get install .

  • {os-version}
    Cela représente la version de distribution sur laquelle vous êtes activé. Ceci est utilisé dans la wget commande ci-dessous. La version de distribution est la valeur numérique, telle que 20.04 sur Ubuntu ou 10 sur Debian.

Tout d’abord, essayez de purger la liste des packages :

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Ensuite, réessayez d’installer .NET. Si cela ne fonctionne pas, vous pouvez exécuter une installation manuelle avec les commandes suivantes :

sudo apt-get install -y gpg
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/{os-version}/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Échec de la récupération

Lors de l’installation du package .NET, vous pouvez voir une erreur similaire à Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Cette erreur peut signifier que le flux de package pour .NET est mis à niveau avec les versions plus récentes du package, et que vous devez réessayer ultérieurement. Pendant une mise à niveau, le flux de package ne doit pas être indisponible pendant plus de 30 minutes. Si vous recevez continuellement cette erreur pendant plus de 30 minutes, envoyez un problème à https://github.com/dotnet/core/issues.

Les dépendances

Lorsque vous installez avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Toutefois, si vous installez manuellement .NET Core ou que vous publiez une application autonome, vous devez vous assurer que ces bibliothèques sont installées :

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu52 (pour 8.x)
  • libicu57 (pour 9.x)
  • libicu63 (pour 10.x)
  • libicu67 (pour 11.x)
  • libssl1.0.0 (pour 8.x)
  • libssl1.1 (pour 9.x-11.x)
  • libstdc++6
  • zlib1g

Pour les applications .NET Core qui utilisent l’assembly System.Drawing.Common , vous avez également besoin de la dépendance suivante :

  • libgdiplus (version 6.0.1 ou ultérieure)

    Avertissement

    Vous pouvez installer une version récente de libgdiplus en ajoutant le référentiel Mono à votre système. Pour plus d’informations, consultez https://www.mono-project.com/download/stable/.

Étapes suivantes