instalação da ferramenta dotnet

Este artigo aplica-se a: ✔️ SDK do .NET Core 3.1 e versões posteriores

Nome

dotnet tool install- Instala a ferramenta .NET especificada em sua máquina.

Sinopse

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

Description

O dotnet tool install comando fornece uma maneira de instalar ferramentas .NET em sua máquina. Para usar o comando, especifique uma das seguintes opções de instalação:

  • Para instalar uma ferramenta global no local padrão, use a --global opção.
  • Para instalar uma ferramenta global em um local personalizado, use a --tool-path opção.
  • Para instalar uma ferramenta local, omita as --global opções e --tool-path .

Localizações de instalação

Ferramentas globais

As ferramentas globais são instaladas nos seguintes diretórios por padrão quando você especifica a -g opção ou --global :

SO Caminho
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Os executáveis são gerados nessas pastas para cada ferramenta instalada globalmente, embora os binários reais da ferramenta sejam aninhados profundamente no diretório irmão .store .

--tool-path Ferramentas

As ferramentas com caminhos de ferramentas explícitos são armazenadas onde quer que você tenha especificado o --tool-path parâmetro para o qual apontar. Eles são armazenados da mesma forma que as ferramentas globais: um binário executável com os binários reais em um diretório irmão .store .

Ferramentas locais

As ferramentas locais são armazenadas no diretório global do NuGet, seja qual for o conjunto definido. Há arquivos shim para $HOME/.dotnet/toolResolverCache cada ferramenta local que apontam para onde as ferramentas estão dentro desse local.

As referências a ferramentas locais são adicionadas a um arquivo dotnet-tools.json em um diretório .config no diretório atual. Se um arquivo de manifesto ainda não existir, crie-o usando a --create-manifest-if-needed opção ou executando o seguinte comando:

dotnet new tool-manifest

Para obter mais informações, consulte Instalar uma ferramenta local.

Argumentos

  • PACKAGE_NAME

    Nome/ID do pacote NuGet que contém a ferramenta .NET a ser instalada.

Opções

  • --allow-downgrade

    Permitir o downgrade do pacote ao instalar ou atualizar um pacote de ferramentas .NET. Suprime o aviso: "A versão solicitada x.x.x é inferior à versão existente x.x.x."

  • -a|--arch <ARCHITECTURE>

    Especifica a arquitetura de destino. Esta é uma sintaxe abreviada para definir o Runtime Identifier (RID), onde o valor fornecido é combinado com o RID padrão. Por exemplo, em uma win-x64 máquina, especificar --arch x86 define o RID como win-x86.

  • --add-source <SOURCE>

    Adiciona uma fonte de pacote NuGet adicional para usar durante a instalação. Os feeds são acessados em paralelo, não sequencialmente em alguma ordem de precedência. Se o mesmo pacote e versão estiverem em vários feeds, o feed mais rápido vence. Para obter mais informações, consulte O que acontece quando um pacote NuGet é instalado?.

  • --configfile <FILE>

    O arquivo de configuração do NuGet (nuget.config) a ser usado. Se especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.

  • --create-manifest-if-needed

    Aplica-se a ferramentas locais. Disponível a partir do SDK do .NET 8. Para encontrar um manifesto, o algoritmo de pesquisa pesquisa a árvore dotnet-tools.json de diretórios ou uma .config pasta que contenha um dotnet-tools.json arquivo.

    Se um manifesto de ferramenta não puder ser encontrado e a --create-manifest-if-needed opção estiver definida como false, o CannotFindAManifestFile erro ocorrerá.

    Se um manifesto de ferramenta não puder ser encontrado e a --create-manifest-if-needed opção estiver definida como true, a ferramenta criará um manifesto automaticamente. Ele escolhe uma pasta para o manifesto da seguinte maneira:

    • Suba a árvore de diretórios procurando por um diretório que tenha uma .git subpasta. Se for encontrado, crie o manifesto nesse diretório.
    • Se a etapa anterior não encontrar um diretório, suba a árvore de diretórios procurando por um diretório que tenha um .sln arquivo OR .git . Se for encontrado, crie o manifesto nesse diretório.
    • Se nenhuma das duas etapas anteriores encontrar um diretório, crie o manifesto no diretório de trabalho atual.

    Para obter mais informações sobre como os manifestos estão localizados, consulte Instalar uma ferramenta local.

  • --disable-parallel

    Impeça a restauração de vários projetos em paralelo.

  • --framework <FRAMEWORK>

    Especifica a estrutura de destino para a qual instalar a ferramenta. Por padrão, o SDK do .NET tenta escolher a estrutura de destino mais apropriada.

  • -g|--global

    Especifica que a instalação é para todo o usuário. Não pode ser combinado com a --tool-path opção. Omitindo ambos --global e --tool-path especifica uma instalação de ferramenta local.

  • -?|-h|--help

    Imprime uma descrição de como usar o comando.

  • --ignore-failed-sources

    Trate as falhas de origem do pacote como avisos.

  • --interactive

    Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

  • --local

    Atualize a ferramenta e o manifesto da ferramenta local. Não pode ser combinado com a --global opção ou a --tool-path opção.

  • --no-cache

    Não armazene em cache pacotes e solicitações HTTP.

  • --prerelease

    Inclua pacotes de pré-lançamento.

  • --tool-manifest <PATH>

    Caminho para o arquivo de manifesto.

  • --tool-path <PATH>

    Especifica o local onde instalar a Ferramenta Global. PATH pode ser absoluto ou relativo. Se PATH não existir, o comando tentará criá-lo. Omitindo ambos --global e --tool-path especifica uma instalação de ferramenta local.

  • -v|--verbosity <LEVEL>

    Define o nível de detalhamento do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic]. Para obter mais informações, veja LoggerVerbosity.

  • --version <VERSION_NUMBER>

    A versão da ferramenta a ser instalada. Por padrão, a versão mais recente do pacote estável é instalada. Utilize esta opção para instalar a pré-visualização ou versões mais antigas da ferramenta.

    A partir do .NET 8.0, --version Major.Minor.Patch refere-se a uma versão principal/secundária/patch específica, incluindo versões não listadas. Para obter a versão mais recente de uma determinada versão principal/secundária, use --version Major.Minor.*.

Exemplos

  • dotnet tool install -g dotnetsay

    Instala dotnetsay como uma ferramenta global no local padrão.

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

    Instala dotnetsay como uma ferramenta global em um diretório específico do Windows.

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

    Instala dotnetsay como uma ferramenta global em um diretório Linux/macOS específico.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instala a versão 2.0.0 do dotnetsay como uma ferramenta global.

  • dotnet tool install dotnetsay

    Instala dotnetsay como uma ferramenta local para o diretório atual.

  • dotnet tool install -g --verbosity minimal

    Instala dotnetsay como uma ferramenta global com a verborragia do mínimo. A verbosidade padrão para a ferramenta global é silenciosa.

Consulte também