dotnet – příkaz

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

Name

dotnet – Obecný ovladač pro .NET CLI.

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>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Popis

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 své vlastní možnosti a argumenty. Všechny příkazy podporují --help možnost tisku stručné dokumentace o 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ž v případě konzolových aplikací je Main metoda. Například dotnet myapp.dll spustí myapp aplikaci. Další informace o možnostech nasazení najdete v tématu Nasazení aplikace .NET .

Možnosti

Pro:

  • Zobrazení informací o prostředí
  • Spuštění příkazu
  • Spuštění aplikace

Možnosti zobrazení informací o prostředí a dostupných příkazů

Následující možnosti jsou k dispozici, pokud dotnet se používají samostatně, aniž byste zadali příkaz nebo aplikaci, která se má spustit. Příkladem je dotnet --info nebo dotnet --version. Vypíše 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 potvrdí SHA verze .NET.

  • --version

Vytiskne verzi sady .NET SDK používanou dotnet příkazy, které mohou být ovlivněny souborem global.json . K dispozici pouze v případech, kdy je sada SDK nainstalovaná.

  • --list-runtimes

    Vytiskne seznam nainstalovaných modulů runtime .NET. Verze x86 sady SDK obsahuje pouze moduly runtime x86 a verze x64 sady SDK obsahuje pouze moduly runtime x64.

  • --list-sdks

    Vytiskne seznam nainstalovaných sad SDK .NET.

  • -?|-h|--help

    Vytiskne seznam dostupných příkazů.

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

Následující možnosti jsou určené dotnet příkazem. Příkladem je dotnet build --help nebo dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Povolí výstup diagnostiky.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet]: , , m[inimal]n[ormal], d[etailed]a diag[nostic]. Nepodporuje se 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. Zobrazí například dotnet build --help nápovědu build k příkazu.

  • command options

    Každý příkaz definuje možnosti specifické pro tento příkaz. Seznam dostupnýchmožnostích

Možnosti spuštění aplikace

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ásadu sondy a sestavení pro sondu Opakujte možnost pro zadání více cest.

  • --additional-deps <PATH>

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

  • --roll-forward <SETTING> **

    Určuje, jak se u aplikace použije postup uvedení 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 vpřed.
    • Minor – Pokud chybí požadovaná podverze, přejděte k nejnižší vyšší 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žší podverzi. Pokud je požadovaná hlavní verze k dispozici, použije se podverze.
    • LatestMinor – Přepošlete se na nejvyšší podverzi, i když je k dispozici požadovaná podverze. Určeno pro scénáře hostování komponent.
    • LatestMajor – Přepošlete se na nejvyšší hlavní a nejvyšší podverzi, i když se požaduje hlavní verze. Určeno pro scénáře hostování komponent.
    • Disable - Nevrácej se dopředu. Svázání pouze se zadanou verzí Tato zásada se nedoporučuje pro obecné použití, protože zakazuje možnost převést se na nejnovější opravy. Tato hodnota se doporučuje pouze pro testování.

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

    Chování při předávání lze také nakonfigurovat ve vlastnosti souboru projektu, vlastnosti konfiguračního souboru modulu runtime a proměnné prostředí. Další informace najdete v části Modul 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 jen 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.

Možnosti spuštění aplikace pomocí exec příkazu

Následující možnosti jsou k dispozici pouze při dotnet spuštění aplikace pomocí exec příkazu. Například, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

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

  • --runtimeconfig <PATH>

    Cesta k souboru runtimeconfig.json Soubor runtimeconfig.json obsahuje nastavení za běhu a obvykle se jmenuje <applicationname.runtimeconfig.json>. Další informace najdete v tématu Nastavení konfigurace modulu runtime .NET.

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 Vyčistěte výstupy sestavení.
dotnet exec Spustí aplikaci .NET.
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ří balíček NuGet 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.
kontrola sady sdk dotnet Zobrazuje aktuální stav nainstalovaných verzí sady SDK a runtime.
dotnet sln Možnosti přidání, odebrání a výpisu projektů v souboru řešení
dotnet store Ukládá sestavení do úložiště 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í prostředky NuGet, jako je mezipaměť http-request, dočasná mezipaměť nebo globální složka 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 zdroj NuGet.
dotnet nuget update source Aktualizace zdroj NuGet.

Příkazy úloh

Příkaz Funkce
instalace úloh dotnet Nainstaluje volitelnou úlohu.
seznam úloh dotnet Zobrazí seznam všech nainstalovaných úloh.
dotnet – oprava úloh Opraví všechny nainstalované úlohy.
hledání úloh dotnet Umožňuje zobrazit 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 příkazy místních nástrojů

Nástroje jsou konzolové aplikace nainstalované z balíčků NuGet 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 tématu Přehled nástrojů .NET.

Příkaz Funkce
dotnet tool install Nainstaluje nástroj na váš počítač.
dotnet tool list Zobrazí seznam všech globálních, nástrojů nebo místních nástrojů, které jsou aktuálně nainstalované na vašem počítači.
dotnet tool search Vyhledá NuGet.org nástroje, které mají zadaný hledaný termín v 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 exec myapp.dll
dotnet myapp.dll

Viz také