Zainstaluj zestaw SDK dla repozytorium za pomocą narzędzia dotnetup

Uwaga

dotnetup jest dostępna w publicznej wersji zapoznawczej. Jego funkcje i zachowanie mogą ulec zmianie przed ogólną dostępnością.

Jeśli nie podasz kanału zestawu SDK, dotnetup sdk install przeszukuje bieżący katalog w kierunku katalogu głównego systemu plików. Używa najbliższego istniejącego global.json pliku. Jeśli ten plik jest nieprawidłowy, polecenie zakończy się niepowodzeniem zamiast przeszukiwania katalogu nadrzędnego. Jeśli plik nie istnieje, używa latest.

Zainstaluj wymaganie repozytorium

W katalogu repozytorium uruchom polecenie:

dotnetup sdk install

W tym global.json pliku dotnetup śledzi 10.0.1xx pasmo funkcji:

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

Ścieżka global.json jest źródłem przechowywanego wymogu. Możesz zobaczyć źródło i zainstalowaną wersję za pomocą polecenia:

dotnetup list

Zrozumieć mapowanie roll-forward

W przypadku wersji zestawu SDK, takiej jak 10.0.103, dotnetup mapuje rollForward w następujący sposób:

Wartość: rollForward Zapisany kanał dotnetup
Pominięto lub latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, , patch, feature, minorlub major Dokładna wersja 10.0.103

Dokładne wymaganie jest przypięte i nie ulega zmianie przez dotnetup update. Właściwość allowPrerelease nie ma wpływu na kanał, który określa narzędzie dotnetup.

Użyj sdk.paths

Jeśli global.json zawiera sdk.paths, dotnetup używa pierwszej ścieżki, gdy nie podano opcji --install-path. Określa wartość względną z katalogu zawierającego element global.json.

Pierwszeństwo ścieżki instalacji to:

  1. --install-path
  2. Pierwszy sdk.paths wpis
  3. Domyślny katalog główny instalacji zarządzanej przez dotnetup .NET

Ograniczenia wersji zapoznawczej

Bieżąca kompilacja publicznej wersji zapoznawczej traktuje pierwszy sdk.paths wpis jako ścieżkę. Nie interpretuje $host$ jako sentinel ani nie pomija pustych wpisów. Aby użyć domyślnego katalogu głównego instalacji zarządzanej przez dotnetup, pomiń sdk.paths lub ustaw --install-path jawnie.

Aktualizacja global.json

Po zmianie sdk.version lub rollForwarduruchom polecenie dotnetup sdk install z katalogu repozytorium, aby zastosować nowe wymaganie. Zanim odświeżanie odzyskiwania pamięci odświeży zmienione źródła global.json, procesy dotnetup sdk update przechowywały wymagania, więc ich pierwsze przejście może nadal używać poprzedniego wymagania.

Aby zainstalować najnowszą wersję w kanale pochodnym i zapisać tę wersję z powrotem do global.json, uruchom polecenie:

dotnetup sdk install --update-global-json

Później zaktualizuj wszystkie śledzone wymagania dotyczące repozytorium i ich pliki za pomocą następujących poleceń:

dotnetup sdk update --update-global-json

Aktualizacja zmienia tylko sdk.version Zachowuje istniejące formatowanie, inne właściwości i wykryte kodowanie tekstu.

Usuń pasujące wymagania dotyczące repozytorium

Polecenie dezinstalacji usuwa każdą zgodną globaljson specyfikację pakietu w wybranym katalogu głównym instalacji. Nie jest ono ukierunkowane na jedno repozytorium. Aby usunąć pasujące wymagania z domyślnego katalogu głównego, uruchom polecenie:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Aby wybrać katalog główny instalacji niestandardowej, dodaj polecenie --install-path:

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

dotnetup usuwa pliki tylko wtedy, gdy żaden z pozostałych wymogów ich nie wymaga.

Informacje dodatkowe

  • Ostatnia aktualizacja o