penginstalan baru dotnet

  • Artikel

Artikel ini berlaku untuk: ️ .NET Core 3.1 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>. 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 tidak akan diinstal ulang.

Sebelum .NET SDK 6.0.100, paket templat dikelola secara individual 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 lebih baru diinstal pada 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.

Catatan

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

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

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

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 SDK .NET, lihat Mengaktifkan penyelesaian tab.

Contoh sintaks lama:

  • Instal versi terbaru paket templat proyek pekerjaan web Azure:

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

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 --add-source opsi . Jika Anda ingin menginstal versi tertentu atau versi prarilis paket templat dari sumber NuGet, tentukan versi dalam format <package-name>::<package-version>.

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

    Catatan

    Mengikuti inisiatif Https Everywhere NuGet, dotnet new sedang melakukan phasing out http feed. http Jika umpan 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 meskipun paket templat akan diambil alih dari sumber lain. Tersedia sejak .NET SDK 7.0.100.

  • -h|--help

    Mencetak bantuan untuk perintah instal. Tersedia sejak .NET SDK 7.0.100.

  • --interactive

    Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi. Tersedia sejak .NET 5.0 SDK.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], dan diag[nostic]. Tersedia sejak .NET SDK 7.0.100.

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