dotnet tool install
Artikel ini berlaku untuk: ✔️ .NET Core 3.1 SDK dan versi yang lebih baru
Nama
dotnet tool install
- Menginstal alat .NET yang ditentukan pada komputer Anda.
Sinopsis
dotnet tool install <PACKAGE_NAME> -g|--global
[--allow-downgrade] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
[--version <VERSION_NUMBER>]
dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
[--allow-downgrade] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
[--version <VERSION_NUMBER>]
dotnet tool install <PACKAGE_NAME> [--local]
[--allow-downgrade] [-a|--arch <ARCHITECTURE>]
[--add-source <SOURCE>] [--configfile <FILE>]
[--create-manifest-if-needed] [--disable-parallel]
[--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
[--version <VERSION_NUMBER>]
dotnet tool install -h|--help
Deskripsi
Perintah ini dotnet tool install
menyediakan cara bagi Anda untuk menginstal alat .NET di komputer Anda. Untuk menggunakan perintah , Anda menentukan salah satu opsi penginstalan berikut:
- Untuk menginstal alat global di lokasi default, gunakan
--global
opsi . - Untuk menginstal alat global di lokasi kustom, gunakan
--tool-path
opsi . - Untuk menginstal alat lokal, hilangkan
--global
opsi dan--tool-path
.
Lokasi penginstalan
Alat global
Alat global diinstal di direktori berikut secara default saat Anda menentukan -g
opsi atau --global
:
OS | Jalur |
---|---|
Linux/macOS | $HOME/.dotnet/tools |
Windows | %USERPROFILE%\.dotnet\tools |
Executable dihasilkan dalam folder ini untuk setiap alat yang diinstal secara global, meskipun biner alat aktual bersarang jauh ke dalam direktori saudara .store
.
Catatan
Di Linux setelah menginstal alat baris perintah dengan dotnet tool
, alat hanya dapat dijalankan dari $HOME/.dotnet/tools
jalur.
Untuk membuat alat dapat dieksekusi dari direktori apa pun, perbarui PATH
variabel lingkungan.
Untuk membuat variabel lingkungan yang diperbarui PATH
menjadi permanen di shell Anda, perbarui pengaturan shell Anda.
Untuk Bash
, ini adalah $HOME/.bashrc
file.
Alat --tool-path
Alat dengan jalur alat eksplisit disimpan di mana pun Anda menentukan --tool-path
parameter yang akan dituju. Biner yang dapat dieksekusi disimpan dengan cara yang sama seperti alat global: biner yang dapat dieksekusi dengan biner aktual dalam direktori saudara .store
.
Alat lokal
Alat lokal disimpan di direktori global NuGet, apa pun yang telah Anda tetapkan. Ada file shim di $HOME/.dotnet/toolResolverCache
untuk setiap alat lokal yang menunjuk ke tempat alat berada di lokasi tersebut.
Referensi ke alat lokal ditambahkan ke file dotnet-tools.json dalam direktori .config di bawah direktori saat ini. Jika file manifes belum ada, buat dengan menggunakan --create-manifest-if-needed
opsi atau dengan menjalankan perintah berikut:
dotnet new tool-manifest
Untuk informasi selengkapnya, lihat Menginstal alat lokal.
Argumen
PACKAGE_NAME
Nama/ID paket NuGet yang berisi alat .NET untuk diinstal.
Opsi
--allow-downgrade
Izinkan paket diturunkan tingkatnya saat menginstal atau memperbarui paket alat .NET. Menekan peringatan, "Versi x.x.x yang diminta lebih rendah dari versi x.x.x yang ada."
-a|--arch <ARCHITECTURE>
Menentukan arsitektur target. Hal ini adalah sintaks singkat untuk mengatur Pengidentifikasi Runtime (RID), di mana nilai yang disediakan digabung dengan RID default. Misalnya, pada komputer
win-x64
, menentukan--arch x86
akan mengatur RID kewin-x86
.
--add-source <SOURCE>
Menambahkan sumber paket NuGet tambahan untuk digunakan selama penginstalan. Umpan diakses secara paralel, tidak secara berurutan dalam beberapa urutan prioritas. Jika paket dan versi yang sama berada di beberapa umpan, umpan tercepat akan menang. Untuk informasi selengkapnya, lihat Apa yang terjadi saat paket NuGet diinstal?.
--configfile <FILE>
File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.
--create-manifest-if-needed
Berlaku untuk alat lokal. Tersedia dimulai dengan .NET 8 SDK. Untuk menemukan manifes, algoritma pencarian mencari pohon direktori untuk
dotnet-tools.json
atau.config
folder yang berisidotnet-tools.json
file.Jika manifes alat tidak dapat ditemukan dan
--create-manifest-if-needed
opsi diatur ke false,CannotFindAManifestFile
kesalahan terjadi.Jika manifes alat tidak dapat ditemukan dan
--create-manifest-if-needed
opsi diatur ke true, alat akan membuat manifes secara otomatis. Ini memilih folder untuk manifes sebagai berikut:- Berjalan ke pohon direktori yang mencari direktori yang memiliki
.git
subfolder. Jika ditemukan, buat manifes di direktori tersebut. - Jika langkah sebelumnya tidak menemukan direktori, lihat pohon direktori yang mencari direktori yang memiliki
.sln
file atau.git
. Jika ditemukan, buat manifes di direktori tersebut. - Jika tidak satu pun dari dua langkah sebelumnya menemukan direktori, buat manifes di direktori kerja saat ini.
Untuk informasi selengkapnya tentang bagaimana manifes berada, lihat Menginstal alat lokal.
- Berjalan ke pohon direktori yang mencari direktori yang memiliki
--disable-parallel
Mencegah pemulihan beberapa proyek secara paralel.
--framework <FRAMEWORK>
Menentukan kerangka kerja target untuk menginstal alat. Secara default, .NET SDK mencoba memilih kerangka kerja target yang paling tepat.
-g|--global
Menentukan bahwa penginstalan berlebaran dengan pengguna. Tidak dapat digabungkan
--tool-path
dengan opsi . Menghilangkan dan--global
--tool-path
menentukan penginstalan alat lokal.
-?|-h|--help
Mencetak deskripsi cara menggunakan perintah.
--ignore-failed-sources
Perlakukan kegagalan sumber paket sebagai peringatan.
--interactive
Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi.
--local
Perbarui alat dan manifes alat lokal. Tidak dapat digabungkan
--global
dengan opsi atau--tool-path
opsi .--no-cache
Jangan cache paket dan permintaan HTTP.
--prerelease
Sertakan paket prarilis.
--tool-manifest <PATH>
Jalur ke file manifes.
--tool-path <PATH>
Menentukan lokasi tempat menginstal Alat Global. PATH bisa absolut atau relatif. Jika PATH tidak ada, perintah mencoba membuatnya. Menghilangkan dan
--global
--tool-path
menentukan penginstalan alat lokal.
-v|--verbosity <LEVEL>
Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah
q[uiet]
,m[inimal]
,n[ormal]
,d[etailed]
, dandiag[nostic]
. Untuk informasi selengkapnya, lihat LoggerVerbosity .
--version <VERSION_NUMBER>
Versi alat yang akan diinstal. Secara default, versi paket stabil terbaru diinstal. Gunakan opsi ini untuk menginstal pratinjau atau versi alat yang lebih lama.
Dimulai dengan .NET 8.0,
--version Major.Minor.Patch
mengacu pada versi mayor/minor/patch tertentu, termasuk versi yang tidak tercantum. Untuk mendapatkan versi terbaru dari versi utama/minor tertentu, gunakan--version Major.Minor.*
.
Contoh
dotnet tool install -g dotnetsay
Menginstal dotnetsay sebagai alat global di lokasi default.
dotnet tool install dotnetsay --tool-path c:\global-tools
Menginstal dotnetsay sebagai alat global di direktori Windows tertentu.
dotnet tool install dotnetsay --tool-path ~/bin
Menginstal dotnetsay sebagai alat global di direktori Linux/macOS tertentu.
dotnet tool install -g dotnetsay --version 2.0.0
Menginstal dotnetsay versi 2.0.0 sebagai alat global.
dotnet tool install dotnetsay
Menginstal dotnetsay sebagai alat lokal untuk direktori saat ini.
dotnet tool install -g --verbosity minimal
Menginstal dotnetsay sebagai alat global dengan verbositas minimal. Verbositas default untuk alat global diam.