Sdílet prostřednictvím

dotnet command

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

Název

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

Přehled

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 <PATH>] [--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 vlastní možnosti a argumenty. Všechny příkazy podporují --help možnost tisku stručné dokumentace o tom, jak příkaz používat.

  • Spouští aplikace .NET.

    Zadáte cestu k souboru aplikace .dll pro spuštění aplikace. Spuštění aplikace znamená vyhledání a spuštění vstupního bodu, což v případě konzolových aplikací je metoda #D0. 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. Například dotnet --info nebo dotnet --version. Vypíše informace o prostředí.

  • --info

    Vytiskne podrobné informace o instalaci rozhraní .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 global.json souborem. K dispozici pouze v případech, kdy je sada SDK nainstalovaná.

  • --list-runtimes [--arch <ARCH>]

    Vytiskne seznam nainstalovaných modulů runtime .NET pro architekturu vyvolaného dotnetmodulu runtime . Verze dotnet x86 seznamů pouze modulu runtime x86 a verze dotnet x64 seznamů pouze moduly runtime x64.

    Argument podporují --arch .NET 10 a novější verze. Pokud je zadána a není stejná jako dotnet architektura, vyhledá instalaci rozhraní .NET zadané architektury a vytiskne všechny moduly runtime nainstalované tam. Povolené hodnoty zahrnují arm64, x64 a x86. Úložiště dotnet/runtime obsahuje úplný seznam platných hodnot architektury.

  • --list-sdks [--arch <ARCH>]

    Vytiskne seznam nainstalovaných sad .NET SDK pro architekturu vyvolaného dotnetsouboru . Verze dotnet x86 seznamů pouze x86 sdk a verze dotnet x64 seznamů pouze x64 SDK.

    Argument podporují --arch .NET 10 a novější verze. Pokud je zadaná a ne stejná jako dotnet architektura, vyhledá instalaci rozhraní .NET zadané architektury a vytiskne všechny sady SDK nainstalované tam. Povolené hodnoty zahrnují arm64, x64 a x86. Úložiště dotnet/runtime obsahuje úplný seznam platných hodnot architektury.

  • -?|-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. Například 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]. 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 zobrazí nápovědu k build příkazu.

  • 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říkazů.

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í 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 na aplikaci používá postup 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í hodnota.

    • 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 na nejnižší nižší podverzi. Pokud je požadovaná podverze k dispozici, použije se zásada LatestPatch.
    • Major – Pokud chybí požadovaná hlavní verze, přejděte na nejnižší vyšší hlavní verzi a nejnižší podverzi. Pokud je požadovaná hlavní verze přítomen, použije se podverze.
    • LatestMinor – Převést na nejvyšší podverzi, i když je požadovaná podverze k dispozici. Určeno pro scénáře hostování komponent.
    • LatestMajor – Přepočítejte se na nejvyšší hlavní a nejvyšší podverzi, i když je požadovaná hlavní verze přítomna. Určeno pro scénáře hostování komponent.
    • Disable - Neposouvejte se dopředu. Vytvořit vazbu pouze na zadanou verzi. Tato zásada se nedoporučuje pro obecné použití, protože zakazuje vrátit se k nejnovějším opravám. Tato hodnota se doporučuje jenom pro testování.

    S výjimkou Disable, všechna nastavení budou používat nejvyšší dostupnou verzi opravy.

    Chování roll forward lze také nakonfigurovat ve vlastnosti souboru projektu, vlastnosti konfiguračního souboru modulu runtime a proměnné prostředí. Další informace naleznete v tématu Modul runtime hlavní verze se posouvá vpřed.

  • --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.

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 souborudeps.json Soubordeps.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 <PATH>

    Cesta k souboruruntimeconfig.json Souborruntimeconfig.json obsahuje nastavení za běhu a obvykle se nazývá <název> aplikace.runtimeconfig.json. Pro více informací si přečtěte 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 Zobrazuje 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 vašeho kódu.
dotnet publish Publikuje aplikaci závislá na rozhraní .NET Framework nebo samostatná aplikace.
obnovení dotnet Obnoví závislosti pro danou aplikaci.
dotnet run Spustí aplikaci ze zdroje.
dotnet sdk – kontrola Zobrazuje up-tostav data nainstalovaných sad SDK a verzí modulu runtime.
dotnet sln Možnosti pro přidání, odebrání a výpis projektů v souboru řešení
dotnet restore Ukládá sestavení v úložišti balíčků modulu runtime.
dotnet test Spustí testy pomocí spouštěče testů.

Odkazy na projekt

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

Balíčky NuGet

Příkaz Funkce
dotnet package add Přidá balíček NuGet.
dotnet package list Vypíše balíčky NuGet.
dotnet balíček odstranit Odebere balíček NuGet.
dotnet package search Vyhledá 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 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 Aktualizuje zdroj NuGet.

Příkazy úloh

Příkaz Funkce
nainstalovat pracovní zatížení dotnet Nainstaluje volitelnou úlohu.
seznam pracovních zátěží dotnet Zobrazí seznam všech nainstalovaných úloh.
dotnet workload repair Opraví všechny nainstalované úlohy.
hledání úloh dotnet Zobrazí seznam vybraných úloh nebo všech dostupných úloh.
dotnet workload uninstall Odinstaluje úlohu.
aktualizace pracovních zátěží dotnet 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 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 pro cestu k nástrojům a místní nástroje. Další informace naleznete v přehledu nástrojů .NET.

Příkaz Funkce
dotnet tool install Nainstaluje na počítač nástroj.
seznam nástrojů dotnet Zobrazí všechny globální nástroje, cestu k nástrojům nebo místní nástroje, které jsou na vašem počítači aktuálně nainstalované.
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 Aktualizuje nástroj, který je 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

Sestavte projekt a jeho závislosti v daném adresáři:

dotnet build

Spusťte aplikaci:

dotnet exec myapp.dll

dotnet myapp.dll

Viz také