dotnet , polecenie
Ten artykuł dotyczy: ✔️ zestaw .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 .NET.
Na przykład
dotnet build
tworzy 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ę, oznacza znalezienie i wykonanie punktu wejścia, który w przypadku aplikacji konsolowych jestMain
metodą. Na przykładdotnet myapp.dll
uruchamia aplikacjęmyapp
. Zobacz Wdrażanie aplikacji .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 przez siebie 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, 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 platformy .NET. Wersja zestawu SDK w wersji x86 zawiera tylko środowiska uruchomieniowe x86, a wersja x64 zestawu SDK zawiera tylko środowiska uruchomieniowe x64.
--list-sdks
Wyświetla listę zainstalowanych zestawów SDK platformy .NET.
-?|-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]
, ,m[inimal]
,d[etailed]
n[ormal]
, idiag[nostic]
. Nieobsługiwane w każdym poleceniu. Zobacz konkretną stronę polecenia, aby określić, czy ta opcja jest dostępna.-?|-h|--help
Wyświetla dokumentację 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 sondy. 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 przesyłania dalej do 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 nie ma żą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, 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 głównej wersji. Przeznaczony dla scenariuszy hostingu składników.Disable
- Nie przerzucaj do przodu. Wiązanie tylko z określoną wersją. Te zasady nie są zalecane do użytku ogólnego, ponieważ wyłącza możliwość przesyłania dalej do najnowszych poprawek. Ta wartość jest zalecana tylko do testowania.
Z wyjątkiem opcji
Disable
wszystkie ustawienia będą używać najwyższej dostępnej wersji poprawki.Zachowanie wycofywania 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 Wdrażanie w czasie wykonywania wersji głównej.
--fx-version <VERSION>
Wersja środowiska uruchomieniowego platformy .NET do użycia do uruchamiania 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ż jedno odwołanie do 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 SDK platformy .NET.
--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żytkowników programistycznych. |
watch | 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
Uruchom aplikację:
dotnet exec myapp.dll
dotnet myapp.dll
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla