Omówienie interfejsu wiersza polecenia .NET
Ten artykuł dotyczy: ✔️ zestawu .NET Core 2.1 SDK i jego nowszych wersji
Interfejs wiersza polecenia platformy .NET to międzyplatformowy zestaw narzędzi do tworzenia, budowania, uruchamiania i publikowania aplikacji .NET.
Interfejs wiersza polecenia platformy .NET jest dołączony do zestawu .NET SDK. Aby dowiedzieć się, jak zainstalować zestaw .NET SDK, zobacz Instalowanie platformy .NET Core.
Polecenia interfejsu wiersza polecenia
Domyślnie instalowane są następujące polecenia:
Polecenia podstawowe
Polecenia modyfikacji projektu
Polecenia zaawansowane
Polecenia zarządzania narzędziami
tool install
tool list
tool update
tool restore
Dostępne od zestaw .NET Core SDK 3.0.tool run
Dostępne od zestaw .NET Core SDK 3.0.tool uninstall
Narzędzia to aplikacje konsolowe instalowane z NuGet pakietów i wywoływane z wiersza polecenia. Możesz pisać narzędzia samodzielnie lub instalować narzędzia napisane przez inne firmy. Narzędzia są również znane jako narzędzia globalne, narzędzia ścieżki narzędzi i narzędzia lokalne. Aby uzyskać więcej informacji, zobacz Omówienie narzędzi .NET.
Struktura poleceń
Struktura poleceń interfejsu wiersza polecenia składa się ze sterownika ("dotnet"), polecenia oraz prawdopodobnie argumentów iopcji polecenia. Ten wzorzec jest wyświetlony w większości operacji interfejsu wiersza polecenia, takich jak tworzenie nowej aplikacji konsolowej i uruchamianie jej z wiersza polecenia, jak po wykonaniu z katalogu o nazwie my_app:
dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll
Sterownik
Sterownik ma nazwę dotnet i ma dwie obowiązki: uruchamianie aplikacji zależnej od struktury lub wykonywanie polecenia.
Aby uruchomić aplikację zależną od struktury, określ aplikację po sterowniku, na przykład dotnet /path/to/my_app.dll
. Podczas wykonywania polecenia z folderu, w którym znajduje się biblioteka DLL aplikacji, po prostu wykonaj polecenie dotnet my_app.dll
. Jeśli chcesz użyć określonej wersji środowiska uruchomieniowego .NET, użyj --fx-version <VERSION>
opcji (zobacz --fx-version <VERSION>
).
Po podaniem polecenia do sterownika program dotnet.exe
uruchamia proces wykonywania polecenia interfejsu wiersza polecenia. Na przykład:
dotnet build
Najpierw sterownik określa wersję zestawu SDK do użycia. Jeśli nie ma pliku global.json , używana jest najnowsza dostępna wersja zestawu SDK. Może to być wersja zapoznawcza lub stabilna, w zależności od najnowszej wersji na maszynie. Po ujednaniu wersji zestawu SDK jest wykonywane polecenie .
Polecenie
Polecenie wykonuje akcję. Na przykład tworzy dotnet build
kod. dotnet publish
publikuje kod. Polecenia są implementowane jako aplikacja konsolowa przy użyciu dotnet {command}
konwencji.
Argumenty
Argumenty, które należy przekazać w wierszu polecenia, są argumentami wywoływanego polecenia. Na przykład podczas wykonywania argument dotnet publish my_app.csproj
my_app.csproj
wskazuje projekt do opublikowania i jest przekazywany do publish
polecenia .
Opcje
Opcje, które są dostępne w wierszu polecenia, to opcje wywoływanego polecenia. Na przykład podczas wykonywania polecenia dotnet publish --output /build_output
opcja --output
i jej wartość są przekazywane do publish
polecenia .