Installer un Kit de développement logiciel (SDK) pour un référentiel avec dotnetup

Note

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

Lorsque vous ne fournissez pas de canal sdk, dotnetup sdk install effectue des recherches à partir du répertoire actif vers la racine du système de fichiers. Il utilise le fichier existant global.json le plus proche. Si ce fichier est incorrect, la commande échoue au lieu de rechercher un répertoire parent. S’il n’existe aucun fichier, il utilise latest.

Installer la dépendance du référentiel

À partir du répertoire du référentiel, exécutez :

dotnetup sdk install

Pour ce global.json fichier, dotnetup effectue le suivi du feature band 10.0.1xx :

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

Le global.json chemin d’accès est la source de l’exigence enregistrée. Vous pouvez voir la version source et installée avec :

dotnetup list

Comprendre le mappage de progression

Pour une version du SDK telle que 10.0.103, dotnetup mappe rollForward comme suit :

Valeur rollForward Canal dotnetup enregistré
Ignoré ou latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor oumajor Version exacte 10.0.103

Une exigence exacte est épinglée et n’est pas modifiée par dotnetup update. La allowPrerelease propriété n’affecte pas le canal de publication dérivé par dotnetup.

Utilisez sdk.paths.

Si global.json contient sdk.paths, dotnetup utilise le premier chemin d’accès lorsqu’aucune option --install-path n’est présente. Elle résout une valeur à partir du répertoire qui contient global.json.

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

  1. --install-path
  2. sdk.paths Première entrée
  3. Racine d’installation .NET par défaut gérée par dotnetup

Limitations de la version préliminaire

La build en préversion publique actuelle traite la première sdk.paths entrée comme un chemin d’accès. Il n’interprète pas $host$ comme une sentinelle ou n’ignore pas les entrées vides. Pour utiliser la racine d’installation gérée par dotnetup par défaut, omettez sdk.paths ou définissez --install-path explicitement.

Mettre à jour global.json

Après avoir modifié sdk.version ou rollForward, exécutez dotnetup sdk install à partir du répertoire du référentiel pour appliquer la nouvelle exigence. Avant que le ramasse-miettes actualise les sources modifiées global.json , dotnetup sdk update processus ont stocké les exigences, de sorte que sa première passe peut toujours utiliser l’exigence précédente.

Pour installer la version la plus récente dans le canal dérivé et réécrire cette version dans global.json, exécutez :

dotnetup sdk install --update-global-json

Plus tard, mettez à jour toutes les exigences du dépôt suivies et leurs fichiers avec :

dotnetup sdk update --update-global-json

La mise à jour change uniquement sdk.version. Il conserve la mise en forme existante, d’autres propriétés et l’encodage de texte détecté.

Supprimer les exigences du référentiel correspondant

La commande de désinstallation supprime tous les éléments correspondants globaljson dans la racine d’installation sélectionnée. Il ne cible pas un dépôt. Pour supprimer les exigences correspondantes de la racine par défaut, exécutez :

dotnetup sdk uninstall 10.0.1xx --source globaljson

Pour sélectionner une racine d’installation personnalisée, ajoutez --install-path:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup supprime les fichiers uniquement lorsqu’aucune exigence restante n’en a besoin.

Voir aussi

  • Dernière mise à jour :