Bagikan melalui


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

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

Menggunakan alat ini sebagai alat global

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

  2. Panggil alat:

    botsay hello from the bot
    

    Catatan

    Jika perintah ini gagal, Anda mungkin perlu membuka terminal baru untuk menyegarkan PATH.

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

  1. 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.
    
  2. Panggil alat:

    Di Windows:

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

    Di Linux atau macOS:

    ~/bin/botsay hello from the bot
    
  3. 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.