dotnet — polecenie

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet — ogólny sterownik interfejsu wiersza polecenia platformy .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>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Opis

Polecenie dotnet ma dwie funkcje:

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

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

  • Uruchamia aplikacje .NET.

    Należy określić ścieżkę do pliku aplikacji .dll , aby uruchomić aplikację. Aby uruchomić aplikację, należy znaleźć i wykonać punkt wejścia, który w przypadku aplikacji konsolowych Main jest metodą . Na przykład dotnet myapp.dll uruchamia aplikację myapp . Zobacz Wdrażanie aplikacji platformy .NET , aby dowiedzieć się więcej o opcjach wdrażania.

Opcje

Dostępne są różne opcje:

  • Wyświetlanie informacji o środowisku.
  • Uruchamianie polecenia.
  • Uruchamianie aplikacji.

Opcje wyświetlania informacji o środowisku i dostępnych poleceń

Poniższe opcje są dostępne, gdy dotnet są używane samodzielnie, bez określania polecenia lub aplikacji do uruchomienia. Na przykład: dotnet --info lub dotnet --version. Wyświetlają informacje o środowisku.

  • --info

    Wyświetla szczegółowe informacje o instalacji platformy .NET i środowisku maszyny, takie jak bieżący system operacyjny, i zatwierdza algorytm SHA wersji platformy .NET.

  • --version

Drukuje wersję zestawu .NET SDK używanego przez dotnet polecenia, które mogą mieć wpływ na plik global.json . Dostępne tylko wtedy, gdy zestaw SDK jest zainstalowany.

  • --list-runtimes

    Wyświetla 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

    Wyświetla listę zainstalowanych zestawów .NET SDK.

  • -?|-h|--help

    Wyświetla listę dostępnych poleceń.

Opcje uruchamiania polecenia

Poniższe opcje dotyczą dotnet polecenia . Na przykład: dotnet build --help lub dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Włącza dane wyjściowe diagnostyczne.

  • -v|--verbosity <LEVEL>

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

  • -?|-h|--help

    Drukuje dokumentację dla danego polecenia. Na przykład dotnet build --help wyświetla pomoc dla build polecenia .

  • command options

    Każde polecenie definiuje opcje specyficzne dla tego polecenia. Aby uzyskać listę dostępnych opcji, zobacz konkretną stronę poleceń.

Opcje uruchamiania aplikacji

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

  • --additionalprobingpath <PATH>

    Ścieżka zawierająca zasady sondowania i zestawy do sondowania. Powtórz opcję , aby określić wiele ścieżek.

  • --additional-deps <PATH>

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

  • --roll-forward <SETTING> **

    Określa sposób wprowadzania do przodu aplikacji. Może SETTING to być jedna z następujących wartości. Jeśli nie zostanie określony, Minor jest wartością domyślną.

    • LatestPatch — Przerzuć do przodu do najwyższej wersji poprawki. Spowoduje to wyłączenie wycofywania wersji pomocniczej.
    • Minor — Przerzuć do najniższej wyższej wersji pomocniczej, jeśli brakuje żądanej wersji pomocniczej. Jeśli żądana wersja pomocnicza jest obecna, zostaną użyte zasady LatestPatch.
    • Major — Przerzuć do najniższej wyższej wersji głównej i najniższej wersji pomocniczej, jeśli brakuje żądanej wersji głównej. Jeśli żądana wersja główna jest obecna, są używane zasady pomocnicze.
    • LatestMinor — Przerzuć do najwyższej wersji pomocniczej, nawet jeśli jest dostępna żądana wersja pomocnicza. Przeznaczony dla scenariuszy hostingu składników.
    • LatestMajor - Przerzuć do najwyższej wersji głównej i najwyższej wersji pomocniczej, nawet jeśli zażądano wersji głównej. Przeznaczony dla scenariuszy hostingu składników.
    • Disable - Nie przerzucaj do przodu. 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 opcji Disablewszystkie ustawienia będą używać najwyższej dostępnej wersji poprawki.

    Zachowanie roll forward można również skonfigurować w właściwości pliku projektu, właściwości pliku konfiguracji środowiska uruchomieniowego i zmiennej środowiskowej. Aby uzyskać więcej informacji, zobacz Wdrożenie środowiska uruchomieniowego wersji głównej.

  • --fx-version <VERSION>

    Wersja środowiska uruchomieniowego platformy .NET do uruchomienia aplikacji.

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

