Školení
Modul
Vytvoření projektu .NET Aspire - Training
Zjistěte, jak vytvářet zcela nativní cloudové aplikace nebo přidat orchestraci do existující aplikace pomocí zásobníku .NET Aspire v .NET 8.
Tento prohlížeč se už nepodporuje.
Upgradujte na Microsoft Edge, abyste mohli využívat nejnovější funkce, aktualizace zabezpečení a technickou podporu.
.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.
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.
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
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
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
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.
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
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
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
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 .NET 9 SDK například obsahuje šablony pro konzolovou aplikaci, která cílí na .NET 9. Pokud chcete cílit na .NET Core 3.1, budete muset nainstalovat balíček šablony 3.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.
Nainstalujte šablony projektů .NET Core 3.1.
dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1
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.
Zpětná vazba k produktu .NET
.NET je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby:
Školení
Modul
Vytvoření projektu .NET Aspire - Training
Zjistěte, jak vytvářet zcela nativní cloudové aplikace nebo přidat orchestraci do existující aplikace pomocí zásobníku .NET Aspire v .NET 8.