dotnet – příkaz

Tento článek se vztahuje na: ✔️ .NET Core 3.1 SDK a novější verze

Název

dotnet – Obecný ovladač rozhraní příkazového řádku .NET.

Synopse

Získání informací o dostupných příkazech a prostředí:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Spuštění příkazu (vyžaduje instalaci sady SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Spuštění aplikace:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

Description

Příkaz dotnet má dvě funkce:

  • Poskytuje příkazy pro práci s projekty .NET.

    Například dotnet build sestaví projekt. Každý příkaz definuje vlastní možnosti a argumenty. Všechny příkazy podporují --help možnost tisku stručné dokumentace k používání příkazu.

  • Spouští aplikace .NET.

    Zadáte cestu k souboru aplikace .dll pro spuštění aplikace. Spuštění aplikace znamená najít a spustit vstupní bod, což je Main v případě konzolových aplikací metoda. Například dotnet myapp.dll spustí myapp aplikaci. Další informace o možnostech nasazení aplikace .NET najdete v tématu Nasazení aplikace .NET .

Možnosti

Různé možnosti jsou k dispozici pro dotnet sebe, pro spuštění příkazu a pro spuštění aplikace.

Možnosti pro samotnou síť dotnet

Následující možnosti jsou určené pro dotnet sebe. Například, dotnet --info. Vypisují informace o prostředí.

  • --info

    Vytiskne podrobné informace o instalaci .NET a prostředí počítače, jako je aktuální operační systém, a potvrzení SHA verze .NET.

  • --version

Vytiskne verzi sady .NET SDK používanou příkazy dotnet. Obsahuje účinky libovolného souboru global.json.

  • --list-runtimes

    Vytiskne seznam nainstalovaných modulů runtime .NET. Verze x86 sady SDK uvádí pouze moduly runtime x86 a verzi x64 sady SDK, pouze moduly runtime x64.

  • --list-sdks

    Vytiskne seznam nainstalovaných sad SDK .NET.

  • -?|-h|--help

    Vytiskne seznam dostupných příkazů.

Možnosti sady SDK pro spuštění příkazu

Následující možnosti jsou určené dotnet příkazem. Například, dotnet build --help.

  • -d|--diagnostics

    Povolí výstup diagnostiky.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal], d[etailed]n[ormal]a diag[nostic]. Není podporováno v každém příkazu. Pokud chcete zjistit, jestli je tato možnost dostupná, podívejte se na konkrétní stránku příkazu.

  • -?|-h|--help

    Vytiskne dokumentaci pro daný příkaz, například dotnet build --help.

  • command options

    Každý příkaz definuje možnosti specifické pro tento příkaz. Seznam dostupných možností najdete na konkrétní stránce příkazu.

Možnosti modulu runtime

Při spuštění aplikace jsou k dispozici dotnet následující možnosti. Například, dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Cesta obsahující zásady probívání a sestavení pro sondu

  • --additional-deps <PATH>

    Cesta k dalšímu souboru .deps.json Soubor deps.json obsahuje seznam závislostí, závislostí kompilace a informací o verzi používaných k řešení konfliktů sestavení. Další informace najdete v tématu Konfigurační soubory modulu runtime v GitHub.

  • --depsfile <PATH_TO_DEPSFILE>

    Cesta k souboru deps.json Soubor deps.json je konfigurační soubor, který obsahuje informace o závislostech nezbytných ke spuštění aplikace. Tento soubor vygeneruje sada .NET SDK.

  • --runtimeconfig

    Cesta k souboru runtimeconfig.json Soubor runtimeconfig.json je konfigurační soubor, který obsahuje nastavení za běhu. Další informace najdete v tématu Nastavení konfigurace modulu runtime .NET.

  • --roll-forward <SETTING> **

    Určuje, jak se u aplikace používá vrácení vpřed. Může SETTING to být jedna z následujících hodnot. Pokud není zadáno, Minor je výchozí.

    • LatestPatch - Přejděte vpřed na nejvyšší verzi opravy. Tím se zakáže vrácení podverze dopředu.
    • Minor – Pokud chybí požadovaná podverze, přejděte vpřed na nejnižší nižší podverzi. Pokud je požadovaná podverze k dispozici, použije se zásada LatestPatch.
    • Major – Pokud požadovaná hlavní verze chybí, přejděte k nejnižší vyšší hlavní verzi a nejnižší podverze. Pokud je požadovaná hlavní verze k dispozici, použije se zásada Podverze.
    • LatestMinor – Přepošlete se na nejvyšší podverzi, i když je požadovaná podverze k dispozici. Určené pro scénáře hostování komponent.
    • LatestMajor – Přepošlete se na nejvyšší hlavní a nejvyšší podverzi, a to i v případě, že je požadovaná hlavní verze přítomna. Určené pro scénáře hostování komponent.
    • Disable - Nepředávejte dopředu. Vázání pouze na zadanou verzi. Tato zásada se nedoporučuje pro obecné použití, protože zakáže možnost převést se na nejnovější opravy. Tato hodnota se doporučuje jenom pro testování.

    DisableKromě toho budou všechna nastavení používat nejvyšší dostupnou verzi opravy.

    Chování při přeposílání se dá nakonfigurovat také ve vlastnosti souboru projektu, vlastnosti konfiguračního souboru modulu runtime a proměnné prostředí. Další informace najdete v tématu Postupné uvedení modulu runtime hlavní verze.

  • --fx-version <VERSION>

    Verze modulu runtime .NET, která se má použít ke spuštění aplikace.

    Tato možnost přepíše verzi prvního odkazu na architekturu v souboru aplikace .runtimeconfig.json . To znamená, že funguje pouze podle očekávání, pokud existuje jenom jeden odkaz na architekturu. Pokud má aplikace více než jeden odkaz na architekturu, může použití této možnosti způsobit chyby.

