Ein SDK für ein Repository mit dotnetup installieren

Hinweis

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

Wenn Sie keinen SDK-Kanal bereitstellen, sucht dotnetup sdk install ausgehend vom aktuellen Verzeichnis in Richtung Dateisystemstamm. Es verwendet die nächste vorhandene global.json Datei. Wenn diese Datei falsch formatiert ist, schlägt der Befehl fehl, anstatt ein übergeordnetes Verzeichnis zu durchsuchen. Wenn keine Datei vorhanden ist, wird latest verwendet.

Repository-Anforderung installieren

Führen Sie im Repositoryverzeichnis Folgendes aus:

dotnetup sdk install

Für diese global.json Datei verfolgt dotnetup das 10.0.1xx Featureband:

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

Der global.json Pfad ist die Quelle des gespeicherten Anforderungseintrags. Sie können die Quellversion und installierte Version mit:

dotnetup list

Roll-Forward-Zuordnung verstehen

Für eine SDK-Version wie 10.0.103 ordnet dotnetup rollForward wie folgt zu:

rollForward Wert Gespeicherter dotnetup-Kanal
Weggelassen oder latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor oder major Exakte Version 10.0.103

Eine genaue Anforderung ist angeheftet und wird von dotnetup update nicht geändert. Die allowPrerelease Eigenschaft wirkt sich nicht auf den Kanal aus, den dotnetup ableitet.

sdk.paths verwenden

Wenn global.json--install-path enthält, verwendet dotnetup den ersten Pfad, wenn keine sdk.paths-Option vorhanden ist. Er löst einen relativen Wert aus dem Verzeichnis auf, das global.json enthält.

Die Rangfolge des Installationspfads lautet:

  1. --install-path
  2. Der erste sdk.paths Eintrag
  3. Das standardmäßige von dotnetup verwaltete Stammverzeichnis der .NET-Installation

Einschränkungen bei der Vorschau

Der aktuelle Public-Preview-Build behandelt den ersten sdk.paths Eintrag als Pfad. Er interpretiert $host$ weder als Sentinel noch überspringt er leere Einträge. Um den standardmäßigen dotnetup-verwalteten Installationsstamm zu verwenden, lassen Sie sdk.paths weg oder setzen Sie --install-path explizit.

Aktualisieren von global.json

Nachdem Sie sdk.version oder rollForward geändert haben, führen Sie dotnetup sdk install im Repository-Verzeichnis aus, um die neue Anforderung anzuwenden. Bevor die Garbage Collection geänderte global.json Quellen aktualisiert, verarbeiten dotnetup sdk update Prozesse gespeicherte Anforderungen, sodass der erste Durchlauf möglicherweise noch die vorherigen Anforderungen verwendet.

Führen Sie Folgendes aus, um die neueste Version im abgeleiteten Kanal zu installieren und diese Version in global.json zurückzuschreiben:

dotnetup sdk install --update-global-json

Aktualisieren Sie später alle nachverfolgten Repositoryanforderungen und deren Dateien mit:

dotnetup sdk update --update-global-json

Das Update ändert nur sdk.version. Es behält die vorhandene Formatierung, andere Eigenschaften und erkannte Textcodierung bei.

Übereinstimmende Repositoryanforderungen entfernen

Mit dem Deinstallationsbefehl werden alle übereinstimmenden globaljson Spezifikationen im ausgewählten Installationsverzeichnis entfernt. Es zielt nicht auf ein Repository ab. Führen Sie Folgendes aus, um übereinstimmende Anforderungen aus dem Standard-Root zu entfernen:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Um einen benutzerdefinierten Installationsstamm auszuwählen, fügen Sie Folgendes hinzu --install-path:

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

dotnetup entfernt Dateien nur, wenn keine verbleibende Anforderung sie benötigt.

Siehe auch

  • Zuletzt aktualisiert um