Bagikan melalui

dotnet tool install

  • Artikel

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 .

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 ke win-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 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, 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.

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

Lihat juga