Přehled rozhraní .NET CLI

  • Článek

Tento článek se týká: ✔️ .net Core 2,1 SDK a novějších verzí

Rozhraní příkazového řádku (CLI) .NET je sada nástrojů pro různé platformy pro vývoj, sestavování, spouštění a publikování aplikací .NET.

Rozhraní .NET CLI je součástí sady .NET SDK. Informace o tom, jak nainstalovat sadu .NET SDK, najdete v tématu instalace .NET Core.

Příkazy rozhraní CLI

Ve výchozím nastavení jsou nainstalovány následující příkazy:

Základní příkazy

Příkazy pro modifikaci projektů

Rozšířené příkazy

Příkazy správy nástrojů

nástroje jsou konzolové aplikace, které jsou nainstalované z balíčků NuGet a jsou vyvolány z příkazového řádku. Můžete psát nástroje sami nebo instalovat nástroje napsané třetí stranou. Nástroje jsou také známé jako globální nástroje, nástroje pro cestu nástrojů a místní nástroje. Další informace najdete v tématu Přehled nástrojů .NET.

Struktura příkazu

Struktura příkazu rozhraní příkazového řádku se skládá z ovladače ("dotnet"), příkazua možných argumentů příkazů a možností. Tento model se zobrazí ve většině operací CLI, jako je například vytvoření nové konzolové aplikace a její spuštění z příkazového řádku, protože následující příkazy se zobrazí při spuštění z adresáře s názvem my_app:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Ovladač

Ovladač má název dotnet a má dvě zodpovědnosti, buď spuštění aplikace závislé na rozhraní , nebo spuštění příkazu.

Chcete-li spustit aplikaci závislou na rozhraní, zadejte aplikaci za ovladačem, například dotnet /path/to/my_app.dll . Při provádění příkazu ze složky, kde se nachází knihovna DLL aplikace, stačí provést dotnet my_app.dll . Pokud chcete použít konkrétní verzi modulu .NET runtime, použijte --fx-version <VERSION> možnost (viz Referenční dokumentace --fx-version <VERSION> ).

Když zadáte příkaz do ovladače, dotnet.exe spustí se proces spuštění příkazu CLI. Například:

dotnet build

Nejdřív ovladač určuje verzi sady SDK, která se má použít. Pokud není k dispozici žádný soubor Global. JSON , použije se nejnovější verze sady SDK. To může být buď verze Preview, nebo stabilní, v závislosti na tom, co je v počítači nejnovější. Po určení verze sady SDK se spustí příkaz.

Příkaz

Příkaz provede akci. Například dotnet build sestavení kódu. dotnet publish publikuje kód. Příkazy jsou implementovány jako Konzolová aplikace pomocí dotnet {command} konvence.

Argumenty

Argumenty, které předáte na příkazovém řádku, jsou argumenty příkazu, který jste vyvolali. Například když dotnet publish my_app.csproj spustíte, my_app.csproj argument označuje projekt k publikování a je předán do publish příkazu.

Možnosti

Možnosti, které zadáte na příkazovém řádku, jsou možnosti vyvolání příkazu. Například když dotnet publish --output /build_output spustíte, --output možnost a její hodnota jsou předány do publish příkazu.

Viz také