dotnet, polecenie

Ten artykuł dotyczy: ✔️ zestawu .NET Core 2.1 SDK i jego nowszych wersji

Nazwa

dotnet — ogólny sterownik interfejsu wiersza polecenia .NET.

Streszczenie

Aby uzyskać informacje o dostępnych poleceniach i środowisku:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Aby uruchomić polecenie (wymaga instalacji zestawu SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Aby uruchomić aplikację:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

--roll-forward Program jest dostępny od wersji .NET Core 3.x. Użyj --roll-forward-on-no-candidate-fx dla .NET Core 2.x.

Opis

Polecenie dotnet ma dwie funkcje:

  • Udostępnia polecenia do pracy z projektami .NET.

    Na przykład dotnet build tworzy projekt. Każde polecenie definiuje własne opcje i argumenty. Wszystkie polecenia obsługują --help opcję drukowania krótkiej dokumentacji dotyczącej sposobu używania polecenia.

  • Uruchamia aplikacje .NET.

    Należy określić ścieżkę do pliku .dll aplikacji, aby uruchomić aplikację. Uruchomienie aplikacji oznacza znalezienie i wykonanie punktu wejścia, który w przypadku aplikacji konsolowych jest Main metodą . Na przykład dotnet myapp.dll program uruchamia myapp aplikację. Zobacz wdrażanie aplikacji .NET, aby dowiedzieć się więcej o opcjach wdrażania.

Opcje

Dostępne są różne opcje dotnet dla siebie, uruchamiania polecenia i uruchamiania aplikacji.

Opcje dla samego dotnet

Poniższe opcje są dostępne dotnet samodzielnie. Na przykład dotnet --info. Wypisują informacje o środowisku.

  • --info

    Drukuje szczegółowe informacje o instalacji .NET i środowiska komputera, takie jak bieżący system operacyjny i zatwierdzania SHA wersji .NET.

  • --version

Drukuje wersję zestawu .NET SDK używaną przez polecenia dotnet. Zawiera efekty dowolnego global.json

  • --list-runtimes

    Drukuje listę zainstalowanych środowisk uruchomieniowych .NET. Wersja x86 zestawu SDK zawiera tylko środowiska uruchomieniowe x86, a wersja x64 zestawu SDK zawiera tylko środowiska uruchomieniowe x64.

  • --list-sdks

    Drukuje listę zainstalowanych zestawów SDK .NET.

  • -?|-h|--help

    Drukuje listę dostępnych poleceń.

Opcje zestawu SDK do uruchamiania polecenia

Poniższe opcje są dla dotnet za pomocą polecenia. Na przykład dotnet build --help.

  • -d|--diagnostics

    Włącza diagnostyczne dane wyjściowe.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet] , , , i m[inimal] n[ormal] d[etailed] diag[nostic] . Nie jest obsługiwane w każdym poleceniu. Zobacz stronę określonego polecenia, aby określić, czy ta opcja jest dostępna.

  • -?|-h|--help

    Drukuje dokumentację dla danego polecenia, na przykład dotnet build --help .

  • command options

    Każde polecenie definiuje opcje specyficzne dla tego polecenia. Lista dostępnych opcji jest dostępna na stronie określonego polecenia.

Opcje środowiska uruchomieniowego

