Bagikan melalui

penginstalan baru dotnet

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

Nama

dotnet new install - menginstal paket templat.

Sinopsis

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Deskripsi

Perintah dotnet new install menginstal paket templat dari PATH atau NUGET_ID yang disediakan. Jika Anda ingin menginstal versi tertentu atau versi prarilis paket templat, tentukan versi dalam format <package-name>@<package-version>. (Pemisah :: titik dua tidak digunakan lagi demi @ karakter dalam .NET 9.0.200 SDK.) Secara default, dotnet new meneruskan * untuk versi , yang mewakili versi paket stabil terbaru. Untuk informasi selengkapnya, lihat bagian Contoh.

Jika versi paket templat sudah diinstal saat Anda menjalankan perintah ini, paket templat akan diperbarui ke versi yang ditentukan. Jika tidak ada versi yang ditentukan, paket diperbarui ke versi stabil terbaru. Dimulai dengan .NET SDK 6.0.100, jika argumen menentukan versi, dan versi paket NuGet tersebut sudah diinstal, maka tidak akan diinstal ulang. Jika argumen adalah PATH dan sudah diinstal, argumen tersebut tidak akan diinstal ulang.

Sebelum .NET SDK 6.0.100, paket templat dikelola satu per satu untuk setiap versi .NET SDK, termasuk versi patch . Misalnya, jika Anda menginstal paket templat menggunakan dotnet new --install di .NET SDK 5.0.100, paket tersebut hanya akan diinstal untuk .NET SDK 5.0.100. Templat dari paket tidak akan tersedia di versi .NET SDK lain yang diinstal pada komputer Anda.

Dimulai dengan .NET SDK 6.0.100, paket templat yang diinstal tersedia di versi .NET SDK yang diinstal di komputer Anda. Paket templat yang diinstal di .NET SDK 6.0.100 juga akan tersedia di .NET SDK 6.0.101, .NET SDK 6.0.200, dan sebagainya. Namun, paket templat ini tidak akan tersedia dalam versi .NET SDK sebelum .NET SDK 6.0.100. Untuk menggunakan paket templat yang diinstal di .NET SDK 6.0.100 atau yang lebih baru di versi .NET SDK sebelumnya, Anda perlu menginstalnya menggunakan dotnet new install dalam versi .NET SDK tersebut.

Nota

Dimulai dengan .NET 7 SDK, sintaks dotnet new telah berubah:

  • Opsi --list, --search, --install, dan --uninstall menjadi sub-perintah list, search, install, dan uninstall.
  • Opsi --update-apply menjadi sub-perintah update.
  • Untuk menggunakan --update-check, gunakan sub-perintah update dengan opsi --check-only.

Opsi lain yang tersedia sebelumnya masih tersedia untuk digunakan dengan sub-perintah masing-masing. Bantuan terpisah untuk setiap sub-perintah tersedia melalui opsi -h atau --help: dotnet new <subcommand> --help mencantumkan semua opsi yang didukung untuk sub-perintah.

Selain itu, penyelesaian tab sekarang tersedia untuk dotnet new. Ini mendukung penyelesaian untuk nama templat yang diinstal dan untuk opsi yang disediakan templat yang dipilih. Untuk mengaktifkan penyelesaian tab untuk .NET SDK, lihat Mengaktifkan penyelesaian tab.

Contoh sintaks lama:

  • Instal versi terbaru paket templat proyek pekerjaan web Azure:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Peringatan

Templat dapat menjalankan kode MSBuild dan kode arbitrer lainnya saat dipicu. Jangan menginstal atau menjalankan templat .NET yang tidak tepercaya.

Argumen

  • <PATH|NUGET_ID>

    Folder pada sistem file atau pengidentifikasi paket NuGet untuk menginstal paket templat. dotnet new mencoba menginstal paket NuGet dari sumber NuGet yang tersedia untuk direktori kerja saat ini dan sumber yang ditentukan melalui opsi --add-source. Jika Anda ingin menginstal versi tertentu atau versi prarilis paket templat dari sumber NuGet, tentukan versi dalam format <package-name>@<package-version>. (Pemisah :: titik dua tidak digunakan lagi demi @ karakter dalam .NET 9.0.200 SDK.)

Opsi

  • --add-source|--nuget-source <SOURCE>

    Secara default, dotnet new install menggunakan hierarki file konfigurasi NuGet dari direktori saat ini untuk menentukan sumber NuGet tempat paket dapat diinstal. Jika --nuget-source ditentukan, sumber akan ditambahkan ke daftar sumber yang akan diperiksa. Untuk memeriksa sumber yang dikonfigurasi untuk direktori saat ini, gunakan dotnet nuget list source. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

    Nota

    Setelah inisiatif Https Everywhere NuGet, dotnet new melakukan phasing out umpan http. Jika umpan http diteruskan, umpan tidak dikueri untuk paket dan peringatan ditampilkan. Opsi --force dapat digunakan untuk mengambil alih perilaku ini jika perlu.

  • -d|--diagnostics

    Mengaktifkan output diagnostik. Tersedia sejak .NET SDK 7.0.100.

  • --force

    Memungkinkan penginstalan paket templat dari sumber yang ditentukan bahkan jika paket templat akan diambil alih dari sumber lain. Tersedia sejak .NET SDK 7.0.100.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • --interactive

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

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

Contoh

  • Instal versi terbaru templat SPA untuk ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • Instal templat SPA versi 2.0 untuk ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates@2.0.0

  • Instal templat SPA versi 2.0 untuk ASP.NET Core dari sumber NuGet kustom menggunakan mode interaktif:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates@2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

Lihat juga

  • Last updated on