Tutorial: Instalar e usar uma ferramenta global do .NET usando a CLI do .NET

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

Este tutorial mostra-te como instalar e usar uma ferramenta global. A ferramenta que usas é a que crias no primeiro tutorial desta série.

Pré-requisitos

• Complete o primeiro tutorial desta série.
• SDK do .NET 10.0.100 ou posterior (para dnx) - opcional, mas recomendado.

Execute a ferramenta sem instalação (recomendado)

A partir do .NET 10.0.100, você pode executar ferramentas .NET sem instalação permanente usando dnx:

1. Execute a ferramenta diretamente usando dnx (sintaxe simplificada):

   dnx dotnet-env --add-source ./nupkg
   

   O parâmetro --add-source diz à CLI .NET para usar o diretório ./nupkg como fonte adicional para pacotes NuGet quando a ferramenta não está disponível no NuGet.org.

Use a ferramenta como uma ferramenta global (instalação tradicional)

Se preferir a instalação permanente para uso frequente:

1. Instale a ferramenta a partir do pacote executando o comando de instalação da ferramenta dotnet na pasta do projeto dotnet-env :

   dotnet tool install --global --add-source ./nupkg dotnet-env
   

   O parâmetro --global diz à CLI .NET para instalar os binários da ferramenta numa localização predefinida que é automaticamente adicionada à variável de ambiente PATH.

   O --add-source parâmetro informa à CLI do .NET que utilize temporariamente o diretório ./nupkg como um feed de origem adicional para pacotes NuGet. Deste ao teu pacote um nome único para garantir que só aparece no diretório ./nupkg , não no NuGet.org.

   A saída mostra o comando usado para chamar a ferramenta e a versão instalada:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

   Observação

   Por padrão, a arquitetura dos binários do .NET a serem instalados representa a arquitetura do sistema operacional em execução no momento. Para especificar uma arquitetura de sistema operativo diferente, consulte dotnet tool install, opção --arch.

2. Invoque a ferramenta:

   dotnet-env
   

   Observação

   Se o comando falhar, abra um novo terminal para atualizar a PATH variável de ambiente.

3. Remova a ferramenta executando o comando dotnet tool uninstall (desinstalação da ferramenta dotnet ):

   dotnet tool uninstall -g dotnet-env
   

Use a ferramenta como uma ferramenta global instalada em um local personalizado

1. Instale a ferramenta a partir do pacote.

   No Windows:

   dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env
   

   No Linux ou macOS:

   dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env
   

   O --tool-path parâmetro indica à CLI do .NET instalar os binários da ferramenta no local especificado. Se o diretório não existir, é criado. O diretório não é automaticamente adicionado à PATH variável de ambiente.

   A saída mostra o comando usado para chamar a ferramenta e a versão instalada:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Invoque a ferramenta:

   No Windows:

   c:\dotnet-tools\dotnet-env
   

   No Linux ou macOS:

   ~/bin/dotnet-env
   

3. Remova a ferramenta executando o comando dotnet tool uninstall (desinstalação da ferramenta dotnet ):

   No Windows:

   dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
   

   No Linux ou macOS:

   dotnet tool uninstall --tool-path ~/bin dotnet-env
   

Troubleshoot

Se você receber uma mensagem de erro ao seguir o tutorial, consulte Solucionar problemas de uso da ferramenta .NET.

Próximos passos

Neste tutorial, você instalou e usou uma ferramenta como uma ferramenta global. Para mais informações sobre a instalação e utilização de ferramentas globais, consulte Gestão de ferramentas globais. Para instalar e usar a mesma ferramenta que uma ferramenta local, avance para o próximo tutorial.