Bagikan melalui

dotnet tool exec

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

Nama

dotnet tool exec - Mengunduh dan memanggil alat .NET tanpa menginstalnya secara permanen.

Sinopsis

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

Perintah ini dotnet tool exec menyediakan mode pemanggilan alat satu bidikan untuk .NET Tools. Ini secara otomatis mengunduh paket alat yang ditentukan ke cache NuGet dan memanggilnya tanpa memodifikasi sistem PATH Anda atau memerlukan penginstalan permanen.

Saat Anda menjalankan dotnet tool exec, perintah :

  1. Memeriksa versi (atau rentang versi) yang Anda tentukan (atau versi terbaru jika tidak ada yang ditentukan) terhadap umpan NuGet yang dikonfigurasi untuk memutuskan paket mana yang akan diunduh.
  2. Mengunduh paket yang ditentukan ke cache NuGet (jika belum ada).
  3. Memanggil alat dengan argumen yang disediakan.
  4. Mengembalikan kode keluar alat.

dotnet tool exec bekerja dengan mulus dengan alat global dan lokal. Jika Anda memiliki manifes alat lokal yang tersedia, manifes menggunakan manifes untuk menentukan versi alat mana yang akan dijalankan.

Perintah ini juga ada dalam dua formulir lain untuk penggunaan yang lebih mudah

  • dotnet dnx - Alias tersembunyi untuk dotnet tool exec yang digunakan sebagai cara untuk dengan mudah mengimplementasikan skrip itu dnx sendiri
  • dnx - Skrip shell yang memanggil dotnet dnx dari SDK. Skrip ini disediakan oleh alat penginstal dan tersedia di PATH. Ini memungkinkan penggunaan alat yang sangat sederhana langsung melalui dnx <toolname>.

Arguments

  • PACKAGE_NAME

    ID paket NuGet dari alat .NET untuk dijalankan. Anda dapat secara opsional menentukan versi menggunakan @ sintaks, misalnya dotnetsay@2.1.0.

  • tool-arguments

    Argumen untuk diteruskan ke alat yang sedang dijalankan. Semuanya setelah -- diteruskan langsung ke alat.

Opsi

  • --allow-roll-forward

    Izinkan alat untuk menggunakan versi runtime .NET yang lebih baru jika runtime yang ditargetkannya tidak diinstal.

  • --add-source <SOURCE>

    Menambahkan sumber paket NuGet tambahan untuk digunakan selama penginstalan. Umpan diakses secara paralel, bukan dalam urutan fallback cascade. Jika paket dan versi yang sama tersedia dalam beberapa umpan, umpan tercepat akan menang. Untuk informasi selengkapnya, lihat Apa yang terjadi saat paket NuGet diinstal. Anda dapat mengontrol ini melalui penggunaan pemetaan sumber paket NuGet. Untuk informasi selengkapnya, lihat Pemetaan Sumber Paket.

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

  • --disable-parallel

    Mencegah pemulihan beberapa proyek secara paralel.

  • --ignore-failed-sources

    Memperlakukan kegagalan sumber paket sebagai peringatan.

  • --interactive

    Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi.

  • --no-http-cache

    Tidak menyimpan permintaan HTTP ke umpan NuGet yang dikonfigurasi.

  • --prerelease

    Memungkinkan paket prarilis dipilih saat menyelesaikan versi untuk diinstal.

  • --source <SOURCE>

    Menentukan sumber untuk paket NuGet.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah normal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

Examples

  • dotnet tool exec dotnetsay

    Mengunduh (jika perlu) dan menjalankan versi dotnetsay terbaru alat.

  • dotnet tool exec dotnetsay@2.1.0

    Mengunduh (jika perlu) dan menjalankan alat versi 2.1.0 dotnetsay .

  • dotnet tool exec dotnetsay@2.*

    Mengunduh (jika perlu) dan menjalankan versi dotnetsay terbaru alat dalam rentang versi 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Menjalankan alat dan meneruskan "Halo Dunia" sebagai argumen ke alat.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Mengunduh dan menjalankan mytool menggunakan sumber NuGet yang ditentukan.

Perbandingan dengan perintah lain

Perintah ini dimaksudkan untuk menjadi cara terpadu untuk bekerja dengan .NET Tools. Meskipun perintah penginstalan alat yang tersedia sebelumnya tetap tersedia, dotnet tool exec memberikan pengalaman yang lebih sederhana dan lebih fleksibel bagi sebagian besar pengguna.

Command Tujuan Installation Ruang lingkup
dotnet tool exec Eksekusi satu bidikan Tidak ada (hanya di-cache) Temporary
dotnet tool install -g Penginstalan global permanen Global Seluruh sistem
dotnet tool install Penginstalan lokal permanen Manifes lokal Proyek
dotnet tool run Jalankan alat lokal yang sudah diinstal Memerlukan penginstalan sebelumnya Proyek

Perintah dotnet tool install -g ini masih melayani tujuan penting bagi pengguna yang ingin menginstal alat secara permanen. Namun, bagi pengguna yang ingin mencoba alat atau menjalankannya dalam alur CI/CD, dotnet tool exec sering kali lebih cocok.

Lihat juga

  • Last updated on