Sdílet prostřednictvím

Správa šablon projektů a položek .NET

  • Článek

.NET poskytuje systém šablon, který uživatelům umožňuje instalovat nebo odinstalovat balíčky obsahující šablony z NuGetu, souboru balíčku NuGet nebo adresáře systému souborů. Tento článek popisuje, jak spravovat šablony .NET prostřednictvím rozhraní příkazového řádku sady .NET SDK.

Další informace o vytváření šablon najdete v tématu Kurz: Vytváření šablon.

Instalace šablony

Balíčky šablon se instalují prostřednictvím dotnet new příkazu install SDK. Můžete zadat identifikátor balíčku NuGet šablony nebo složku, která obsahuje soubory šablony.

Hostovaný balíček NuGet

Balíčky šablon rozhraní .NET CLI se nahrají do NuGetu pro širokou distribuci. Balíčky šablon lze také nainstalovat z privátního informačního kanálu. Místo nahrání balíčku šablony do informačního kanálu NuGet je možné distribuovat a ručně nainstalovat soubory šablon nupkg , jak je popsáno v části Místní balíček NuGet.

Další informace o konfiguraci informačních kanálů NuGet naleznete v tématu dotnet nuget add source.

Pokud chcete nainstalovat balíček šablony z výchozího informačního kanálu NuGet, použijte tento dotnet new install {package-id} příkaz:

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

Pokud chcete nainstalovat balíček šablony z výchozího informačního kanálu NuGet s konkrétní verzí, použijte dotnet new install {package-id}::{version} příkaz:

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

Místní balíček NuGet

Při vytvoření balíčku šablony se vygeneruje soubor nupkg . Pokud máte soubor nupkg obsahující šablony, můžete ho dotnet new install {path-to-package} nainstalovat pomocí příkazu:

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

Složka

Jako alternativu k instalaci šablony ze souboru nupkg můžete také nainstalovat šablony ze složky přímo pomocí dotnet new install {folder-path} příkazu. Zadaná složka se považuje za identifikátor balíčku šablony pro všechny nalezené šablony. Je nainstalována jakákoli šablona nalezená v hierarchii zadané složky.

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

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

Zadaným {folder-path} příkazem se stane identifikátor balíčku šablony pro všechny nalezené šablony. Jak je uvedeno v části Seznam balíčků šablon, můžete získat seznam balíčků šablon nainstalovaných pomocí dotnet new uninstall příkazu. V tomto příkladu se identifikátor balíčku šablony zobrazí jako složka použitá k instalaci:

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

Odinstalace balíčku šablony

Balíčky šablon se odinstalují pomocí dotnet new příkazu uninstall SDK. Můžete zadat identifikátor balíčku NuGet šablony nebo složku, která obsahuje soubory šablony.

Balíček NuGet

Po instalaci balíčku šablony NuGet, a to buď z informačního kanálu NuGet nebo souboru nupkg , můžete ho odinstalovat odkazem na identifikátor balíčku NuGet.

K odinstalaci balíčku šablony dotnet new uninstall {package-id} použijte příkaz:

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

Složka

Když jsou šablony nainstalovány prostřednictvím cesty ke složce, cesta ke složce se stane identifikátorem balíčku šablony.

K odinstalaci balíčku šablony dotnet new uninstall {package-folder-path} použijte příkaz:

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

dotnet new uninstall /home/username/code/templates

Seznam balíčků šablon

Pomocí standardního příkazu pro odinstalaci bez identifikátoru balíčku můžete zobrazit seznam nainstalovaných balíčků šablon spolu s příkazem, který odinstaluje každý balíček šablony.

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

Instalace balíčků šablon z jiných sad SDK

Pokud jste postupně nainstalovali každou verzi sady SDK, například jste nainstalovali sadu SDK 6.0, pak sadu SDK 7.0 atd., budete mít nainstalované šablony každé sady SDK. Pokud ale začnete s novější verzí sady SDK, například 7.0, budou zahrnuty pouze šablony pro tuto verzi. Šablony pro jakoukoli jinou verzi nejsou zahrnuty.

Šablony .NET jsou k dispozici na NuGetu a můžete je nainstalovat stejně jako jakoukoli jinou šablonu. Další informace najdete v tématu Instalace hostovaného balíčku NuGet.

Sada SDK Identifikátor balíčku 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

Sada .NET 8 SDK například obsahuje šablony pro konzolovou aplikaci, která cílí na .NET 8. Pokud chcete cílit na .NET Core 3.1, budete muset nainstalovat balíček šablony 3.1.

  1. Zkuste vytvořit aplikaci, která cílí na .NET Core 3.1.

    dotnet new console --framework netcoreapp3.1

    Pokud se zobrazí chybová zpráva, musíte šablony nainstalovat.

  2. Nainstalujte šablony projektů .NET Core 3.1.

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

  3. Zkuste aplikaci vytvořit podruhé.

    dotnet new console --framework netcoreapp3.1

    Měla by se zobrazit zpráva oznamující, že byl projekt vytvořen.

    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.

Viz také