aspnetcore/src/ProjectTemplates
Steve Sanderson 3657a429eb
Server-side Blazor template cleanups for Preview 4 (#9025)
* Rename Host.cshtml to _Host.cshtml

* In Startup.cs, specify root component and selector explicitly so you can easily disable prerendering if desired

* Remove unneccesary dependency on NewtonsoftJson package

* Remove unnecessary MapRazorPages and make blank lines consistent

* Rename "Services" subdirectory to "Data"

* Remove favicon.ico (no longer needed since we switched to MapFallbackToPage

* Revert MapComponentHub change due to reasons
2019-04-03 17:00:20 +01:00
..
Web.Client.ItemTemplates
Web.ItemTemplates
Web.ProjectTemplates Server-side Blazor template cleanups for Preview 4 (#9025) 2019-04-03 17:00:20 +01:00
Web.Spa.ProjectTemplates Make UseEndpoints a thing (#8765) 2019-03-28 15:41:11 -07:00
migrations
scripts Fixing the build for ProjectTemplates 2019-04-01 15:49:21 -07:00
test [Components] Relayer + Robust reconnect (#8911) 2019-04-02 19:17:03 +02:00
testassets/DotNetToolsInstaller
.gitignore Add launchSettings.json to worker template (#7550) 2019-02-13 15:54:15 -08:00
Directory.Build.props Add reference assemblies support (#7764) 2019-02-21 14:33:35 -08:00
Directory.Build.targets
GenerateContent.targets
ProjectTemplates.sln [Infrastructure improvements] (#8275) 2019-03-20 08:44:20 +01:00
README.md Fixing the build for ProjectTemplates 2019-04-01 15:49:21 -07:00
SetPackageProperties.targets Replace custom targets for generating assembly attributes and source control info by using SDK features (#7504) 2019-02-13 10:22:03 -08:00
THIRD-PARTY-NOTICES Use Bootstrap 3.4.1 and 4.3.1 (#7719) 2019-02-20 15:55:49 -08:00
TemplateProjects.props
build.cmd Install the .NET Core SDK into the repo root instead of UserProfile and 'install' copy of AspNetCore shared framework (#7293) 2019-02-06 11:20:49 -08:00
templates.nuspec

README.md

Templates

Getting Started

These are project templates which are used in .NET Core for creating ASP.NET Core applications.

Prerequisites

Some projects in this repository (like SignalR Java Client) require JDK installation and configuration of JAVA_HOME environment variable.

  1. If you don't have the JDK installed, you can find it from https://www.oracle.com/technetwork/java/javase/downloads/index.html
  2. After installation define a new environment variable named JAVA_HOME pointing to the root of the latest JDK installation (for Windows it will be something like c:\Program Files\Java\jdk-12).
  3. Add the %JAVA_HOME%\bin directory to the PATH environment variable

Building Templates

  1. Run . .\activate.ps1 if you haven't already.

  2. Run git submodule update in the repository root if you haven't already.

  3. Run build.cmd -all -pack in the repository root to build all of the dependencies.

  4. Run build.cmd in this directory will produce NuGet packages for each class of template in the artifacts directory.

  5. Because the templates build against the version of Microsoft.AspNetCore.App that was built during the previous step, it is NOT advised that you install templates created on your local machine via dotnet new -i [nupkgPath]. Instead, use the Run-[Template]-Locally.ps1 scripts in the script folder. These scripts do dotnet new -i with your packages, but also apply a series of fixes and tweaks to the created template which keep the fact that you don't have a production Microsoft.AspNetCore.App from interfering.

  6. The ASP.NET localhost development certificate must also be installed and trusted or else you'll get a test error "Certificate error: Navigation blocked".

** Note** Templating tests require Visual Studio unless a full build (CI) is performed.