dotnet – příkaz
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ž jeMain
v případě konzolových aplikací metoda. Napříkladdotnet 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]
adiag[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ědubuild
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
Disable
budou 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> --help
pří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é
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro