Repository-SDK-Anforderungen mit dotnetup

Hinweis

dotnetup befindet sich in der öffentlichen Vorschau. Die Features und das Verhalten können sich vor der allgemeinen Verfügbarkeit ändern.

dotnetup verwendet global.json , um eine SDK-Anforderung einem Repository oder einer Verzeichnisstruktur zuzuordnen. Es durchsucht das aktuelle Verzeichnis durch alle übergeordneten Verzeichnisse und liest das nächstgelegene vorhandene global.json.

Aus global.json installieren

Führen Sie einen SDK-Installationsbefehl ohne Kanal aus:

dotnetup install

Wenn der nächste global.json ein sdk.version hat, leitet dotnetup eine Installationsspezifikation aus der Version und dem Wert rollForward ab. Der vollständige Pfad zur Datei wird als Spezifikationsquelle gespeichert. Wenn im aktuellen Verzeichnis oder den übergeordneten Verzeichnissen kein global.json Vorhanden ist, verwendet der Befehl den latest Kanal. Wenn die nächste Datei falsch formatiert ist oder Kommentare enthält, schlägt das Parsen fehl. dotnetup überspringt diese Datei nicht, um übergeordnete Verzeichnisse zu durchsuchen oder den latest Kanal zu verwenden.

rollForward-Mapping

dotnetup weist global.json SDK-Auswahlrichtlinien aktualisierbaren Kanälen zu:

rollForward Wert Gespeicherte Anforderung für dotnetup SDK 10.0.103
Weggelassen oder latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor oder major 10.0.103

Die exakten Versionszuordnungen werden fixiert und werden durch ein Update nicht aktualisiert. Die allowPrerelease Eigenschaft wirkt sich nicht auf den Kanal aus, den dotnetup ableitet.

Installationspfad von global.json

Wenn sdk.paths einen Eintrag enthält, verwendet dotnetup den ersten Pfad. Ein relativer Pfad wird relativ zu dem Verzeichnis aufgelöst, das global.json enthält.

Im aktuellen Public Preview-Build dotnetup wird der erste Eintrag als Pfad behandelt. Er interpretiert $host$ weder als Sentinel noch überspringt er leere Einträge.

Die Rangfolge des Installationspfads lautet:

  1. --install-path.
  2. Der erste sdk.paths Eintrag im nächstgelegenen global.json.
  3. Der standardmäßige dotnetup-verwaltete .NET Installationsstamm.

Repositorydateien auf dem aktuellen Stand halten

Übergeben Sie --update-global-json, um sdk.version durch die konkrete SDK-Version zu ersetzen, die installiert oder aktualisiert wurde:

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

Vom Updateworkflow werden nur global.json-sourced SDK-Spezifikationen aktualisiert. Der Modifizierer behält die anderen JSON-Eigenschaften, Formatierungen und erkannte Textcodierung bei.

Übereinstimmende Repositoryanforderungen entfernen

Eine verfolgte global.json Spezifikation wird während der Speicherbereinigung erneuert. Wenn die Datei nicht mehr vorhanden ist oder keine SDK-Version mehr enthält, wird die Spezifikation entfernt.

Um Spezifikationen nach Kanal zu entfernen, wählen Sie die globaljson Quelle aus. Mit diesem Befehl werden alle übereinstimmenden Spezifikationen im ausgewählten Installationsverzeichnis entfernt, nicht nur ein Repository:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Verwenden Sie dotnetup list, um den gespeicherten Kanal, den Quellpfad und den Installationsstamm zu finden. Fügen Sie --install-path hinzu, um ein benutzerdefiniertes Stammverzeichnis auszuwählen.

Siehe auch

  • Zuletzt aktualisiert um