Vue d’ensemble de 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 .NET sdk et runtimes sans écrire dans un répertoire .NET géré par le système. Il suit également les options d’installation que vous sélectionnez afin qu’il puisse mettre à jour ou supprimer les fichiers associés ultérieurement.

Utiliser dotnetup pour :

• Installez des versions stables, en préversion, journalières ou exactes de .NET.
• Conservez les prérequis de plusieurs SDK et runtimes dans une installation gérée.
• Installez le Kit de développement logiciel (SDK) requis par le fichier global.json le plus proche.
• Mettez à jour les canaux suivis sans modifier les exigences de version exacte.
• Configurez la façon dont les terminaux et les applications recherchent l’élément géré dotnet.
• Exécutez l’instance gérée dotnet sans modifier PATH.

Start

Lancez la configuration interactive:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

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

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

Le programme d’installation demande quel canal sdk installer et comment accéder à la commande managée dotnet .

Pour une configuration concise et non interactive, installez un SDK et configurez le shell actuel :

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

Si vous ne souhaitez pas modifier votre profil du shell, utilisez la commande de redirection :

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

Le mode, la version résolue, l’architecture, le chemin d’installation et la commande shell dépendent de votre système et des versions disponibles.

Comment dotnetup gère .NET

dotnetup effectue le suivi des installations du Kit de développement logiciel (SDK) que vous demandez. Ce suivi permet dotnetup de mettre à jour de nombreuses installations en même temps. Il permet également de dotnetup supprimer en toute sécurité les installations inutilisées ou hors support.

Pour plus d’informations, consultez Le fonctionnement de dotnetup.

Choisissez quoi lire ensuite

Objectif	Article
Déterminer si dotnetup correspond à votre scénario	Quand utiliser dotnetup
Installer dotnetup et exécuter la première configuration initiale	Bien démarrer avec dotnetup
Comprendre les canaux, les répertoires racine d’installation et le suivi	Fonctionnement de dotnetup
Utiliser celui d’un référentiel global.json	Gérer les exigences SDK du référentiel
Installer des kits SDK et des runtimes	Installer des composants .NET
Mettre à jour ou supprimer des installations	Mettre à jour les installations
Mettre à jour ou supprimer dotnetup lui-même	Mettre à jour ou supprimer dotnetup
Configurer PATH et DOTNET_ROOT	Gérer l’environnement dotnetup
Essayer la version préliminaire ou les builds quotidiens	Utiliser la version préliminaire et les builds quotidiens
Résoudre les problèmes courants	Résoudre les problèmes de dotnetup
Découvrez les données collectées par dotnetup	dotnetup telemetry
Rechercher la syntaxe de commande	Référence des commandes dotnetup

Availability

dotnetup est disponible en préversion publique. Les commandes, les options et le comportement peuvent changer d’une version préliminaire à l’autre, et le cycle de vie de prise en charge de la version généralement disponible n’est pas encore définitif.

Pour installer dotnetup, consultez Prise en main de dotnetup. Une fois que vous l’avez installé, exécutez dotnetup --version pour confirmer la version et dotnetup --help pour afficher les commandes disponibles.