Tutorial: Menginstal dan menggunakan alat global .NET menggunakan .NET CLI

Artikel
07/27/2023

Artikel ini berlaku untuk: ✔️ .NET Core 2.1 SDK dan versi yang lebih baru

Tutorial ini mengajarkan Anda cara menginstal dan menggunakan alat global. Anda menggunakan alat yang Anda buat di tutorial pertama dari seri ini.

Prasyarat

Selesaikan tutorial pertama dari seri ini.

Menggunakan alat ini sebagai alat global

Instal alat dari paket dengan menjalankan perintah penginstalan alat dotnet di folder proyek microsoft.botsay :
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Parameter --global memberi tahu .NET CLI untuk menginstal biner alat di lokasi default yang secara otomatis ditambahkan ke variabel lingkungan PATH.

Parameter --add-source memberi tahu .NET CLI untuk sementara menggunakan direktori ./nupkg sebagai umpan sumber tambahan untuk paket NuGet. Anda memberi paket Anda nama unik untuk memastikan bahwa paket hanya akan ditemukan di direktori ./nupkg , bukan di situs Nuget.org.

Output menunjukkan perintah yang digunakan untuk memanggil alat dan versi yang diinstal:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Catatan

Secara default arsitektur biner .NET yang akan diinstal mewakili arsitektur OS yang sedang berjalan. Untuk menentukan arsitektur OS yang berbeda, lihat penginstalan alat dotnet, opsi --arch.
Panggil alat:
```
botsay hello from the bot
```
Catatan

Jika perintah ini gagal, Anda mungkin perlu membuka terminal baru untuk menyegarkan PATH.
Hapus alat dengan menjalankan perintah hapus instalan alat dotnet :
```
dotnet tool uninstall -g microsoft.botsay
```

Gunakan alat sebagai alat global yang diinstal di lokasi kustom

Instal alat dari paket.

Di Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
Di Linux atau macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Parameter --tool-path memberi tahu .NET CLI untuk menginstal biner alat di lokasi yang ditentukan. Jika direktori tidak ada, direktori akan dibuat. Direktori ini tidak secara otomatis ditambahkan ke variabel lingkungan PATH.

Output menunjukkan perintah yang digunakan untuk memanggil alat dan versi yang diinstal:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Panggil alat:

Di Windows:

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

Di Linux atau macOS:

~/bin/botsay hello from the bot

Hapus alat dengan menjalankan perintah hapus instalan alat dotnet :

Di Windows:

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

Di Linux atau macOS:

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

Pecahkan masalah

Jika Anda mendapatkan pesan kesalahan saat mengikuti tutorial, lihat Memecahkan masalah penggunaan alat .NET.

Langkah berikutnya

Dalam tutorial ini, Anda menginstal dan menggunakan alat sebagai alat global. Untuk informasi selengkapnya tentang cara menginstal dan menggunakan alat global, lihat Mengelola alat global. Untuk menginstal dan menggunakan alat yang sama dengan alat lokal, lanjutkan ke tutorial berikutnya.

Menginstal dan menggunakan alat lokal

Bagikan melalui