install alat dotnet

Artikel ini berlaku untuk: ✔️ .NET 6 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] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--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 .

Peringatan

Pastikan direktori yang Anda tentukan dengan --tool-path opsi aman. Alat yang diinstal di lokasi ini dapat dijalankan secara langsung, sehingga menggunakan jalur yang tidak tepercaya atau bersama mungkin menimbulkan risiko keamanan.

Lokasi penginstalan

Alat global

Alat global diinstal di direktori berikut secara default saat Anda menentukan -g opsi atau --global :

Sistem operasi	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. Mulai dari .NET 10, jika file manifes belum ada, file tersebut dibuat secara otomatis. Anda juga dapat membuatnya secara manual 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.

  Mulai dari .NET 10.0.100 SDK, gunakan nama/ID, dan versi yang dipisahkan oleh @ untuk menginstal alat .NET.

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

• --allow-roll-forward

  Tersedia dimulai dengan .NET 9.0 SDK. Izinkan alat untuk menggunakan versi runtime .NET yang lebih baru jika runtime yang ditargetkannya tidak diinstal.

• -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 ke win-x86. Jika Anda menggunakan opsi ini, jangan gunakan opsi -r|--runtime. Tersedia sejak .NET 6 Preview 7.

• --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

  Tersedia mulai dari .NET 8 SDK.

  Berlaku untuk alat lokal. Untuk menemukan manifes, algoritma pencarian mencari pohon direktori untuk dotnet-tools.json atau .config folder yang berisi dotnet-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 (atau, di .NET 10 dan versi yang lebih baru, ketika tidak ditentukan), 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.

  Mulai dari .NET 10, manifes dibuat secara otomatis jika tidak ada manifes alat yang ditemukan. Perubahan ini bisa menjadi perubahan yang melanggar. Anda dapat memilih keluar dengan melewati --create-manifest-if-needed=false.

  Peringatan

  Jangan jalankan perintah alat dari folder Unduhan atau lokasi bersama apa pun. CLI berjalan ke pohon direktori untuk menemukan manifes alat, yang dapat menyebabkannya menggunakan manifes yang tidak Anda harapkan. Selalu jalankan perintah alat dari direktori tepercaya khusus proyek.

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

• --source <SOURCE>

  Menentukan sumber untuk paket NuGet.

• -?|-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 atau --no-http-cache

  Jangan cache paket dan permintaan HTTP.

• --prerelease

  Sertakan paket prarilis.

• --tool-manifest <PATH>

  Jalur ke file manifes.

• --tool-path <PATH>

  Menentukan lokasi untuk 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], dan diag[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, --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 -g dotnetsay@2.1.7

  Menginstal dotnetsay versi 2.1.7 sebagai alat global.

• dotnet tool install dotnetsay

  Menginstal dotnetsay sebagai alat lokal untuk direktori saat ini.

• dotnet tool install dotnetsay@2.1.7

  Menginstal dotnetsay versi 2.1.7 sebagai alat lokal untuk direktori saat ini.

• dotnet tool install -g dotnetsay --verbosity minimal

  Menginstal dotnetsay sebagai alat global dengan verbositas minimal. Verbositas default untuk alat global diam.

• dotnet tool install -g dotnetsay --allow-roll-forward

  Menginstal dotnetsay sebagai alat global dan memungkinkannya untuk berjalan pada versi .NET yang lebih baru jika runtime target tidak tersedia.

Lihat juga

• Alat .NET
• Tutorial: Menginstal dan menggunakan alat global .NET menggunakan .NET CLI
• Tutorial: Menginstal dan menggunakan alat lokal .NET menggunakan .NET CLI