instalação da ferramenta dotnet

Este artigo aplica-se a: ✔️ .NET 6 SDK 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] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

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

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

dotnet tool install -h|--help

Descrição

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 .

Advertência

Verifique se o diretório especificado com a --tool-path opção é seguro. As ferramentas instaladas neste local podem ser executadas diretamente, portanto, usar um caminho não confiável ou compartilhado pode introduzir riscos de segurança.

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`
Mac OS	`%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 .

Nota

No Linux, depois de instalar uma ferramenta de linha de comando com dotnet tool, a ferramenta pode ser executada apenas a partir do $HOME/.dotnet/tools caminho. Para tornar a ferramenta executável a partir de qualquer diretório, atualize a PATH variável de ambiente. Para tornar a variável de ambiente atualizada PATH permanente no shell, atualize as configurações do shell. Para Bash, este é o $HOME/.bashrc arquivo.

`--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. A partir do .NET 10, se um arquivo de manifesto ainda não existir, um será criado automaticamente. Você também pode criar um manualmente 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.

A partir do SDK do .NET 10.0.100, use o nome/ID e a versão separados por @ para instalar uma ferramenta .NET.

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."
--allow-roll-forward

Disponível a partir do SDK do .NET 9.0. Permita que a ferramenta use uma versão mais recente do tempo de execução do .NET se o tempo de execução a que se destina não estiver instalado.
-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. Se você usar essa opção, não use a -r|--runtime opção. Disponível desde o .NET 6 Preview 7.
--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

Disponível a partir do SDK do .NET 8.

Aplica-se a ferramentas locais. 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 (ou, no .NET 10 e versões posteriores, quando não especificado), 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.

A partir do .NET 10, um manifesto é criado automaticamente se nenhum manifesto de ferramentas for encontrado. Esta mudança pode ser uma mudança de rutura. Você pode optar por não participar passando --create-manifest-if-needed=false.

Advertência

Não execute comandos de ferramenta a partir da pasta Downloads ou de qualquer local compartilhado. A CLI percorre a árvore de diretórios para encontrar um manifesto de ferramenta, o que pode fazer com que ela use um manifesto que você não espera. Sempre execute comandos de ferramenta a partir de um diretório confiável e específico do projeto.
--disable-parallel

Impede 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.
--source <SOURCE>

Especifica a origem dos pacotes NuGet.
-?|-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 ou --no-http-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 para 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, --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 -g dotnetsay@2.1.7

Instala a versão 2.1.7 do dotnetsay como uma ferramenta global.
dotnet tool install dotnetsay

Instala dotnetsay como uma ferramenta local para o diretório atual.
dotnet tool install dotnetsay@2.1.7

Instala a versão 2.1.7 do dotnetsay como uma ferramenta local para o diretório atual.
dotnet tool install -g dotnetsay --verbosity minimal

Instala dotnetsay como uma ferramenta global com a verborragia do mínimo. A verbosidade padrão para a ferramenta global é silenciosa.
dotnet tool install -g dotnetsay --allow-roll-forward

Instala dotnetsay como uma ferramenta global e permite que ele seja executado em versões mais recentes do .NET se o tempo de execução de destino não estiver disponível.

Consulte também

Feedback

Esta página foi útil?

Last updated on 2025-11-12