Podczas działania aplikacji dostępne są dotnet następujące opcje. Na przykład dotnet myapp.dll --roll-forward Major.

  • --additionalprobingpath <PATH>

    Ścieżka zawierająca zasady sondowania i zestawy do sondy.

  • --additional-deps <PATH>

    Ścieżka do dodatkowego pliku deps.json. Plik deps.json zawiera listę zależności, zależności kompilacji i informacji o wersji używanych do rozwiązywania konfliktów zestawu. Aby uzyskać więcej informacji, zobacz Pliki konfiguracji środowiska uruchomieniowego na GitHub.

  • --depsfile <PATH_TO_DEPSFILE>

    Ścieżka do pliku deps.json. Plik deps.json to plik konfiguracji, który zawiera informacje o zależnościach niezbędnych do uruchomienia aplikacji. Ten plik jest generowany przez zestaw SDK platformy .NET.

  • --runtimeconfig

    Ścieżka do pliku runtimeconfig.json. Plik runtimeconfig.json to plik konfiguracji, który zawiera ustawienia środowiska uruchomieniowego. Aby uzyskać więcej informacji, zobacz Ustawienia konfiguracji środowiska uruchomieniowego .NET.

  • **--roll-forward <SETTING>**Dostępne od wersji zestaw .NET Core SDK 3.0.

    Określa sposób stosowania rzutowania do przodu do aplikacji. Wartość SETTING może być jedną z następujących wartości. Jeśli nie zostanie określony, Minor jest wartością domyślną.

    • LatestPatch — Przekieruj do najwyższej wersji poprawki. Spowoduje to wyłączenie przekazywania wersji pomocniczej.
    • Minor — Przekieruj do najniższej wyższej wersji pomocniczej, jeśli brakuje żądanej wersji pomocniczej. Jeśli istnieje żądana wersja pomocnicza, używane są zasady LatestPatch.
    • Major — Przekieruj do najniższej wyższej wersji głównej i najniższej wersji pomocniczej, jeśli brakuje wymaganej wersji głównej. Jeśli istnieje żądana wersja główna, używane są zasady pomocnicze.
    • LatestMinor — Przekieruj do najwyższej wersji pomocniczej, nawet jeśli istnieje żądana wersja pomocnicza. Przeznaczony do scenariuszy hostingu składników.
    • LatestMajor — Przekieruj do wersji najwyższej i najwyższej wersji pomocniczej, nawet jeśli istnieje żądana wersja główna. Przeznaczony do scenariuszy hostingu składników.
    • Disable — Nie wycofuj. Powiąż tylko z określoną wersją. Te zasady nie są zalecane do użytku ogólnego, ponieważ wyłącza możliwość przekazywania do najnowszych poprawek. Ta wartość jest zalecana tylko do testowania.

    Z wyjątkiem , Disable wszystkie ustawienia będą używać najwyższej dostępnej wersji poprawki.

    Zachowanie przekazywania do przodu można również skonfigurować we właściwości pliku projektu, właściwości pliku konfiguracji środowiska uruchomieniowego i zmiennej środowiskowej. Aby uzyskać więcej informacji, zobacz Wersja główna środowiska uruchomieniowego przekierowywała .

  • **--roll-forward-on-no-candidate-fx <N>**Dostępne w zestawie .NET Core 2.x SDK.

    Definiuje zachowanie, gdy wymagana udostępniona framework nie jest dostępna. N Może to być:

    • 0 — Wyłącz nawet wersję pomocniczą do przodu.
    • 1 — Przekieruj do przodu w wersji pomocniczej, ale nie w wersji najważniejszej. Jest to zachowanie domyślne.
    • 2 — Przekieruj do przodu w wersjach pomocniczych i głównych.

    Aby uzyskać więcej informacji, zobacz Roll forward .

    Począwszy od .NET Core 3.0, ta opcja jest przesłoowana przez , i należy jej --roll-forward użyć zamiast tego.

  • --fx-version <VERSION>

    Wersja środowiska uruchomieniowego .NET do użycia w celu uruchomienia aplikacji.

    Ta opcja zastępuje wersję pierwszego odwołania do struktury w pliku .runtimeconfig.json aplikacji. Oznacza to, że działa ona zgodnie z oczekiwaniami tylko wtedy, gdy istnieje tylko jedno odwołanie do struktury. Jeśli aplikacja ma więcej niż jedno odwołanie do struktury, użycie tej opcji może spowodować błędy.

Polecenia dotnet

Ogólne

Polecenie Funkcja
dotnet build Tworzy aplikację .NET.
dotnet build-server Współdziała z serwerami uruchomionymi przez kompilację.
dotnet clean Czyszczenie danych wyjściowych kompilacji.
dotnet help Wyświetla bardziej szczegółową dokumentację polecenia w trybie online.
dotnet migrate Migruje prawidłowy projekt w wersji zapoznawczej 2 do zestaw .NET Core SDK 1.0.
dotnet msbuild Zapewnia dostęp do MSBuild wiersza polecenia.
dotnet new Inicjuje projekt w języku C# lub F# dla danego szablonu.
dotnet pack Tworzy NuGet pakietu kodu.
dotnet publish Publikuje aplikację zależną od struktury .NET lub samodzielną.
dotnet restore Przywraca zależności dla danej aplikacji.
dotnet run Uruchamia aplikację ze źródła.
dotnet sdk check Przedstawia aktualny stan zainstalowanych wersji zestawu SDK i środowiska uruchomieniowego.
dotnet sln Opcje dodawania, usuwania i listy projektów w pliku rozwiązania.
dotnet store Przechowuje zestawy w magazynie pakietów środowiska uruchomieniowego.
dotnet test Uruchamia testy przy użyciu narzędzia do uruchamiania testów.

