Rozpocznij pracę z dotnetup

Uwaga

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

dotnetupjest międzyplatformowym menedżerem łańcucha narzędzi na potrzeby instalacji .NET na poziomie użytkownika. Instaluje, aktualizuje i usuwa zestawy SDK i środowiska uruchomieniowe .NET bez korzystania z menedżera pakietów systemowych.

Prerequisites

• Jeden z następujących systemów operacyjnych i architektur:

  System operacyjny	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), takie jak Alpine Linux	x64, Arm64

• Pewien terminal.

• Użyj powłoki Bash w systemie macOS lub Linux albo programu PowerShell w systemie Windows, aby uruchomić skrypt pobierania.

• W systemie macOS lub Linux curl albo wget w celu pobrania plików i sha512sum albo shasum zweryfikowania ich.

dotnetupma te same wymagania dotyczące systemu operacyjnego co środowisko uruchomieniowe .NET. Aby uzyskać informacje o wymaganiach specyficznych dla systemu operacyjnego, zobacz Instalowanie .NET na Windows, Instalowanie .NET w systemie macOS lub Instalowanie .NET w systemie Linux.

Ważna

W Windows domyślna konfiguracja używa trybu dostępu everywhere. Ten tryb:

• Wymaga podniesienia uprawnień w celu zaktualizowania systemu PATH.
• Sprawia, że instalacja zarządzana przez dotnetup ma pierwszeństwo przed ogólnosystemowymi instalacjami .NET, takimi jak te instalowane przez Visual Studio. Projekty i aplikacje, które wymagają zestawu SDK lub środowiska uruchomieniowego dla całej maszyny, które nie jest również instalowane przez dotnetup, nie kompilują się ani nie uruchamiają się.
• Zmienia system PATH, który ma zastosowanie do wszystkich użytkowników. Procesy z podwyższonym poziomem uprawnień, uruchamiane przez innych użytkowników, mogą określać lokalizację platformy .NET na podstawie Twojego profilu użytkownika.

Aby uniknąć tych efektów, podczas instalacji wybierz tryb dostępu none lub shell. Jeśli wybierzesz everywhere, zmigruj istniejące instalacje, gdy instalator to zaproponuje. Aby uzyskać szczegółowe informacje, zobacz Informacje o trybie Everywhere.

Pobierz dotnetup

Skrypty pobierania instalują domyślnie najnowszą preview kompilację. Weryfikują pobrany plik wykonywalny przy użyciu sumy kontrolnej SHA-512 i instalują go w ~/.dotnetup.

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

Aby zainstalować najnowszą daily kompilację w systemie macOS lub Linux, uruchom polecenie:

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

Aby zainstalować najnowszą daily kompilację na Windows, uruchom polecenie:

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

Ważna

Codzienne kompilacje nie przeszły walidacji wydania i nie są podpisane kodem. Używaj codziennych kompilacji tylko w przypadku krótkotrwałych testów.

Skrypty wyświetlają instrukcje dodania dotnetup do PATH. Otwórz nowy terminal po zastosowaniu instrukcji.

Uruchom konfigurację początkową

Uruchom konfigurację interaktywną:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Ścieżki, wyświetlanie postępu i wskazówki dotyczące środowiska zależą od systemu i wybranego trybu.

Zalecanym trybem dostępu w systemie Windows jest everywhere. W systemach macOS i Linux jest to shell, gdy dotnetup wykryje obsługiwaną powłokę, w przeciwnym razie none.

Wybierz pozycję Nie, dostosuj konfigurację, aby wybrać kanał zestawu SDK, tryb dostępu i opcje migracji.

Wybierz kanał zestawu SDK

Kanał zestawu SDK informuje dotnetup , który zestaw SDK ma zostać zainstalowany i jak go zaktualizować.

Formularz kanału	Example	Result
Najnowsza stabilna wersja	latest	Najnowszy aktywny stabilny pakiet SDK
Najnowsza wersja LTS	lts	Najnowszy aktywny stabilny zestaw SDK w wersji LTS
Najnowsza wersja preview	preview	Najnowszy zestaw SDK w wersji zapoznawczej
Najnowsze dzienne	daily	Najnowsza dostępna dzienna wersja SDK
Maj	10	Najnowszy zestaw SDK dla określonej głównej wersji
Wersja główna i podrzędna	10.0	Najnowszy zestaw SDK dla określonej wersji głównej i podrzędnej
Pasek funkcji	10.0.1xx	Najnowszy zestaw SDK w określonym paśmie funkcjonalnym
Dokładna wersja	10.0.103	Tylko określona wersja zestawu SDK
Brak początkowego pakietu SDK	none	Pomiń instalację podczas konfiguracji

Dokładne wersje nie są podnoszone podczas aktualizacji. W przypadku wszystkich obsługiwanych form zobacz kanały i wersje dotnetup.

Wybieranie sposobu uzyskiwania dostępu do .NET

Tryb dostępu kontroluje, jak terminale i aplikacje znajdują instalację .NET zarządzaną przez dotnetup.

Tryb dostępu	Behavior
none	Nie modyfikuje tych zmiennych środowiskowych. Uruchom .NET za pomocą polecenia dotnetup dotnet.
shell	Modyfikuje profil powłoki, aby ustawić te zmienne środowiskowe. Procesy uruchomione z tej powłoki używają zestawów SDK .NET i środowisk uruchomieniowych zainstalowanych przez dotnetup.
everywhere	Modyfikuje system PATH i ustawia zmienną środowiskową DOTNET_ROOT na poziomie użytkownika. Dostępne tylko w systemie Windows.

Aby uzyskać więcej szczegółów i informacji dotyczących trybu everywhere, zobacz konfigurację środowiska dotnetup.

Migracja istniejących instalacji

Instalator może zaoferować migrację istniejących instalacji zestawu SDK i środowiska uruchomieniowego .NET na instalację zarządzaną przez dotnetup. Zobacz Zagadnienia dotyczące trybu Everywhere, aby dowiedzieć się, dlaczego migracja jest szczególnie ważna w trybie everywhere.

Weryfikowanie konfiguracji

Otwórz nowy terminal po zmianach w konfiguracji środowiska.

W trybie shell lub everywhere uruchom:

dotnet --version
dotnetup list

Dla trybu none uruchom polecenie:

dotnetup dotnet -- --version
dotnetup list

Uruchom dotnetup init ponownie, aby zmienić konfigurację.