Tutorial: Instalar e utilizar uma ferramenta global .NET com a CLI do .NET

Artigo
07/27/2023

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

Este tutorial ensina-o a instalar e utilizar uma ferramenta global. Utiliza uma ferramenta que cria no primeiro tutorial desta série.

Pré-requisitos

Conclua o primeiro tutorial desta série.

Utilizar a ferramenta como uma ferramenta global

Instale a ferramenta a partir do pacote ao executar o comando de instalação da ferramenta dotnet na pasta do projeto microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
O --global parâmetro indica à CLI de .NET para instalar os binários de ferramentas numa localização predefinida que é adicionada automaticamente à variável de ambiente PATH.

O --add-source parâmetro indica à CLI de .NET para utilizar temporariamente o diretório ./nupkg como um feed de origem adicional para pacotes NuGet. Deu um nome exclusivo ao seu pacote para se certificar de que este só será encontrado no diretório ./nupkg e não no site Nuget.org.

O resultado mostra o comando utilizado para chamar a ferramenta e a versão instalada:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Nota

Por predefinição, a arquitetura dos binários .NET a instalar representa a arquitetura do SO atualmente em execução. Para especificar uma arquitetura de SO diferente, veja a opção de instalação da ferramenta dotnet , --arch.
Invoque a ferramenta:
```
botsay hello from the bot
```
Nota

Se este comando falhar, poderá ter de abrir um novo terminal para atualizar o PATH.
Remova a ferramenta ao executar o comando de desinstalação da ferramenta dotnet :
```
dotnet tool uninstall -g microsoft.botsay
```

Utilizar a ferramenta como uma ferramenta global instalada numa localização personalizada

Instale a ferramenta a partir do pacote.

No Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
No Linux ou macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
O --tool-path parâmetro indica à CLI de .NET para instalar os binários de ferramentas na localização especificada. Se o diretório não existir, será criado. Este diretório não é adicionado automaticamente à variável de ambiente PATH.

O resultado mostra o comando utilizado para chamar a ferramenta e a versão instalada:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Invoque a ferramenta:

No Windows:

c:\dotnet-tools\botsay hello from the bot

No Linux ou macOS:

~/bin/botsay hello from the bot

Remova a ferramenta ao executar o comando de desinstalação da ferramenta dotnet :

No Windows:

dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay

No Linux ou macOS:

dotnet tool uninstall --tool-path ~/bin microsoft.botsay

Resolução de problemas

Se receber uma mensagem de erro ao seguir o tutorial, veja Resolver problemas de utilização da ferramenta .NET.

Passos seguintes

Neste tutorial, instalou e utilizou uma ferramenta como uma ferramenta global. Para obter mais informações sobre como instalar e utilizar ferramentas globais, veja Gerir ferramentas globais. Para instalar e utilizar a mesma ferramenta que uma ferramenta local, avance para o próximo tutorial.

Instalar e utilizar ferramentas locais

Partilhar via