Szkolenie
Moduł
Tworzenie projektu .NET Aspire - Training
Dowiedz się, jak tworzyć aplikacje natywne dla chmury od podstaw lub dodawać orkiestrację do istniejącej aplikacji przy użyciu stosu .NET Aspire na platformie .NET 8.
Ta przeglądarka nie jest już obsługiwana.
Przejdź na przeglądarkę Microsoft Edge, aby korzystać z najnowszych funkcji, aktualizacji zabezpieczeń i pomocy technicznej.
Platforma .NET udostępnia system szablonów, który umożliwia użytkownikom instalowanie lub odinstalowywanie pakietów zawierających szablony z pakietu NuGet, pliku pakietu NuGet lub katalogu systemu plików. W tym artykule opisano sposób zarządzania szablonami platformy .NET za pomocą interfejsu wiersza polecenia zestawu .NET SDK.
Aby uzyskać więcej informacji na temat tworzenia szablonów, zobacz Samouczek: tworzenie szablonów.
Pakiety szablonów są instalowane za pomocą dotnet new polecenia install SDK. Możesz podać identyfikator pakietu NuGet pakietu szablonu lub folder zawierający pliki szablonu.
Pakiety szablonów interfejsu wiersza polecenia platformy .NET są przekazywane do pakietu NuGet w celu szerokiej dystrybucji. Pakiety szablonów można również instalować z prywatnego źródła danych. Zamiast przekazywać pakiet szablonu do źródła danych NuGet, pliki szablonów nupkg mogą być dystrybuowane i instalowane ręcznie, zgodnie z opisem w sekcji Pakiet NuGet lokalny.
Aby uzyskać więcej informacji na temat konfigurowania źródeł danych NuGet, zobacz dotnet nuget add source.
Aby zainstalować pakiet szablonu z domyślnego źródła danych NuGet, użyj dotnet new install {package-id}
polecenia :
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
Aby zainstalować pakiet szablonu z domyślnego źródła danych NuGet z określoną wersją, użyj dotnet new install {package-id}::{version}
polecenia :
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.2.6
Po utworzeniu pakietu szablonu jest generowany plik nupkg . Jeśli masz plik nupkg zawierający szablony, możesz go zainstalować za dotnet new install {path-to-package}
pomocą polecenia :
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
Alternatywą dla instalowania szablonu z pliku nupkg jest również zainstalowanie szablonów z folderu bezpośrednio za dotnet new install {folder-path}
pomocą polecenia . Określony folder jest traktowany jako identyfikator pakietu szablonu dla dowolnego znalezionego szablonu. Każdy szablon znaleziony w hierarchii określonego folderu jest zainstalowany.
dotnet new install c:\code\nuget-packages\some-folder\
dotnet new install ~/code/nuget-packages/some-folder/
Określony {folder-path}
w poleceniu staje się identyfikatorem pakietu szablonu dla wszystkich znalezionych szablonów. Zgodnie z opisem w sekcji Listy pakietów szablonów można uzyskać listę pakietów szablonów zainstalowanych za dotnet new uninstall
pomocą polecenia . W tym przykładzie identyfikator pakietu szablonu jest wyświetlany jako folder używany do instalacji:
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
Pakiety szablonów są odinstalowywane za pomocą dotnet new polecenia odinstalowywania zestawu SDK. Możesz podać identyfikator pakietu NuGet pakietu szablonu lub folder zawierający pliki szablonu.
Po zainstalowaniu pakietu szablonu NuGet za pomocą źródła danych NuGet lub pliku nupkg można go odinstalować, odwołując się do identyfikatora pakietu NuGet.
Aby odinstalować pakiet szablonu, użyj dotnet new uninstall {package-id}
polecenia :
dotnet new uninstall Microsoft.DotNet.Web.Spa.ProjectTemplates
Gdy szablony są instalowane za pośrednictwem ścieżki folderu, ścieżka folderu staje się identyfikatorem pakietu szablonu.
Aby odinstalować pakiet szablonu, użyj dotnet new uninstall {package-folder-path}
polecenia :
dotnet new uninstall c:\code\nuget-packages\some-folder
dotnet new uninstall /home/username/code/templates
Korzystając ze standardowego polecenia dezinstalacji bez identyfikatora pakietu, można wyświetlić listę zainstalowanych pakietów szablonów wraz z poleceniem, które odinstalowuje każdy pakiet szablonu.
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
Jeśli zainstalowano każdą wersję zestawu SDK sekwencyjnie, na przykład zainstalowano zestaw SDK 6.0, zestaw SDK 7.0 itd., będziesz mieć zainstalowane szablony każdego zestawu SDK. Jeśli jednak zaczniesz od nowszej wersji zestawu SDK, takiej jak 7.0, uwzględniane są tylko szablony dla tej wersji. Szablony dla każdej innej wersji nie są uwzględniane.
Szablony platformy .NET są dostępne w witrynie NuGet i można je zainstalować jak każdy inny szablon. Aby uzyskać więcej informacji, zobacz Instalowanie pakietu hostowanego NuGet.
Na przykład zestaw .NET 9 SDK zawiera szablony dla aplikacji konsolowej przeznaczonej dla platformy .NET 9. Jeśli chcesz kierować program .NET Core 3.1, musisz zainstalować pakiet szablonu 3.1.
Spróbuj utworzyć aplikację przeznaczoną dla platformy .NET Core 3.1.
dotnet new console --framework netcoreapp3.1
Jeśli zostanie wyświetlony komunikat o błędzie, musisz zainstalować szablony.
Zainstaluj szablony projektów platformy .NET Core 3.1.
dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1
Spróbuj utworzyć aplikację po raz drugi.
dotnet new console --framework netcoreapp3.1
Powinien zostać wyświetlony komunikat wskazujący, że projekt został utworzony.
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.
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię:
Szkolenie
Moduł
Tworzenie projektu .NET Aspire - Training
Dowiedz się, jak tworzyć aplikacje natywne dla chmury od podstaw lub dodawać orkiestrację do istniejącej aplikacji przy użyciu stosu .NET Aspire na platformie .NET 8.
Dokumentacja
Polecenie dotnet new install instaluje pakiet szablonu.
dotnet nowa aktualizacja - .NET CLI
Polecenie dotnet new update aktualizuje zainstalowane pakiety szablonów.
dotnet new uninstall - .NET CLI
Polecenie dotnet new uninstall odinstalowuje pakiet szablonu.