dotnet tool install

  • Artigo

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

Nome

dotnet tool install – Instala a ferramenta .NET especificada no computador.

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

Descrição

O comando dotnet tool install fornece uma maneira de instalar no computador as ferramentas .NET. Para usar o comando, especifique uma das seguintes opções de instalação:

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

Locais de instalação

Ferramentas globais

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

Sistema operacional 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 de ferramentas reais sejam aninhados profundamente no diretório .store irmão.

Ferramentas --tool-path

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

Ferramentas locais

As ferramentas locais são armazenadas no diretório global do NuGet, conforme você o tenha definido. Há arquivos shim em $HOME/.dotnet/toolResolverCache de cada ferramenta local que apontam para onde as ferramentas estão nesse local.

As referências às 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 opção --create-manifest-if-needed ou executando o seguinte comando:

dotnet new tool-manifest

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

Argumentos

  • PACKAGE_NAME

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

Opções

  • --allow-downgrade

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

  • -a|--arch <ARCHITECTURE>

    Especifica a arquitetura de destino. Essa é uma sintaxe abreviada para definir o RID (Identificador de Runtime), em que o valor fornecido é combinado com o RID padrão. Por exemplo, em um computador win-x64, a especificação de --arch x86 define o RID como win-x86.

  • --add-source <SOURCE>

    Adiciona outra origem do pacote NuGet a ser usada durante a instalação. Os feeds são acessados em paralelo, não sequencialmente em uma ordem de precedência. Se o mesmo pacote e a mesma versão estiverem em vários feeds, o feed mais rápido vencerá. Para obter mais informações, confira O que acontece quando um pacote NuGet é instalado?.

  • --configfile <FILE>

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

  • --create-manifest-if-needed

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

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

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

    • Percorra a árvore de diretórios procurando um diretório que tenha uma subpasta .git. Encontrado o diretório, crie o manifesto nele.
    • Se a etapa anterior não encontrar um diretório, suba a árvore de diretórios procurando um diretório que tenha um .sln arquivo ou .git . Encontrado o diretório, crie o manifesto nele.
    • Se você não encontrar o diretório em nenhuma das duas etapas anteriores, crie o manifesto no diretório de trabalho atual.

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

  • --disable-parallel

    Impedir 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 é de todos os usuários. Não pode ser combinada com a opção --tool-path. Omitir --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

    Tratar as falhas de origem de pacote como avisos.

  • --interactive

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

  • --local

    Atualizar a ferramenta e o manifesto de ferramenta local. Essa opção não pode ser combinada com a opção --global ou --tool-path.

  • --no-cache

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

  • --prerelease

    Incluir pacotes de pré-lançamento.

  • --tool-manifest <PATH>

    Caminho para o arquivo de manifesto.

  • --tool-path <PATH>

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

  • -v|--verbosity <LEVEL>

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

  • --version <VERSION_NUMBER>

    A versão da ferramenta a ser instalada. Por padrão, a última versão estável do pacote é instalada. Use essa opção para instalar a versão prévia ou versões mais antigas da ferramenta.

    A partir do .NET 8.0, --version Major.Minor.Patch refere-se a uma versão específica de patch/maior/menor, incluindo versões não listadas. Para obter a versão mais recente de uma determinada versão maior/menor, 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 do Windows.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instala a versão 2.0.0 de 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 o dotnetsay como uma ferramenta global com o mínimo de detalhamento. O detalhamento padrão da ferramenta global é silenciosa.

Confira também