dotnet — polecenie

Ten artykuł dotyczy: ✔️ zestaw .NET 6 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 <PATH>] [--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 sposobu używania 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 konsoli jest metodą #D0. 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ń

Następujące 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, oraz zatwierdzanie algorytmu SHA wersji platformy .NET.

• --version

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

• --list-runtimes [--arch <ARCH>]

  Wyświetla listę zainstalowanych środowisk uruchomieniowych platformy .NET dla architektury wywoływanego dotnetelementu . Wersja dotnet x86 list zawiera tylko środowiska uruchomieniowe x86, a wersja dotnet x64 list zawiera tylko środowiska uruchomieniowe x64.

  Platforma .NET 10 i nowsze wersje obsługują --arch argument . Jeśli jest określona, a nie taka sama jak dotnet architektura, wyszukuje instalację platformy .NET określonej architektury i wyświetla wszystkie zainstalowane tam środowiska uruchomieniowe. Dozwolone wartości obejmują arm64, x64 i x86. Repozytorium dotnet/runtime zawiera pełną listę prawidłowych wartości architektury.

• --list-sdks [--arch <ARCH>]

  Wyświetla listę zainstalowanych zestawów SDK platformy .NET dla architektury wywoływanego dotnetelementu . Wersja x86 list zawiera tylko zestawy SDK x86 dotnet i wersję x64 list tylko zestawów dotnet SDK x64.

  Platforma .NET 10 i nowsze wersje obsługują --arch argument . Jeśli określono tę samą architekturę, a nie taką samą jak dotnet architektura, wyszukuje instalację platformy .NET określonej architektury i wyświetla zainstalowane tam zestawy SDK. Dozwolone wartości obejmują arm64, x64 i x86. Repozytorium dotnet/runtime zawiera pełną listę prawidłowych wartości architektury.

• -?|-h|--help

  Wyświetla listę dostępnych poleceń.

Opcje uruchamiania polecenia

Następujące 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], m[inimal], n[ormal], d[etailed]i diag[nostic]. Nieobsługiwane w każdym poleceniu. Zobacz konkretną stronę polecenia, 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 dotyczącą build polecenia .

• command options

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

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 tę 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 w 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 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 — Przejdź do najniższej wyższej wersji głównej i najniższej wersji pomocniczej, jeśli zażądano wersji głównej. Jeśli żądana wersja główna jest obecna, zostaną użyte zasady pomocnicze.
  • LatestMinor — Przerzuć do najwyższej wersji pomocniczej, nawet jeśli zażądano wersji pomocniczej. 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 się do przodu. Wiązanie 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 programu Disablewszystkie ustawienia będą używać najwyższej dostępnej wersji poprawki.

  Zachowanie wycofywania 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 Wdrażanie w wersji głównej środowiska uruchomieniowego.

• --fx-version <VERSION>

  Wersja środowiska uruchomieniowego platformy .NET do uruchomienia aplikacji.

  Ta opcja zastępuje wersję pierwszego odwołania do platformy w pliku aplikacji .runtimeconfig.json . 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

Następujące 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 środowiska uruchomieniowego i zazwyczaj nosi nazwę <applicationname>.runtimeconfig.json. Aby uzyskać więcej informacji, zobacz ustawienia konfiguracji środowiska uruchomieniowego .NET w .

polecenia dotnet

Ogólne

Komenda	Funkcja
zbuduj dotnet	Kompiluje aplikację .NET.
dotnet build-server	Współdziała z serwerami uruchomionymi przez kompilację.
dotnet clean	Czyszczenie danych wyjściowych kompilacji.
dotnet exec	Uruchamia aplikację .NET.
dotnet — pomoc	Zawiera bardziej szczegółową dokumentację w trybie online dla polecenia .
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 up-to— stan daty 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.

Referencje projektowe

Komenda	Funkcja
dotnet reference add - komenda dodawania odwołania w .NET	Dodaje odwołanie do projektu.
dotnet lista odniesień	Wyświetla listę odwołań do projektu.
dotnet reference remove	Usuwa odwołanie do projektu.

Pakiety NuGet

Komenda	Funkcja
dotnet package add	Dodaje pakiet NuGet.
dotnet package list	Wyświetla listę pakietów NuGet.
dotnet usuń pakiet	Usuwa pakiet NuGet.
wyszukiwanie pakietów dotnet	Wyszukuje pakiet NuGet.

Polecenia Narzędzia NuGet

Komenda	Funkcja
dotnet nuget delete	Usuwa lub usuwa pakiet z serwera.
dotnet nuget push	Wypycha pakiet do serwera i publikuje go.
dotnet nuget locals	Czyści lub wyświetla lokalne zasoby NuGet, takie jak pamięć podręczna http-request, tymczasowa pamięć podręczna lub folder pakietów globalnych dla całej maszyny.
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	Aktualizuje źródło NuGet.

Polecenia obciążenia

Komenda	Funkcja
dotnet workload clean	Usuwa składniki obciążenia.
dotnet workload config	Włącza lub wyłącza tryb aktualizacji zestawu obciążeń.
dotnet workload history (historia obciążeń dotnet)	Pokazuje wszystkie akcje instalacji obciążenia.
zainstaluj obciążenie dotnet	Instaluje opcjonalne obciążenie.
lista obciążeń dotnet	Wyświetla listę wszystkich zainstalowanych obciążeń.
naprawa pakietów roboczych dotnet	Naprawia wszystkie zainstalowane obciążenia.
dotnet workload restore (przywracanie obciążenia dotnet)	Przywracanie obciążeń wymaganych dla projektu.
wyszukiwania obciążeń dotnet	Wyświetl listę wybranych obciążeń lub wszystkich dostępnych obciążeń.
odinstalowywanie obciążenia dotnet	Odinstalowuje obciążenie.
aktualizacja pakietów roboczych dotnet	Ponownie instaluje wszystkie zainstalowane obciążenia.

Polecenia globalne, ścieżki narzędzi i narzędzi lokalnych

Narzędzia to aplikacje konsolowe instalowane z pakietów NuGet i 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.

Komenda	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 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

Następujące dodatkowe narzędzia są dostępne jako część 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żytkowników programistycznych.
zegarek	Obserwator plików, który uruchamia ponownie lub ponownie ładuje aplikację podczas wykrywania 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

Uruchamianie aplikacji:

dotnet exec myapp.dll

dotnet myapp.dll

Zobacz też

• Zmienne środowiskowe używane przez zestaw .NET SDK, interfejs wiersza polecenia platformy .NET i środowisko uruchomieniowe platformy .NET
• Pliki konfiguracji środowiska uruchomieniowego
• Ustawienia konfiguracji środowiska uruchomieniowego platformy .NET