Začínáme s dotnetup

Note

dotnetup je ve veřejné verzi Preview. Jeho funkce a chování se můžou před obecnou dostupností změnit.

dotnetup je správce multiplatformního toolchainu pro instalace .NET na úrovni uživatele. Instaluje, aktualizuje a odebírá sady SDK a moduly runtime .NET bez použití správce systémových balíčků.

Prerequisites

  • Jeden z následujících operačních systémů a architektur:

    Operační systém Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), například Alpine Linux x64, Arm64

  • Terminál.

  • V systému macOS nebo Linux použijte Bash a ve Windows PowerShell ke spuštění skriptu pro stažení.

  • V systému macOS nebo Linux použijte curl nebo wget ke stažení souborů a sha512sum nebo shasum k jejich ověření.

dotnetupmá stejné požadavky na operační systém jako .NET Runtime. Požadavky specifické pro operační systém najdete v tématu Instalace .NET na Windows, Instalace .NET v systému macOS nebo Instalace .NET v Linuxu.

Important

Ve Windows výchozí nastavení používá režim přístupu everywhere. Tento režim:

  • Vyžaduje zvýšení oprávnění k aktualizaci systému PATH.
  • Instalace spravovaná nástrojem dotnetup má přednost před instalacemi rozhraní .NET pro celý počítač, jako jsou ty, které instaluje Visual Studio. Projekty a aplikace, které potřebují sadu SDK nebo modul runtime pro celý počítač, které zároveň nenainstaluje dotnetup, se nepodaří sestavit ani spustit.
  • Změní systém PATH. Tato změna platí pro všechny uživatele. Procesy se zvýšenými oprávněními, které spustí jiní uživatelé, můžou vyřešit .NET z vašeho profilu uživatele.

Pokud se chcete těmto efektům vyhnout, zvolte během instalace režim přístupu none nebo shell. Pokud zvolíte everywhere, migrujte stávající instalace, když to instalační program nabídne. Podrobnosti najdete v tématu Aspekty režimu Everywhere.

Stáhnout dotnetup

Skripty pro stahování ve výchozím nastavení nainstalují nejnovější preview build. Stažený spustitelný soubor se ověří pomocí kontrolního součtu SHA-512 a nainstaluje se do ~/.dotnetup.

V macOS nebo Linuxu spusťte:

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

Na Windows spusťte:

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

Pokud chcete nainstalovat nejnovější daily build v macOS nebo Linuxu, spusťte:

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

Nejnovější sestavení daily v systému Windows nainstalujete spuštěním:

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

Important

Denní buildy neprošly validací vydání a nejsou podepsané kódem. Používejte denní buildy pouze pro krátkodobé testování.

Skripty vytisknou pokyny pro přidání dotnetup do PATH. Po použití pokynů otevřete nový terminál.

Spusťte počáteční nastavení

Spusťte interaktivní instalaci:

> 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!

Cesty k souborům, zobrazení průběhu a pokyny k prostředí závisí na vašem systému a vybraném režimu.

Doporučený režim přístupu je everywhere na Windows. V systémech macOS a Linux je to shell, když dotnetup zjistí podporovaný shell, a none v opačném případě.

Vyberte Ne, přizpůsobit nastavení a zvolte kanál sady SDK, režim přístupu a možnosti migrace.

Vyberte kanál sady SDK

Kanál sady SDK určuje pro dotnetup, kterou sadu SDK nainstalovat a jak ji aktualizovat.

Formulář kanálu Example Result
Poslední stabilní latest Nejnovější aktivní stabilní SDK
Nejnovější LTS lts Nejnovější aktivní stabilní SDK LTS
Nejnovější preview verze preview Nejnovější preview SDK
Nejnovější denní verze daily Nejnovější dostupné denní SDK
Hlavní 10 Nejnovější sada SDK pro verzi s daným hlavním číslem
Závažné a méně závažné 10.0 Nejnovější sada SDK pro zadanou hlavní a vedlejší verzi
Pruh funkcí 10.0.1xx Nejnovější SDK v zadaném pásmu funkcí verze
Přesná verze 10.0.103 Pouze zadaná verze sady SDK
Žádná výchozí sada SDK none Přeskočit instalaci během nastavení

Přesné verze se během aktualizací neposouvají. Všechny přijatelné podoby najdete v tématu kanály a verze dotnetup.

Zvolte, jak přistupovat k .NET

Režim přístupu určuje, jak terminály a aplikace najdou instalaci .NET spravovanou nástrojem dotnetup.

Režim přístupu Behavior
none Tyto proměnné prostředí nemění. Spusťte .NET pomocí dotnetup dotnet.
shell Upraví profil shellu tak, aby nastavil tyto proměnné prostředí. Procesy spuštěné z daného shellu používají sady SDK .NET a moduly runtime nainstalované nástrojem dotnetup.
everywhere Upraví systém PATH a nastaví proměnnou prostředí na uživatelské úrovni DOTNET_ROOT. Je k dispozici pouze ve Windows.

Další podrobnosti a důležité informace o everywhere režimu najdete v tématu konfigurace prostředí dotnetup.

Migrovat existující instalace

Instalační program může nabídnout migraci stávajících instalací sady .NET SDK a modulu runtime pro všechny uživatele do instalace spravované nástrojem dotnetup. Informace o tom, proč je migrace obzvláště důležitá v režimu , najdete v části everywhere.

Ověření nastavení

Po změnách v nastavení, které změní vaše prostředí, otevřete nový terminál.

Pro shell nebo everywhere režim spusťte:

dotnet --version
dotnetup list

V none režimu spusťte:

dotnetup dotnet -- --version
dotnetup list

Znovu spusťte dotnetup init, chcete-li změnit nastavení.

  • Poslední aktualizace v