dotnet – příkaz

  • Článek

Tento článek se týká: ✔️ .NET Core 3.1 SDK a novějších verzí

Name

dotnet – Obecný ovladač pro 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>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <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.

    Určí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. Informace o možnostech nasazení najdete v tématu Nasazení aplikace .NET .

Možnosti

K dispozici jsou různé 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ě, bez zadání příkazu nebo aplikace, která se má spustit. Příkladem je dotnet --info nebo dotnet --version. 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 , která může být ovlivněna 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 uvádí pouze moduly runtime x86 a verze x64 sady SDK obsahuje pouze moduly runtime x64.

  • --list-sdks

    Vytiskne seznam nainstalovaných sad .NET SDK.

  • -?|-h|--help

    Vytiskne seznam dostupných příkazů.

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

Následující možnosti jsou pro dotnet příkaz. 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 ve všech příkazech. Pokud chcete zjistit, jestli je tato možnost dostupná, podívejte se na konkrétní stránku příkazu.

  • -?|-h|--help

    Vytiskne dokumentaci k danému příkazu. 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ých možností najdete na stránce konkrétního příkazu.

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ásady sondování a sestavení k testování. Opakováním možnosti zadejte více cest.

  • --additional-deps <PATH>

    Cesta k dalšímu souboru .deps.json Soubor deps.json obsahuje seznam závislostí, závislostí kompilace a informace o verzi, které se používají 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 má v aplikaci použít roll forward. Může SETTING to být jedna z následujících hodnot. Pokud není zadán, Minor je výchozí hodnota.

    • LatestPatch - Přejděte k nejvyšší verzi opravy. Tím se zakáže roll vpřed podverze.
    • Minor – Pokud požadovaná podverze chybí, můžete přejít na nejnižší vyšší podverzi. Pokud požadovaná podverze existuje, použije se zásada LatestPatch.
    • Major – Pokud požadovaná hlavní verze chybí, přejděte na nejnižší hlavní verzi a nejnižší podverzi. Pokud je k dispozici požadovaná hlavní verze, použije se zásada Podverze.
    • LatestMinor – Převést na nejvyšší podverzi, i když je k dispozici požadovaná podverze. Určeno pro scénáře hostování komponent.
    • LatestMajor – Přejděte na nejvyšší hlavní a nejvyšší podverzi, i když je k dispozici požadovaná hlavní verze. Určeno pro scénáře hostování komponent.
    • Disable - Nechoďte dopředu. Vytvořit vazbu pouze na zadanou verzi. Tato zásada se nedoporučuje pro obecné použití, protože zakazuje přechod k nejnovějším opravám. Tato hodnota se doporučuje pouze pro testování.

    S výjimkou nástroje Disablebudou všechna nastavení používat nejvyšší dostupnou verzi opravy.

    Chování roll forward je také možné nakonfigurovat ve vlastnosti souboru projektu, vlastnosti konfiguračního souboru modulu runtime a proměnné prostředí. Další informace najdete v tématu Hlavní verze modulu runtime roll forward.

  • --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 podle očekávání pouze v případě, že existuje pouze 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 je generován sadou .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 Interaguje 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 NÁSTROJE MSBuild.
dotnet new Inicializuje projekt jazyka C# nebo F# pro danou šablonu.
dotnet pack Vytvoří balíček NuGet vašeho kódu.
dotnet publish Publikuje aplikaci závislé na rozhraní .NET Framework nebo samostatnou aplikaci.
dotnet restore Obnoví závislosti pro danou aplikaci.
dotnet run Spustí aplikaci ze zdroje.
kontrola sady dotnet SDK Zobrazuje aktuální stav nainstalovaných verzí sady SDK a modulu runtime.
dotnet sln Možnosti přidání, odebrání a výpisu projektů v souboru řešení
dotnet store Ukládá sestavení v úložišti balíčků modulu runtime.
dotnet test Spouští testy pomocí nástroje test runner.

Odkazy na projekty

Příkaz Funkce
dotnet add reference Přidá odkaz na projekt.
dotnet list reference Vypíše 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ší zařazení balíčku 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ěť požadavků http, dočasná mezipaměť nebo složka globálních balíčků pro celý počítač.
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.
oprava úloh dotnet Opraví všechny nainstalované úlohy.
hledání úloh dotnet Uveďte seznam vybraných úloh nebo všech dostupných úloh.
odinstalace úloh dotnet Odinstaluje úlohu.
aktualizace úloh dotnet Přeinstaluje všechny nainstalované úlohy.

Příkazy globálních nástrojů, cesty k nástrojům a místním nástrojům

Nástroje jsou konzolové aplikace, které se instalují 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 pro cesty nástrojů a místní nástroje. Další informace najdete v tématu Přehled nástrojů .NET.

Příkaz Funkce
dotnet tool install Nainstaluje na váš počítač nástroj.
dotnet tool list Zobrazí seznam všech globálních nástrojů, nástrojů a 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 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
tajné kódy uživatele Spravuje vývojové tajné kódy uživatelů.
watch Sledovací nástroj souborů, který restartuje nebo znovu načte aplikaci za provozu, když zjistí změny ve zdrojovém kódu.

Další informace o každém nástroji potřebujete zadáním dotnet <tool-name> --helppříkazu .

Příklady

Vytvořte novou konzolovou aplikaci .NET:

dotnet new console

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

dotnet build

Spuštění aplikace:

dotnet exec myapp.dll

dotnet myapp.dll

Viz také