Příkazy dotnet

Obecné

Příkaz Funkce
dotnet build Vytvoří aplikaci .NET.
dotnet build-server Komunikuje se servery spuštěnými sestavením.
dotnet clean Čisté výstupy sestavení
dotnet help Zobrazí podrobnější dokumentaci k příkazu online.
dotnet migrate Migruje platný projekt Preview 2 do projektu .NET Core SDK 1.0.
dotnet msbuild Poskytuje přístup k příkazovému řádku MSBuild.
dotnet new Inicializuje projekt jazyka C# nebo F# pro danou šablonu.
dotnet pack Vytvoří NuGet balíček kódu.
dotnet publish Publikuje aplikaci závislá na rozhraní .NET Framework nebo samostatná aplikace.
dotnet restore Obnoví závislosti pro danou aplikaci.
dotnet run Spustí aplikaci ze zdroje.
dotnet sdk – kontrola Zobrazuje aktuální stav nainstalovaných verzí sady SDK a modulu runtime.
dotnet sln Možnosti pro přidání, odebrání a výpis projektů v souboru řešení
dotnet store Ukládá sestavení v úložišti balíčků modulu runtime.
dotnet test Spustí testy pomocí spouštěče testů.

Odkazy na projekty

Příkaz Funkce
dotnet add reference Přidá odkaz na projekt.
dotnet list reference Zobrazí odkazy na projekt.
dotnet remove reference Odebere odkaz na projekt.

Balíčky NuGet

Příkaz Funkce
dotnet add package Přidá balíček NuGet.
dotnet remove package Odebere balíček NuGet.

příkazy NuGet

Příkaz Funkce
dotnet nuget delete Odstraní nebo zruší seznam balíčků ze serveru.
dotnet nuget push Odešle balíček na server a publikuje ho.
dotnet nuget locals Vymaže nebo vypíše místní NuGet prostředky, jako je mezipaměť http-request, dočasná mezipaměť nebo složka globálních balíčků na úrovni počítače.
dotnet nuget add source Přidá zdroj NuGet.
dotnet nuget disable source Zakáže zdroj NuGet.
dotnet nuget enable source Povolí zdroj NuGet.
dotnet nuget list source Zobrazí seznam všech nakonfigurovaných zdrojů NuGet.
dotnet nuget remove source Odebere NuGet zdroj.
dotnet nuget update source Aktualizace zdroj NuGet.

Příkazy úloh

Příkaz Funkce
instalace úlohy dotnet Nainstaluje volitelnou úlohu.
seznam úloh dotnet Zobrazí seznam všech nainstalovaných úloh.
dotnet workload repair Opraví všechny nainstalované úlohy.
dotnet workload search Zobrazí seznam vybraných úloh nebo všech dostupných úloh.
odinstalace úloh dotnet Odinstaluje úlohu.
dotnet – aktualizace úloh Přeinstaluje všechny nainstalované úlohy.

Globální příkazy, cesta k nástrojům a místní nástroje

Nástroje jsou konzolové aplikace, které jsou nainstalovány z NuGet balíčků a jsou vyvolány z příkazového řádku. Nástroje můžete psát sami nebo instalovat nástroje napsané třetími stranami. Nástroje se také označují jako globální nástroje, nástroje cesty k nástrojům a místní nástroje. Další informace najdete v přehledu nástrojů .NET.

Příkaz Funkce
dotnet tool install Nainstaluje na počítač nástroj.
dotnet tool list Zobrazí seznam všech globálních nástrojů, cest k nástrojům nebo místních nástrojů aktuálně nainstalovaných na vašem počítači.
dotnet tool search Vyhledá NuGet.org nástroje, které mají zadaný hledaný termín ve svém názvu nebo metadatech.
dotnet tool uninstall Odinstaluje nástroj z počítače.
dotnet tool update Aktualizace nástroj nainstalovaný na vašem počítači.

Další nástroje

V rámci sady .NET SDK jsou k dispozici následující další nástroje:

Nástroj Funkce
dev-certs Vytváří a spravuje vývojové certifikáty.
Ef Nástroje příkazového řádku Entity Framework Core
uživatelské tajné kódy Spravuje tajné kódy uživatelů pro vývoj.
Sledovat Sledovací proces souborů, který restartuje nebo znovu načte aplikaci, když zjistí změny ve zdrojovém kódu.

Další informace o každém nástroji pište dotnet <tool-name> --help.

Příklady

Vytvořte novou konzolovou aplikaci .NET:

dotnet new console

Sestavení projektu a jeho závislostí v daném adresáři:

dotnet build

Spusťte aplikaci:

dotnet myapp.dll

Viz také