Udostępnij przez

dotnet tool exec (wykonanie narzędzia .NET)

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

Name

dotnet tool exec — Pobiera i wywołuje narzędzie .NET bez jego trwałego instalowania.

Streszczenie

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

Polecenie dotnet tool exec udostępnia tryb wywołania jednoskrętowego narzędzia dla narzędzi platformy .NET. Automatycznie pobiera określony pakiet narzędzi do pamięci podręcznej NuGet i wywołuje go bez modyfikowania systemu PATH lub konieczności stałego zainstalowania.

Po uruchomieniu dotnet tool execpolecenia polecenie :

  1. Sprawdza wersję (lub zakres wersji), którą określisz (lub najnowszą wersję, jeśli nie określono żadnej) względem skonfigurowanych źródeł danych NuGet, aby zdecydować, który pakiet ma być pobrany.
  2. Pobiera określony pakiet do pamięci podręcznej NuGet (jeśli jeszcze nie istnieje).
  3. Wywołuje narzędzie z dowolnymi podanymi argumentami.
  4. Zwraca kod zakończenia narzędzia.

dotnet tool exec bezproblemowo współpracuje zarówno z narzędziami globalnymi, jak i lokalnymi. Jeśli masz dostępny manifest narzędzia lokalnego, używa manifestu do określenia, która wersja narzędzia do uruchomienia.

To polecenie istnieje również w dwóch innych formach, aby ułatwić korzystanie

  • dotnet dnx- Ukryty alias, dotnet tool exec który jest używany jako sposób łatwego implementowania samego skryptu dnx
  • dnx — skrypt powłoki, który wywołuje dotnet dnx z zestawu SDK. Ten skrypt jest dostarczany przez instalatora i jest dostępny w witrynie PATH. Umożliwia bardzo proste korzystanie z narzędzi bezpośrednio za pośrednictwem programu dnx <toolname>.

Arguments

  • PACKAGE_NAME

    Identyfikator pakietu NuGet narzędzia .NET do wykonania. Opcjonalnie możesz określić wersję przy użyciu @ składni, na przykład dotnetsay@2.1.0.

  • tool-arguments

    Argumenty przekazywane do wykonywanego narzędzia. Wszystko po -- przekazaniu bezpośrednio do narzędzia.

Opcje

  • --allow-roll-forward

    Zezwól narzędziu na użycie nowszej wersji środowiska uruchomieniowego platformy .NET, jeśli środowisko uruchomieniowe, na którym się znajduje, nie jest zainstalowane.

  • --add-source <SOURCE>

    Dodaje dodatkowe źródło pakietu NuGet do użycia podczas instalacji. Kanały informacyjne są dostępne równolegle, a nie w sekwencji kaskadowej rezerwowej. Jeśli ten sam pakiet i wersja są dostępne w wielu kanałach informacyjnych, najszybsze źródło danych wygrywa. Aby uzyskać więcej informacji, zobacz Co się stanie po zainstalowaniu pakietu NuGet. Możesz to kontrolować za pomocą mapowania źródła pakietów NuGet. Aby uzyskać więcej informacji, zobacz Mapowanie źródła pakietów.

  • --configfile <FILE>

    Plik konfiguracji NuGet (nuget.config) do użycia. Jeśli zostanie określony, zostaną użyte tylko ustawienia z tego pliku. Jeśli nie zostanie określona, zostanie użyta hierarchia plików konfiguracji z bieżącego katalogu. Aby uzyskać więcej informacji, zobacz Typowe konfiguracje nuGet.

  • --disable-parallel

    Zapobiega przywracaniu wielu projektów równolegle.

  • --ignore-failed-sources

    Traktuje błędy źródła pakietu jako ostrzeżenia.

  • --interactive

    Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania.

  • --no-http-cache

    Nie buforuje żądań HTTP do skonfigurowanych źródeł danych NuGet.

  • --prerelease

    Umożliwia wybranie pakietów wstępnych podczas rozpoznawania wersji do zainstalowania.

  • --source <SOURCE>

    Określa źródło pakietów NuGet.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], , m[inimal]n[ormal], d[etailed], i diag[nostic]. Wartość domyślna to normal. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

Przykłady

  • dotnet tool exec dotnetsay

    Pobiera (w razie potrzeby) i uruchamia najnowszą wersję dotnetsay narzędzia.

  • dotnet tool exec dotnetsay@2.1.0

    Pobiera (w razie potrzeby) i uruchamia wersję 2.1.0 dotnetsay narzędzia.

  • dotnet tool exec dotnetsay@2.*

    Pobiera (w razie potrzeby) i uruchamia najnowszą wersję dotnetsay narzędzia w zakresie wersji 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Uruchamia narzędzie i przekazuje ciąg "Hello World" jako argumenty do narzędzia.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Pobiera i uruchamia przy mytool użyciu określonego źródła NuGet.

Porównanie z innymi poleceniami

To polecenie ma być ujednoliconym sposobem pracy z narzędziami platformy .NET. Chociaż wcześniej dostępne polecenia instalacji narzędzi pozostają dostępne, dotnet tool exec zapewnia prostsze i bardziej elastyczne środowisko dla większości użytkowników.

Command Przeznaczenie Instalacja Scope
dotnet tool exec Wykonywanie jednorazowe Brak (tylko buforowany) Temporary
dotnet tool install -g Stała instalacja globalna Global Szeroki system
dotnet tool install Stała instalacja lokalna Manifest lokalny Projekt
dotnet tool run Uruchamianie już zainstalowanego narzędzia lokalnego Wymaga wcześniejszej instalacji Projekt

Polecenie dotnet tool install -g nadal służy ważnemu celowi dla użytkowników, którzy chcą trwale zainstalować narzędzie. Jednak w przypadku użytkowników, którzy chcą wypróbować narzędzie lub uruchomić je w potoku ciągłej integracji/ciągłego wdrażania, dotnet tool exec często lepiej pasuje.

Zobacz także

  • Last updated on