installation av dotnet-verktyget

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Name

dotnet tool install – Installerar det angivna .NET-verktyget på datorn.

Sammanfattning

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

beskrivning

Kommandot dotnet tool install ger dig ett sätt att installera .NET-verktyg på datorn. Om du vill använda kommandot anger du något av följande installationsalternativ:

  • Om du vill installera ett globalt verktyg på standardplatsen använder du alternativet --global .
  • Om du vill installera ett globalt verktyg på en anpassad plats använder du alternativet --tool-path .
  • Om du vill installera ett lokalt verktyg utelämnar du --global alternativen och --tool-path .

Installationsplatser

Globala verktyg

Globala verktyg installeras som standard i följande kataloger när du anger -g alternativet eller --global :

OS Sökväg
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Körbara filer genereras i dessa mappar för varje globalt installerat verktyg, även om de faktiska verktygsbinärfilerna är kapslade djupt in i syskonkatalogen .store .

--tool-path Verktyg

Verktyg med explicita verktygssökvägar lagras där du angav parametern --tool-path som ska pekas på. De lagras på samma sätt som globala verktyg: en körbar binärfil med de faktiska binärfilerna i en syskonkatalog .store .

Lokala verktyg

Lokala verktyg lagras i den globala NuGet-katalogen, oavsett vad du har angett att det ska vara. Det finns shim-filer i $HOME/.dotnet/toolResolverCache för varje lokalt verktyg som pekar på var verktygen finns på den platsen.

Referenser till lokala verktyg läggs till i en dotnet-tools.json fil i en .config-katalog under den aktuella katalogen. Om det inte finns någon manifestfil än skapar du den --create-manifest-if-needed med hjälp av alternativet eller genom att köra följande kommando:

dotnet new tool-manifest

Mer information finns i Installera ett lokalt verktyg.

Argument

  • PACKAGE_NAME

    Namn/ID för NuGet-paketet som innehåller .NET-verktyget som ska installeras.

Alternativ

  • --allow-downgrade

    Tillåt nedgradering av paket när du installerar eller uppdaterar ett .NET-verktygspaket. Undertrycker varningen: "Den begärda versionen x.x.x är lägre än den befintliga versionen x.x.x."

  • -a|--arch <ARCHITECTURE>

    Anger målarkitekturen. Det här är en kortsyntax för att ange Körtidsidentifierare (RID) där det angivna värdet kombineras med standard-RID. På en win-x64 dator anger du --arch x86 till exempel RID till win-x86.

  • --add-source <SOURCE>

    Lägger till ytterligare en NuGet-paketkälla som ska användas under installationen. Feeds nås parallellt, inte sekventiellt i någon prioritetsordning. Om samma paket och version finns i flera feeds vinner den snabbaste feeden. Mer information finns i Vad händer när ett NuGet-paket installeras?.

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • --create-manifest-if-needed

    Gäller för lokala verktyg. Tillgänglig från och med .NET 8 SDK. För att hitta ett manifest söker sökalgoritmen upp katalogträdet efter dotnet-tools.json eller en .config mapp som innehåller en dotnet-tools.json fil.

    Om det inte går att hitta ett verktygsmanifest och --create-manifest-if-needed alternativet är inställt på false uppstår CannotFindAManifestFile felet.

    Om det inte går att hitta ett verktygsmanifest och --create-manifest-if-needed alternativet är inställt på sant skapar verktyget ett manifest automatiskt. Den väljer en mapp för manifestet enligt följande:

    • Gå upp i katalogträdet och leta efter en katalog som har en .git undermapp. Om en hittas skapar du manifestet i den katalogen.
    • Om föregående steg inte hittar någon katalog går du upp i katalogträdet och söker efter en katalog som har en .sln eller .git en fil. Om en hittas skapar du manifestet i den katalogen.
    • Om inget av de föregående två stegen hittar en katalog skapar du manifestet i den aktuella arbetskatalogen.

    Mer information om hur manifest finns finns i Installera ett lokalt verktyg.

  • --disable-parallel

    Förhindra att flera projekt återställs parallellt.

  • --framework <FRAMEWORK>

    Anger det målramverk som verktyget ska installeras för. Som standard försöker .NET SDK välja det lämpligaste målramverket.

  • -g|--global

    Anger att installationen är användaromfattande. Det går inte att kombinera med alternativet --tool-path . Om du utelämnar båda --global och --tool-path anger en lokal verktygsinstallation.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --ignore-failed-sources

    Behandla paketkällans fel som varningar.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen.

  • --local

    Uppdatera verktyget och det lokala verktygsmanifestet. Det går inte att kombinera med --global alternativet eller alternativet --tool-path .

  • --no-cache

    Cachelagrade inte paket och HTTP-begäranden.

  • --prerelease

    Inkludera förhandsversionspaket.

  • --tool-manifest <PATH>

    Sökväg till manifestfilen.

  • --tool-path <PATH>

    Anger var det globala verktyget ska installeras. PATH kan vara absolut eller relativ. Om PATH inte finns försöker kommandot skapa den. Om du utelämnar båda --global och --tool-path anger en lokal verktygsinstallation.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Mer information finns i LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Den version av verktyget som ska installeras. Som standard installeras den senaste stabila paketversionen. Använd det här alternativet om du vill installera förhandsversioner eller äldre versioner av verktyget.

    Från och med .NET 8.0 --version Major.Minor.Patch refererar till en specifik huvudversion/delversion/korrigeringsversion, inklusive olistade versioner. Om du vill hämta den senaste versionen av en viss huvudversion/delversion i stället använder du --version Major.Minor.*.

Exempel

  • dotnet tool install -g dotnetsay

    Installerar dotnetsay som ett globalt verktyg på standardplatsen.

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

    Installerar dotnetsay som ett globalt verktyg i en specifik Windows-katalog.

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

    Installerar dotnetsay som ett globalt verktyg i en specifik Linux/macOS-katalog.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installerar version 2.0.0 av dotnetsay som ett globalt verktyg.

  • dotnet tool install dotnetsay

    Installerar dotnetsay som ett lokalt verktyg för den aktuella katalogen.

  • dotnet tool install -g --verbosity minimal

    Installerar dotnetsay som ett globalt verktyg med minsta detaljnivå. Standardverositeten för det globala verktyget är tyst.

Se även