aspnetcore/src/ProjectTemplates
Pranav K 126f14dbd2
Component package updates (#23371)
* Stop cross-compiling Component packages
* Remove Microsoft.JSInterop reference from M.A.Components
* Update RCL template

Fixes https://github.com/dotnet/aspnetcore/issues/23124
Fixes https://github.com/dotnet/aspnetcore/issues/23351
2020-06-29 11:36:59 -07:00
..
BlazorTemplates.Tests Replat blazor on net5 (#23078) 2020-06-23 18:19:55 -07:00
Shared Replat blazor on net5 (#23078) 2020-06-23 18:19:55 -07:00
Web.Client.ItemTemplates Add missing doc files and cleanup nits (#22931) 2020-06-17 13:04:45 -07:00
Web.ItemTemplates Add missing doc files and cleanup nits (#22931) 2020-06-17 13:04:45 -07:00
Web.ProjectTemplates Component package updates (#23371) 2020-06-29 11:36:59 -07:00
Web.Spa.ProjectTemplates Add missing doc files and cleanup nits (#22931) 2020-06-17 13:04:45 -07:00
migrations
scripts Port `-nobl` and `net5.0` changes from 'master' 2020-05-15 14:31:34 -07:00
test Replat blazor on net5 (#23078) 2020-06-23 18:19:55 -07:00
testassets/DotNetToolsInstaller [release/3.1] Update dependencies from 2 repositories (#13571) 2019-09-15 21:27:50 -07:00
.gitignore
.vsconfig Add .vsconfig files in root and beside slns 2020-03-31 14:25:44 -07:00
Directory.Build.props Add missing doc files and cleanup nits (#22931) 2020-06-17 13:04:45 -07:00
Directory.Build.targets
GenerateContent.targets
ProjectTemplates.sln Fixup .sln 2020-06-10 13:40:08 -07:00
ProjectTemplatesNoDeps.slnf Merge blazor-wasm in to master 2020-05-27 11:00:38 -07:00
README.md
THIRD-PARTY-NOTICES Upgrade jQuery in samples to version 3.5.1 (#21577) (#21792) 2020-06-10 09:59:29 -07:00
TemplateProjects.props Re-enable signing validation (#13899) 2019-11-19 07:14:34 -08:00
build.cmd
build.sh
startvs.cmd
templates.nuspec Re-enable signing validation (#13899) 2019-11-19 07:14:34 -08:00
xunit.runner.json Use xunit.runner.json in Helix runs (#19922) 2020-03-17 12:26:40 -07:00

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 --init --recursive if you haven't already.

  3. Run git submodule update to update submodules.

  4. Run build.cmd -all -pack -configuration Release in the repository root to build all of the dependencies.

  5. Run build.cmd -pack -NoRestore -NoBuilddeps -configuration Release in this directory will produce NuGet packages for each class of template in the artifacts directory.

  6. 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.

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

  8. Run .\build.cmd -test -NoRestore -NoBuild -NoBuilddeps -configuration Release "/p:RunTemplateTests=true" to run template tests.

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