Bien démarrer avec dotnetup

Note

dotnetup est disponible en préversion publique. Ses fonctionnalités et son comportement peuvent changer avant la disponibilité générale.

dotnetupest un gestionnaire de chaîne d’outils multiplateforme pour les installations de .NET au niveau de l’utilisateur. Il installe, met à jour et supprime .NET sdk et runtimes sans utiliser de gestionnaire de package système.

Prerequisites

  • L’un des systèmes d’exploitation et l’une des architectures suivants :

    Système d'exploitation Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), tel que Alpine Linux x64, Arm64

  • Un Terminal.

  • Bash sur macOS ou Linux, ou PowerShell sur Windows, pour exécuter le script de téléchargement.

  • Sur macOS ou Linux, curl ou wget pour télécharger des fichiers, et sha512sum ou shasum pour les vérifier.

dotnetup a la même configuration système requise pour le système d’exploitation que le .NET Runtime. Pour connaître les exigences spécifiques au système d’exploitation, consultez Installer .NET sur Windows, Installer .NET sur macOS ou Installer .NET sur Linux.

Important

Sur Windows, la configuration par défaut utilise le everywhere mode d’accès. Ce mode :

  • Nécessite une élévation pour mettre à jour le système PATH.
  • Rend l’installation gérée par dotnetup prioritaire sur les installations de .NET à l’échelle de l’ordinateur, telles que celles que Visual Studio installe. Les projets et applications qui nécessitent un SDK ou un runtime à l’échelle de l’ordinateur qui n’est pas également installé par dotnetup échouent à se générer ou à s’exécuter.
  • Modifie le système PATH, qui s’applique à tous les utilisateurs. Les processus élevés que les autres utilisateurs démarrent peuvent localiser .NET à partir de votre profil utilisateur.

Pour éviter ces effets, choisissez le mode d’accès shell ou none lors de la configuration. Si vous choisissez everywhere, migrez vos installations existantes lorsque le programme d’installation vous le propose. Pour plus d’informations, consultez considérations relatives au mode Partout.

Télécharger dotnetup

Les scripts de téléchargement installent la dernière preview build par défaut. Ils vérifient l’exécutable téléchargé avec sa somme de contrôle SHA-512 et l’installent dans ~/.dotnetup.

Sur macOS ou Linux, exécutez :

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Sur Windows, exécutez :

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Pour installer la dernière daily build sur macOS ou Linux, exécutez :

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Pour installer la dernière daily build sur Windows, exécutez :

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

Les builds quotidiens n’ont pas terminé la validation de publication et ne sont pas signés numériquement. Utilisez des builds quotidiens uniquement pour les tests de courte durée.

Les scripts impriment des instructions pour ajouter dotnetup à PATH. Ouvrez un nouveau terminal après avoir appliqué les instructions.

Effectuer la configuration initiale

Exécutez la configuration interactive :

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Les chemins d’accès, l’affichage de progression et les conseils d’environnement dépendent de votre système et du mode sélectionné.

Le mode d’accès recommandé est everywhere sur Windows. Sur macOS et Linux, c’est shell lorsque dotnetup détecte un interpréteur de commandes pris en charge et none sinon.

Sélectionnez Non, personnalisez le programme d’installation pour choisir le canal du Kit de développement logiciel (SDK), le mode d’accès et les options de migration.

Choisir un canal de diffusion SDK

Un canal sdk indique dotnetup le SDK à installer et comment le mettre à jour.

Formulaire du channel Exemple Result
Dernière version stable latest Dernier SDK stable actif
Dernière version LTS lts Dernier SDK LTS stable actif
Dernier aperçu preview Le dernier SDK en version préliminaire
Dernière version quotidienne daily Dernier SDK disponible quotidiennement
Majeur 10 Dernier SDK pour la version majeure spécifiée
Major et mineur 10.0 Dernier KIT SDK pour la version principale et mineure spécifiée
Bande de fonctionnalités 10.0.1xx Dernier SDK dans la bande de fonctionnalités spécifiée
Version exacte 10.0.103 Uniquement la version du SDK spécifiée
Aucun SDK initial none Ignorer l’installation pendant la configuration

Les versions exactes ne sont pas avancées pendant les mises à jour. Pour tous les formats acceptés, consultez les canaux et versions de dotnetup.

Choisir comment accéder à .NET

Le mode d’accès contrôle la façon dont les terminaux et les applications recherchent l’installation .NET gérée par dotnetup.

Mode d’accès Behavior
none Ne modifie pas ces variables d’environnement. Exécutez .NET avec dotnetup dotnet.
shell Modifie le profil d’interpréteur de commandes pour définir ces variables d’environnement. Les processus démarrés à partir de cet interpréteur de commandes utilisent les sdk .NET et les runtimes installés par dotnetup.
everywhere Modifie le système PATH et définit la variable d’environnement utilisateur de niveau DOTNET_ROOT. Disponible uniquement sur Windows.

Pour plus d’informations et considérations relatives au everywhere mode, consultez la configuration de l’environnement dotnetup.

Migrer des installations existantes

Le programme d’installation peut proposer de migrer les installations existantes du KIT de développement logiciel .NET (SDK) et du runtime à l’échelle de l’ordinateur vers l’installation gérée par dotnetup. Consultez les considérations relatives au mode Partout pour comprendre pourquoi la migration est particulièrement importante avec everywhere le mode.

Vérifier l’installation

Ouvrez un nouveau terminal après que l’installation a modifié votre environnement.

Pour le mode shell ou everywhere, exécutez :

dotnet --version
dotnetup list

Pour le mode none, exécutez :

dotnetup dotnet -- --version
dotnetup list

Réexécutez dotnetup init pour modifier la configuration.

  • Dernière mise à jour :