Compartilhar via

dotnet tool exec

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

Nome

dotnet tool exec - Baixa e invoca uma ferramenta .NET sem instalá-la permanentemente.

Sinopse

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

O dotnet tool exec comando fornece um modo de invocação de ferramenta de captura única para ferramentas .NET. Ele baixa automaticamente o pacote de ferramentas especificado para o cache do NuGet e o invoca sem modificar o sistema PATH ou exigir a instalação permanente.

Ao executar dotnet tool exec, o comando:

  1. Verifica a versão (ou intervalo de versões) que você especifica (ou a versão mais recente, se nenhuma for especificada) nos feeds do NuGet configurados para decidir qual pacote será baixado.
  2. Baixa o pacote especificado para o cache NuGet (se ainda não estiver presente).
  3. Invoca a ferramenta com argumentos fornecidos.
  4. Retorna o código de saída da ferramenta.

dotnet tool exec funciona perfeitamente com ferramentas globais e locais. Se você tiver um manifesto de ferramenta local disponível, ele usará o manifesto para determinar qual versão da ferramenta será executada.

Esse comando também existe em duas outras formas para facilitar o uso

  • dotnet dnx - Um alias oculto para dotnet tool exec isso é usado como uma maneira de implementar facilmente o dnx próprio script
  • dnx - Um script de shell que invoca dotnet dnx do SDK. Esse script é fornecido pelo instalador e está disponível em PATH. Ele permite o uso muito simples de ferramentas diretamente por meio dnx <toolname>de .

Arguments

  • PACKAGE_NAME

    A ID do pacote NuGet da ferramenta .NET a ser executada. Opcionalmente, você pode especificar uma versão usando a @ sintaxe, por exemplo dotnetsay@2.1.0.

  • tool-arguments

    Argumentos a serem passados para a ferramenta que está sendo executada. Tudo depois -- é passado diretamente para a ferramenta.

Opções

  • --allow-roll-forward

    Permita que a ferramenta use uma versão mais recente do runtime do .NET se o runtime de destino não estiver instalado.

  • --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 em uma sequência em cascata de fallback. Se o mesmo pacote e versão estiverem disponíveis em vários feeds, o feed mais rápido ganhará. Para obter mais informações, consulte O que acontece quando um pacote NuGet é instalado. Você pode controlar isso por meio do uso do mapeamento de origem do pacote NuGet. Para obter mais informações, consulte Mapeamento de Origem do Pacote.

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

  • --disable-parallel

    Previne a restauração de vários projetos paralelamente.

  • --ignore-failed-sources

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

  • --no-http-cache

    Não armazena em cache solicitações HTTP para os feeds do NuGet configurados.

  • --prerelease

    Permite que os pacotes de pré-lançamento sejam selecionados ao resolver a versão a ser instalada.

  • --source <SOURCE>

    Especifica a origem dos pacotes NuGet.

  • -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]. O padrão é normal. Para obter mais informações, consulte LoggerVerbosity.

  • -?|-h|--help

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

Exemplos

  • dotnet tool exec dotnetsay

    Baixa (se necessário) e executa a versão mais recente da dotnetsay ferramenta.

  • dotnet tool exec dotnetsay@2.1.0

    Baixa (se necessário) e executa a versão 2.1.0 da dotnetsay ferramenta.

  • dotnet tool exec dotnetsay@2.*

    Baixa (se necessário) e executa a versão mais recente da dotnetsay ferramenta no intervalo de versão 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    Executa a dotnetsay ferramenta e passa "Olá, Mundo" como argumentos para a ferramenta.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Baixa e executa mytool usando a origem do NuGet especificada.

Comparação com outros comandos

Esse comando destina-se a ser uma maneira unificada de trabalhar com as Ferramentas do .NET. Embora os comandos de instalação de ferramentas disponíveis anteriormente permaneçam disponíveis, dotnet tool exec fornece uma experiência mais simples e flexível para a maioria dos usuários.

Command Propósito Installation Scope
dotnet tool exec Execução de um tiro Nenhum (somente em cache) Temporary
dotnet tool install -g Instalação global permanente Global Todo o sistema
dotnet tool install Instalação local permanente Manifesto local Projeto
dotnet tool run Executar uma ferramenta local já instalada Requer instalação anterior Projeto

O dotnet tool install -g comando ainda serve a uma finalidade importante para os usuários que desejam instalar permanentemente uma ferramenta. No entanto, para os usuários que desejam experimentar uma ferramenta ou executá-la em um pipeline de CI/CD, dotnet tool exec geralmente é uma melhor opção.

Consulte também

  • Last updated on