Odwołania projektu

Polecenie Funkcja
dotnet add reference Dodaje odwołanie do projektu.
dotnet list reference Wyświetla listę odwołań do projektu.
dotnet remove reference Usuwa odwołanie do projektu.

Pakiety NuGet

Polecenie Funkcja
dotnet add package Dodaje NuGet pakietu.
dotnet remove package Usuwa NuGet pakietu.

NuGet polecenia

Polecenie Funkcja
dotnet nuget delete Usuwa lub usuwa pakiet z serwera.
dotnet nuget push Wypycha pakiet na serwer i publikuje go.
dotnet nuget locals Czyszczy lub wyświetla lokalne NuGet zasobów, takich jak pamięć podręczna żądania HTTP, tymczasowa pamięć podręczna lub globalny folder pakietów na całym komputerze.
dotnet nuget add source Dodaje NuGet źródłowego.
dotnet nuget disable source Wyłącza NuGet źródła.
dotnet nuget enable source Włącza NuGet danych.
dotnet nuget list source Wyświetla listę wszystkich skonfigurowanych NuGet źródeł.
dotnet nuget remove source Usuwa NuGet źródłowego.
dotnet nuget update source Aktualizuje NuGet źródłowego.

Polecenia obciążenia

Polecenie Funkcja
dotnet workload install Instaluje opcjonalne obciążenie.
dotnet workload list Wyświetla listę wszystkich zainstalowanych obciążeń.
dotnet workload repair Naprawia wszystkie zainstalowane obciążenia.
dotnet workload search Lista wybranych obciążeń lub wszystkich dostępnych obciążeń.
dotnet workload uninstall Odinstalowuje obciążenie.
dotnet workload update Ponownie instaluje wszystkie zainstalowane obciążenia.

Polecenia globalne, ścieżki narzędzi i narzędzia lokalne

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. Narzędzia globalne i narzędzia ścieżki są dostępne od wersji zestaw .NET Core SDK 2.1. Narzędzia lokalne są dostępne od wersji zestaw .NET Core SDK 3.0.

Polecenie Funkcja
dotnet tool install Instaluje narzędzie na maszynie.
dotnet tool list Wyświetla listę wszystkich narzędzi globalnych, ścieżek narzędzi lub narzędzi lokalnych aktualnie zainstalowanych na maszynie.
dotnet tool search Wyszukuje NuGet.org dla narzędzi, które mają określony termin wyszukiwania w nazwie lub metadanych.
dotnet tool uninstall Odinstalowuje narzędzie z komputera.
dotnet tool update Aktualizuje narzędzie zainstalowane na maszynie.

Dodatkowe narzędzia

Począwszy od wersji zestaw .NET Core SDK 2.1.300, wiele narzędzi, które były dostępne tylko na podstawie projektu przy użyciu programu , jest teraz dostępnych jako część DotnetCliToolReference zestawu SDK platformy .NET. Te narzędzia zostały wymienione w poniższej tabeli:

Narzędzie Funkcja
dev-certs Tworzy certyfikaty dewelopera i zarządza nimi.
Ef Entity Framework Core narzędzia wiersza polecenia.
wpisy tajne użytkowników Zarządza wpisami tajnymi użytkowników programistów.
Oglądać Uruchamia program File Watcher, który uruchamia polecenie po zmianie plików.

Aby uzyskać więcej informacji o każdym narzędziu, wpisz dotnet <tool-name> --help .

Przykłady

Utwórz nową aplikację konsolowa .NET:

dotnet new console

Skompilowanie projektu i jego zależności w danym katalogu:

dotnet build

Uruchamianie aplikacji:

dotnet myapp.dll

Zobacz też