Opcje uruchamiania aplikacji za exec pomocą polecenia

Poniższe opcje są dostępne tylko w przypadku dotnet uruchamiania aplikacji przy użyciu exec polecenia . Na przykład dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Ścieżka do pliku deps.json . Plik deps.json to plik konfiguracji zawierający informacje o zależnościach niezbędnych do uruchomienia aplikacji. Ten plik jest generowany przez zestaw .NET SDK.

  • --runtimeconfig <PATH>

    Ścieżka do pliku runtimeconfig.json . Plik runtimeconfig.json zawiera ustawienia czasu wykonywania i zazwyczaj nosi nazwę <applicationname.runtimeconfig.json>. Aby uzyskać więcej informacji, zobacz Ustawienia konfiguracji środowiska uruchomieniowego platformy .NET.

Polecenia dotnet

Ogólne

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

Odwołania projektu

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

Pakiety NuGet

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

Polecenia Narzędzia NuGet

Polecenie Funkcja
dotnet nuget delete Usuwa lub usuwa listę pakietu z serwera.
dotnet nuget push Wypycha pakiet na serwer i publikuje go.
dotnet nuget locals Czyści lub wyświetla listę lokalnych zasobów NuGet, takich jak pamięć podręczna http-request, tymczasowa pamięć podręczna lub folder pakietów globalnych całego komputera.
dotnet nuget add source Dodaje źródło NuGet.
dotnet nuget disable source Wyłącza źródło NuGet.
dotnet nuget enable source Włącza źródło NuGet.
dotnet nuget list source Wyświetla listę wszystkich skonfigurowanych źródeł NuGet.
dotnet nuget remove source Usuwa źródło NuGet.
dotnet nuget update source Aktualizacje źródła NuGet.

Polecenia obciążenia

Polecenie Funkcja
dotnet workload install (instalacja obciążenia dotnet) Instaluje opcjonalne obciążenie.
dotnet workload list Wyświetla listę wszystkich zainstalowanych obciążeń.
dotnet workload repair (naprawa obciążenia dotnet) Naprawia wszystkie zainstalowane obciążenia.
wyszukiwanie obciążeń dotnet Wyświetl listę wybranych obciążeń lub wszystkich dostępnych obciążeń.
odinstalowywanie obciążenia dotnet Odinstalowuje obciążenie.
dotnet workload update Ponownie instaluje wszystkie zainstalowane obciążenia.

Polecenia globalnych, ścieżek narzędzi i narzędzi lokalnych

Narzędzia to aplikacje konsolowe, które są instalowane z pakietów NuGet i są wywoływane z wiersza polecenia. Narzędzia można pisać samodzielnie lub instalować narzędzia napisane przez inne firmy. Narzędzia są również nazywane narzędziami globalnymi, narzędziami ścieżki narzędzi i narzędziami lokalnymi. Aby uzyskać więcej informacji, zobacz Omówienie narzędzi .NET.

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

Dodatkowe narzędzia

Następujące dodatkowe narzędzia są dostępne w ramach zestawu .NET SDK:

Narzędzie Funkcja
certyfikaty dev-cert Tworzy certyfikaty programistyczne i zarządza nimi.
Ef Narzędzia wiersza polecenia platformy Entity Framework Core.
wpisy tajne użytkownika Zarządza wpisami tajnymi użytkownika programistycznego.
Oglądać Obserwator plików, który uruchamia ponownie lub ponownie ładuje aplikację po wykryciu zmian w kodzie źródłowym.

Aby uzyskać więcej informacji na temat każdego narzędzia, wpisz dotnet <tool-name> --help.

Przykłady

Utwórz nową aplikację konsolową platformy .NET:

dotnet new console

Skompiluj projekt i jego zależności w danym katalogu:

dotnet build

Uruchom aplikację:

dotnet exec myapp.dll
dotnet myapp.dll

Zobacz też