Bagikan melalui

Mengelola templat proyek dan item .NET

  • Artikel

.NET menyediakan sistem templat yang memungkinkan pengguna menginstal atau menghapus instalan paket yang berisi templat dari NuGet, file paket NuGet, atau direktori sistem file. Artikel ini menjelaskan cara mengelola templat .NET melalui CLI .NET SDK.

Untuk informasi selengkapnya tentang membuat templat, lihat Tutorial: Membuat templat.

Menginstal templat

Paket templat diinstal melalui dotnet new perintah instal SDK. Anda dapat menyediakan pengidentifikasi paket NuGet dari paket templat, atau folder yang berisi file templat.

Paket yang dihosting NuGet

Paket templat .NET CLI diunggah ke NuGet untuk distribusi yang luas. Paket templat juga dapat diinstal dari umpan privat. Alih-alih mengunggah paket templat ke umpan NuGet, file templat nupkg dapat didistribusikan dan diinstal secara manual, seperti yang dijelaskan di bagian paket NuGet Lokal.

Untuk informasi selengkapnya tentang mengonfigurasi umpan NuGet, lihat dotnet nuget add source.

Untuk menginstal paket templat dari umpan NuGet default, gunakan dotnet new install {package-id} perintah :

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

Untuk menginstal paket templat dari umpan NuGet default dengan versi tertentu, gunakan dotnet new install {package-id}::{version} perintah :

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

Paket NuGet lokal

Saat paket templat dibuat, file nupkg dihasilkan. Jika Anda memiliki file nupkg yang berisi templat, Anda dapat menginstalnya dengan dotnet new install {path-to-package} perintah :

dotnet new install c:\code\nuget-packages\Some.Templates.1.0.0.nupkg

dotnet new install ~/code/nuget-packages/Some.Templates.1.0.0.nupkg

Folder

Sebagai alternatif untuk menginstal templat dari file nupkg , Anda juga dapat menginstal templat dari folder langsung dengan dotnet new install {folder-path} perintah . Folder yang ditentukan diperlakukan sebagai pengidentifikasi paket templat untuk templat apa pun yang ditemukan. Templat apa pun yang ditemukan dalam hierarki folder yang ditentukan diinstal.

dotnet new install c:\code\nuget-packages\some-folder\

dotnet new install ~/code/nuget-packages/some-folder/

Yang {folder-path} ditentukan pada perintah menjadi pengidentifikasi paket templat untuk semua templat yang ditemukan. Seperti yang ditentukan di bagian Daftar paket templat, Anda bisa mendapatkan daftar paket templat yang diinstal dengan dotnet new uninstall perintah . Dalam contoh ini, pengidentifikasi paket templat ditampilkan sebagai folder yang digunakan untuk penginstalan:

dotnet new uninstall
Currently installed items:

... cut to save space ...

  c:\code\nuget-packages\some-folder
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall c:\code\nuget-packages\some-folder

dotnet new uninstall
Currently installed items:

... cut to save space ...

  /home/username/code/templates
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall /home/username/code/templates

Hapus instalan paket templat

Paket templat dihapus instalasinya dotnet new melalui perintah hapus instalan SDK. Anda dapat menyediakan pengidentifikasi paket NuGet dari paket templat, atau folder yang berisi file templat.

Paket NuGet

Setelah paket templat NuGet diinstal, baik dari umpan NuGet atau file nupkg , Anda dapat menghapus instalasinya dengan merujuk pengidentifikasi paket NuGet.

Untuk menghapus instalan paket templat, gunakan dotnet new uninstall {package-id} perintah :

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

Folder

Saat templat diinstal melalui jalur folder, jalur folder menjadi pengidentifikasi paket templat.

Untuk menghapus instalan paket templat, gunakan dotnet new uninstall {package-folder-path} perintah :

dotnet new uninstall c:\code\nuget-packages\some-folder

dotnet new uninstall /home/username/code/templates

Mencantumkan paket templat

Dengan menggunakan perintah hapus instalan standar tanpa pengidentifikasi paket, Anda dapat melihat daftar paket templat yang diinstal bersama dengan perintah yang menghapus instalan setiap paket templat.

dotnet new uninstall
Currently installed items:

... cut to save space ...

  c:\code\nuget-packages\some-folder
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall c:\code\nuget-packages\some-folder

Menginstal paket templat dari SDK lain

Jika Anda telah menginstal setiap versi SDK secara berurutan, misalnya Anda menginstal SDK 6.0, maka SDK 7.0, dan sebagainya, Anda akan menginstal setiap templat SDK. Namun, jika Anda mulai dengan versi SDK yang lebih baru, seperti 7.0, hanya templat untuk versi ini yang disertakan. Templat untuk rilis lain tidak disertakan.

Templat .NET tersedia di NuGet, dan Anda dapat menginstalnya seperti templat lainnya. Untuk informasi selengkapnya, lihat Menginstal paket yang dihosting NuGet.

SDK Pengidentifikasi Paket NuGet
.NET Core 2.1 Microsoft.DotNet.Common.ProjectTemplates.2.1
.NET Core 2.2 Microsoft.DotNet.Common.ProjectTemplates.2.2
.NET Core 3.0 Microsoft.DotNet.Common.ProjectTemplates.3.0
.NET Core 3.1 Microsoft.DotNet.Common.ProjectTemplates.3.1
.NET 5.0 Microsoft.DotNet.Common.ProjectTemplates.5.0
.NET 6.0 Microsoft.DotNet.Common.ProjectTemplates.6.0
.NET 7.0 Microsoft.DotNet.Common.ProjectTemplates.7.0
.NET 8.0 Microsoft.DotNet.Common.ProjectTemplates.8.0
ASP.NET Core 2.1 Microsoft.DotNet.Web.ProjectTemplates.2.1
ASP.NET Core 2.2 Microsoft.DotNet.Web.ProjectTemplates.2.2
ASP.NET Core 3.0 Microsoft.DotNet.Web.ProjectTemplates.3.0
ASP.NET Core 3.1 Microsoft.DotNet.Web.ProjectTemplates.3.1
ASP.NET Core 5.0 Microsoft.DotNet.Web.ProjectTemplates.5.0
ASP.NET Core 6.0 Microsoft.DotNet.Web.ProjectTemplates.6.0
ASP.NET Core 7.0 Microsoft.DotNet.Web.ProjectTemplates.7.0
ASP.NET Core 8.0 Microsoft.DotNet.Web.ProjectTemplates.8.0

Misalnya, .NET 8 SDK menyertakan templat untuk aplikasi konsol yang menargetkan .NET 8. Jika Anda ingin menargetkan .NET Core 3.1, Anda harus menginstal paket templat 3.1.

  1. Coba buat aplikasi yang menargetkan .NET Core 3.1.

    dotnet new console --framework netcoreapp3.1

    Jika Anda melihat pesan kesalahan, Anda perlu menginstal templat.

  2. Instal templat proyek .NET Core 3.1.

    dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1

  3. Coba buat aplikasi untuk kedua kalinya.

    dotnet new console --framework netcoreapp3.1

    Dan Anda akan melihat pesan yang menunjukkan proyek dibuat.

    The template "Console Application" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on path-to-project-file.csproj...
  Determining projects to restore...
  Restore completed in 1.05 sec for path-to-project-file.csproj.

Restore succeeded.

Lihat juga