Prérequis du SDK du dépôt avec dotnetup

Note

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

dotnetup utilise global.json pour associer une exigence du Kit de développement logiciel (SDK) à un dépôt ou une arborescence de répertoires. Il recherche à partir du répertoire actif via chaque répertoire parent et lit le global.json existant le plus proche.

Installer à partir de global.json

Exécutez une commande d’installation du SDK sans canal :

dotnetup install

Si le plus global.json proche a un sdk.version, dotnetup dérive une spécification d’installation à partir de la version et de la valeur rollForward. Il enregistre le chemin d’accès complet au fichier comme source de spécification. S’il n’existe aucun global.json dans le répertoire actif ou ses répertoires parents, la commande utilise le canal latest. Si le fichier le plus proche est mal formé ou contient des commentaires, l’analyse échoue. dotnetup ne saute pas ce fichier pour rechercher dans les répertoires parents ou utiliser le canal latest.

mappage de rollForward

dotnetup mappe les global.json stratégies de sélection du Kit de développement logiciel (SDK) aux canaux pouvant être mis à jour :

Valeur rollForward Exigence dotnetup enregistrée pour le SDK 10.0.103
Ignoré ou latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor oumajor 10.0.103

Les correspondances de version exacte sont épinglées et ne sont pas mises à jour lors d’une mise à jour. La allowPrerelease propriété n’affecte pas le canal de publication dérivé par dotnetup.

Chemin d’installation à partir de global.json

Si sdk.paths contient une entrée, dotnetup utilise le premier chemin d’accès. Un chemin relatif est résolu à partir du répertoire qui contient global.json.

Dans la build publique-preview actuelle, dotnetup traite la première entrée en tant que chemin d’accès. Il n’interprète pas $host$ comme une sentinelle ou n’ignore pas les entrées vides.

La priorité du chemin d’installation est la suivante :

  1. --install-path.
  2. La première sdk.paths entrée dans le global.json le plus proche.
  3. Racine d’installation .NET par défaut gérée par dotnetup.

Conserver les fichiers du dépôt actuels

Passez --update-global-json pour remplacer sdk.version par la version concrète du Kit de développement logiciel (SDK) installée ou mise à jour :

dotnetup install --update-global-json
dotnetup sdk update --update-global-json

Seules les spécifications du KIT de développement logiciel (SDK) issues de global.json sont mises à jour par le workflow de mise à jour. Le modificateur conserve les autres propriétés JSON, la mise en forme et l’encodage de texte détecté.

Supprimer les exigences du référentiel correspondant

Une spécification de suivi global.json est actualisée lors du ramasse-miettes. Si le fichier n’existe plus ou ne contient plus de version du Kit de développement logiciel (SDK), la spécification est supprimée.

Pour supprimer les spécifications par canal, sélectionnez la source globaljson. Cette commande supprime toutes les spécifications correspondantes dans la racine d’installation sélectionnée, pas seulement un référentiel :

dotnetup sdk uninstall 10.0.1xx --source globaljson

Utilisez dotnetup list pour trouver le canal stocké, le chemin source et la racine d’installation. Ajoutez --install-path pour sélectionner une racine personnalisée.

Voir aussi

  • Dernière mise à jour :