Aktualizowanie lub usuwanie dotnetup

Uwaga

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

W tym artykule opisano sposób zarządzania samym narzędziem dotnetup . Aby zaktualizować lub usunąć zestawy SDK i środowiska uruchomieniowe .NET zarządzane przez dotnetup, zobacz Aktualizowanie instalacji.

Sprawdź wersję dotnetup

Pokaż wersję dotnetup:

dotnetup --version

Aby również wyświetlić commit, architekturę, identyfikator środowiska uruchomieniowego i zweryfikowane instalacje, uruchom polecenie:

dotnetup --info

Zaktualizuj dotnetup

Aby zaktualizować samodzielny plik wykonywalny dotnetup, uruchom polecenie:

dotnetup self update

To polecenie jest dostępne w kompilacjach dotnetup 0.3.0 w wersji zapoznawczej. Wybiera kanał wydania z etykiety zainstalowanej wersji. Oficjalne codzienne kompilacje również używają etykiety preview, więc określ kanał jawnie, aby pozostać na codziennych kompilacjach:

dotnetup self update --channel daily

Aby wrócić z nowszej kompilacji dziennej do najnowszej publicznej wersji zapoznawczej, uruchom polecenie:

dotnetup self update --channel preview --force

--force może obniżyć wersję lub ponownie zainstalować plik wykonywalny. Aby uzyskać informacje o opcjach poleceń i ograniczeniach, zobacz dotnetup self update.

Aktualizacja dotnetup nie zmienia instalacji .NET, konfiguracji środowiska ani śledzonych specyfikacji instalacyjnych.

Zaktualizuj starszą wersję lub odzyskaj plik wykonywalny

Jeśli twoja wersja nie rozpoznaje self update, lub plik wykonywalny już się nie uruchamia, uruchom skrypt pobierania ponownie. Skrypt zastępuje istniejący plik wykonywalny w wybranym katalogu instalacyjnym.

W systemie macOS lub Linux uruchom polecenie:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

W systemie Windows uruchom:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Skrypt domyślnie instaluje najnowszą preview kompilację. Jeśli używasz kompilacji daily lub niestandardowego katalogu instalacyjnego, przekaż te same opcje, które były używane podczas pierwszej instalacji. Na przykład w systemie macOS lub Linux:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

W systemie Windows:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

Skonfiguruj powiadomienia o aktualizacjach

Po pomyślnym wykonaniu interaktywnych poleceń instalacji i aktualizacji dotnetup może powiadomić Cię o dostępności nowszej kompilacji. Wyświetla się powiadomienie, ale aktualizacja nie jest instalowana.

Aby wyłączyć powiadomienia, uruchom polecenie:

dotnetup self update --update-notifications false

Aby ponownie włączyć powiadomienia, użyj polecenia --update-notifications true. Aby uzyskać informacje o częstotliwości sprawdzania i sposobie wyświetlania wyników, zobacz Powiadomienia o aktualizacjach.

Usuń dotnetup

Aby usunąć dotnetup i wszystko, czym zarządza, wykonaj poniższe kroki we właściwej kolejności.

1. Znajdowanie katalogów głównych instalacji

Wyświetl listę katalogów głównych instalacji, które są śledzone przez dotnetup:

dotnetup list

Zarejestruj każdy katalog główny instalacji, który nie znajduje się w katalogu danych dotnetup. Te foldery usuniesz w późniejszym kroku.

2. Usuwanie konfiguracji środowiska

Usuń zmiany wprowadzone przez DOTNET_ROOT w elementach PATH i dotnetup:

dotnetup env clear

W shell trybie uruchom to polecenie z powłoki, której profil dotnetup uległ zmianie, lub wybierz tę powłokę z opcją --shell . W trybie everywhere w systemie Windows to polecenie zmienia systemowy PATH i wymaga podniesienia uprawnień.

To polecenie nie usuwa zestawów SDK ani środowisk uruchomieniowych. Aby uzyskać więcej informacji, zobacz Usuń konfigurację środowiska.

3. Usuń główne katalogi instalacji i katalog danych

Usuń każdy katalog główny instalacji zanotowany w kroku 1.

Następnie usuń katalog danych dotnetup. Ten katalog zawiera domyślny katalog główny instalacji, manifest, plik konfiguracji i pamięć podręczną pobierania.

System operacyjny Domyślny katalog danych
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetuplub ~/.local/share/dotnetup , gdy XDG_DATA_HOME nie jest ustawiona

Jeśli ustawisz zmienną środowiskową DOTNET_DOTNETUP_DATA_DIR, usuń zamiast tego ten katalog, a następnie usuń tę zmienną środowiskową.

4. Usuń plik wykonywalny dotnetup

Usuń katalog zawierający plik wykonywalny dotnetup. Domyślnie skrypt pobierania instaluje dotnetup w ~/.dotnetup. Jeśli ręcznie dodano ten katalog do PATH, usuń ten wpis z profilu powłoki lub ze zmiennych środowiskowych użytkownika.

Otwórz nowy terminal, aby użyć zaktualizowanego środowiska.

Informacje dodatkowe

  • Ostatnia aktualizacja o