dotnet tool install

  • Artykuł

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

Nazwisko

dotnet tool install — Instaluje określone narzędzie .NET na maszynie.

Streszczenie

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

opis

Polecenie dotnet tool install umożliwia zainstalowanie narzędzi platformy .NET na maszynie. Aby użyć polecenia , należy określić jedną z następujących opcji instalacji:

  • Aby zainstalować narzędzie globalne w domyślnej lokalizacji, użyj --global opcji .
  • Aby zainstalować narzędzie globalne w lokalizacji niestandardowej, użyj --tool-path opcji .
  • Aby zainstalować narzędzie lokalne, pomiń --global opcje i --tool-path .

Lokalizacje instalacji

Narzędzia globalne

Narzędzia globalne są instalowane w następujących katalogach domyślnie po określeniu -g opcji lub --global :

System operacyjny Ścieżka
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Pliki wykonywalne są generowane w tych folderach dla każdego narzędzia zainstalowanego globalnie, chociaż rzeczywiste pliki binarne narzędzi są zagnieżdżone głęboko w katalogu równorzędnym .store .

--tool-path Narzędzia

Narzędzia z jawnymi ścieżkami narzędzi są przechowywane wszędzie tam, gdzie określono --tool-path parametr do wskazania. Są one przechowywane w taki sam sposób jak narzędzia globalne: plik binarny wykonywalny z rzeczywistymi plikami binarnymi w katalogu równorzędnym .store .

Narzędzia lokalne

Narzędzia lokalne są przechowywane w katalogu globalnym NuGet, bez względu na to, co zostało ustawione. Istnieją pliki podkładki dla $HOME/.dotnet/toolResolverCache każdego narzędzia lokalnego, które wskazują, gdzie narzędzia znajdują się w tej lokalizacji.

Odwołania do narzędzi lokalnych są dodawane do pliku dotnet-tools.json w katalogu .config w bieżącym katalogu. Jeśli plik manifestu jeszcze nie istnieje, utwórz go przy użyciu --create-manifest-if-needed opcji lub uruchamiając następujące polecenie:

dotnet new tool-manifest

Aby uzyskać więcej informacji, zobacz Instalowanie narzędzia lokalnego.

Argumenty

  • PACKAGE_NAME

    Nazwa/identyfikator pakietu NuGet zawierającego narzędzie .NET do zainstalowania.

Opcje

  • --allow-downgrade

    Zezwalaj na obniżenie poziomu pakietu podczas instalowania lub aktualizowania pakietu narzędzi .NET. Pomija ostrzeżenie "Żądana wersja x.x.x jest niższa niż istniejąca wersja x.x.x".

  • -a|--arch <ARCHITECTURE>

    Określa architekturę docelową. Jest to skrócona składnia ustawiania identyfikatora środowiska uruchomieniowego (RID), gdzie podana wartość jest połączona z domyślnym identyfikatorem RID. Na przykład na maszynie win-x64 określenie --arch x86 ustawia identyfikator RID na win-x86wartość .

  • --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 sekwencyjnie w określonej kolejności pierwszeństwa. Jeśli ten sam pakiet i wersja są w wielu kanałach informacyjnych, najszybsze źródło danych wygrywa. Aby uzyskać więcej informacji, zobacz Co się stanie po zainstalowaniu pakietu NuGet?.

  • --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.

  • --create-manifest-if-needed

    Dotyczy narzędzi lokalnych. Dostępne od zestawu .NET 8 SDK. Aby znaleźć manifest, algorytm wyszukiwania wyszukuje drzewo katalogów dotnet-tools.json lub .config folder zawierający dotnet-tools.json plik.

    Jeśli nie można odnaleźć manifestu narzędzia i --create-manifest-if-needed opcja jest ustawiona na wartość false, CannotFindAManifestFile wystąpi błąd.

    Jeśli nie można odnaleźć manifestu narzędzia i --create-manifest-if-needed opcja ma wartość true, narzędzie automatycznie tworzy manifest. Wybiera folder manifestu w następujący sposób:

    • Przejdź do drzewa katalogów wyszukując katalog, który ma .git podfolder. Jeśli jeden z nich zostanie znaleziony, utwórz manifest w tym katalogu.
    • Jeśli poprzedni krok nie znajdzie katalogu, przejdź do drzewa katalogów wyszukując katalog zawierający .sln katalog lub .git . Jeśli jeden z nich zostanie znaleziony, utwórz manifest w tym katalogu.
    • Jeśli żaden z poprzednich dwóch kroków nie znajdzie katalogu, utwórz manifest w bieżącym katalogu roboczym.

    Aby uzyskać więcej informacji na temat lokalizacji manifestów, zobacz Instalowanie narzędzia lokalnego.

  • --disable-parallel

    Zapobiegaj przywracaniu wielu projektów równolegle.

  • --framework <FRAMEWORK>

    Określa platformę docelową do zainstalowania narzędzia. Domyślnie zestaw .NET SDK próbuje wybrać najbardziej odpowiednią platformę docelową.

  • -g|--global

    Określa, że instalacja jest dla całego użytkownika. Nie można połączyć z opcją --tool-path . Pomijanie zarówno --global , jak i --tool-path określa instalację narzędzia lokalnego.

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

  • --ignore-failed-sources

    Traktuj 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.

  • --local

    Zaktualizuj narzędzie i lokalny manifest narzędzia. Nie można połączyć z opcją --global lub opcją --tool-path .

  • --no-cache

    Nie buforuj pakietów i żądań HTTP.

  • --prerelease

    Uwzględnij pakiety wersji wstępnej.

  • --tool-manifest <PATH>

    Ścieżka do pliku manifestu.

  • --tool-path <PATH>

    Określa lokalizację instalacji narzędzia globalnego. ŚCIEŻKA może być bezwzględna lub względna. Jeśli ścieżka nie istnieje, polecenie próbuje go utworzyć. Pomijanie zarówno --global , jak i --tool-path określa instalację narzędzia lokalnego.

  • -v|--verbosity <LEVEL>

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

  • --version <VERSION_NUMBER>

    Wersja narzędzia do zainstalowania. Domyślnie jest zainstalowana najnowsza stabilna wersja pakietu. Użyj tej opcji, aby zainstalować wersję zapoznawcza lub starsze wersje narzędzia.

    Począwszy od platformy .NET 8.0, --version Major.Minor.Patch odnosi się do określonej wersji głównej/pomocniczej/poprawkowej, w tym wersji nieznajdowanych na liście. Aby zamiast tego uzyskać najnowszą wersję wersji głównej/pomocniczej, użyj polecenia --version Major.Minor.*.

Przykłady

  • dotnet tool install -g dotnetsay

    Instaluje narzędzie dotnetsay jako narzędzie globalne w lokalizacji domyślnej.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Instaluje narzędzie dotnetsay jako narzędzie globalne w określonym katalogu systemu Windows.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Instaluje narzędzie dotnetsay jako narzędzie globalne w określonym katalogu systemu Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instaluje wersję 2.0.0 dotnetsay jako narzędzie globalne.

  • dotnet tool install dotnetsay

    Instaluje narzędzie dotnetsay jako narzędzie lokalne dla bieżącego katalogu.

  • dotnet tool install -g --verbosity minimal

    Instaluje narzędzie dotnetsay jako narzędzie globalne z szczegółowością minimalnej. Domyślna szczegółowość narzędzia globalnego jest cicha.

Zobacz też