This article shows how Webpack could be used together with Visual Studio ASP.NET Core and Angular2. Both the client and the server side of the application is implemented inside one ASP.NET Core project which makes it easier to deploy.
Visual Studio 2015 version:
https://github.com/damienbod/Angular2WebpackVisualStudio
Visual Studio 2017 version:
https://github.com/damienbod/Angular2WebpackVisualStudio/tree/VisualStudio2017
Fabian Gosebrink, Damien Bowden, Roberto Simonetti. This post is hosted on both http://damienbod.com and http://blog.offering.solutions/
The ASP.NET Core application contains both the server side API services and also hosts the Angular client application. The source code for the Angular application is implemented in the angular2App folder. Webpack is then used to deploy the application, using the development build or a production build, which deploys the application to the wwwroot folder. This makes it easy to deploy the application using the standard tools from Visual Studio with the standard configurations.
The npm package.json configuration loads all the required packages for Angular and Webpack. The Webpack packages are all added to the devDependencies. A "npm build" script and also a "npm buildProduction" are also configured, so that the client application can be built using Webpack from the cmd line using "npm build" or "npm buildProduction". These two scripts just call the same cmd as the Webpack task runner.
{
"name": "angular2-webpack-visualstudio",
"version": "1.0.0",
"description": "",
"main": "wwwroot/index.html",
"author": "",
"license": "ISC",
"scripts": {
"ngc": "ngc -p ./tsconfig-aot.json",
"start": "concurrently \"webpack-dev-server --inline --progress --port 8080\" \"dotnet run\" ",
"webpack-dev": "set NODE_ENV=development && webpack",
"webpack-production": "set NODE_ENV=production && webpack",
"build-dev": "npm run webpack-dev",
"build-production": "npm run ngc && npm run webpack-production",
"watch-webpack-dev": "set NODE_ENV=development && webpack --watch --color",
"watch-webpack-production": "npm run build-production --watch --color",
"publish-for-iis": "npm run build-production && dotnet publish -c Release"
},
"dependencies": {
"@angular/common": "~2.4.3",
"@angular/compiler": "~2.4.3",
"@angular/core": "~2.4.3",
"@angular/forms": "~2.4.3",
"@angular/http": "~2.4.3",
"@angular/platform-browser": "~2.4.3",
"@angular/platform-browser-dynamic": "~2.4.3",
"@angular/router": "~3.4.1",
"@angular/upgrade": "~2.4.3",
"angular-in-memory-web-api": "0.2.4",
"core-js": "2.4.1",
"reflect-metadata": "0.1.9",
"rxjs": "5.0.3",
"zone.js": "0.7.5",
"@angular/compiler-cli": "~2.4.3",
"@angular/platform-server": "~2.4.3",
"bootstrap": "^3.3.7",
"ie-shim": "~0.1.0"
},
"devDependencies": {
"@types/node": "7.0.0",
"angular2-template-loader": "^0.6.0",
"angular-router-loader": "^0.5.0",
"awesome-typescript-loader": "^2.2.4",
"clean-webpack-plugin": "^0.1.15",
"concurrently": "^3.1.0",
"copy-webpack-plugin": "^4.0.1",
"css-loader": "^0.26.1",
"file-loader": "^0.9.0",
"html-webpack-plugin": "^2.26.0",
"jquery": "^2.2.0",
"json-loader": "^0.5.4",
"node-sass": "^4.3.0",
"raw-loader": "^0.5.1",
"rimraf": "^2.5.4",
"sass-loader": "^4.1.1",
"source-map-loader": "^0.1.6",
"style-loader": "^0.13.1",
"ts-helpers": "^1.1.2",
"tslint": "^4.3.1",
"tslint-loader": "^3.3.0",
"typescript": "2.0.3",
"url-loader": "^0.5.7",
"webpack": "^2.2.0-rc.4",
"webpack-dev-server": "^1.16.2"
},
"-vs-binding": {
"ProjectOpened": [
"watch-webpack-dev"
]
}
}
The tsconfig is configured to use commonjs as the module. The types are configured in this file, so typings are no longer required.
{
"compilerOptions": {
"target": "es5",
"module": "es2015",
"moduleResolution": "node",
"sourceMap": true,
"emitDecoratorMetadata": true,
"experimentalDecorators": true,
"removeComments": true,
"noImplicitAny": true,
"skipLibCheck": true,
"lib": [
"es2015",
"dom"
],
"types": [
"node"
]
},
"files": [
"angular2App/app/app.module.ts",
"angular2App/app/modules/about/about.module.ts",
"angular2App/main.ts"
],
"awesomeTypescriptLoaderOptions": {
"useWebpackText": true
},
"compileOnSave": false,
"buildOnSave": false
}
The Webpack development build >webpack -d just uses the source files and creates outputs for development. The production build copies everything required for the client application to the wwwroot folder, and uglifies the js files. The webpack -d --watch can be used to automatically build the dist files if a source file is changed.
The Webpack config file was created using the excellent github repository https://github.com/preboot/angular2-webpack. Thanks for this. Small changes were made to this, such as the process.env.NODE_ENV and Webpack uses different source and output folders to match the ASP.NET Core project. If you decide to use two different projects, one for server, and one for client, preboot or angular-cli, or both together would be a good choice for the client application.
/// <binding ProjectOpened='Run - Development' />
var environment = (process.env.NODE_ENV || "development").trim();
if (environment === "development") {
module.exports = require('./webpack.dev.js');
} else {
module.exports = require('./webpack.prod.js');
}
var path = require('path');
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var CopyWebpackPlugin = require('copy-webpack-plugin');
var CleanWebpackPlugin = require('clean-webpack-plugin');
var helpers = require('./webpack.helpers');
console.log('@@@@@@@@@ USING DEVELOPMENT @@@@@@@@@@@@@@@');
module.exports = {
devtool: 'source-map',
performance: {
hints: false
},
entry: {
'app': './angular2App/main.ts'
},
output: {
path: './wwwroot/',
filename: 'dist/[name].bundle.js',
chunkFilename: 'dist/[id].chunk.js',
publicPath: '/'
},
resolve: {
extensions: ['.ts', '.js', '.json', '.css', '.scss', '.html']
},
devServer: {
historyApiFallback: true,
stats: 'minimal',
outputPath: path.join(__dirname, 'wwwroot/')
},
module: {
rules: [
{
test: /\.ts$/,
loaders: [
'awesome-typescript-loader',
'angular-router-loader',
'angular2-template-loader',
'source-map-loader',
'tslint-loader'
]
},
{
test: /\.(png|jpg|gif|woff|woff2|ttf|svg|eot)$/,
loader: 'file-loader?name=assets/[name]-[hash:6].[ext]'
},
{
test: /favicon.ico$/,
loader: 'file-loader?name=/[name].[ext]'
},
{
test: /\.css$/,
loader: 'style-loader!css-loader'
},
{
test: /\.scss$/,
exclude: /node_modules/,
loaders: ['style-loader', 'css-loader', 'sass-loader']
},
{
test: /\.html$/,
loader: 'raw-loader'
}
],
exprContextCritical: false
},
plugins: [
new webpack.optimize.CommonsChunkPlugin({ name: ['app', 'polyfills']}),
new CleanWebpackPlugin(
[
'./wwwroot/dist',
'./wwwroot/assets'
]
),
new HtmlWebpackPlugin({
filename: 'index.html',
inject: 'body',
template: 'angular2App/index.html'
}),
new CopyWebpackPlugin([
{ from: './angular2App/images/*.*', to: 'assets/', flatten: true }
])
]
};
var path = require('path');
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var CopyWebpackPlugin = require('copy-webpack-plugin');
var CleanWebpackPlugin = require('clean-webpack-plugin');
var helpers = require('./webpack.helpers');
console.log('@@@@@@@@@ USING PRODUCTION @@@@@@@@@@@@@@@');
module.exports = {
entry: {
'vendor': './angular2App/vendor.ts',
'polyfills': './angular2App/polyfills.ts',
'app': './angular2App/main-aot.ts' // AoT compilation
},
output: {
path: './wwwroot/',
filename: 'dist/[name].[hash].bundle.js',
chunkFilename: 'dist/[id].[hash].chunk.js',
publicPath: '/'
},
resolve: {
extensions: ['.ts', '.js', '.json', '.css', '.scss', '.html']
},
devServer: {
historyApiFallback: true,
stats: 'minimal',
outputPath: path.join(__dirname, 'wwwroot/')
},
module: {
rules: [
{
test: /\.ts$/,
loaders: [
'awesome-typescript-loader',
'angular-router-loader?aot=true&genDir=aot/'
]
},
{
test: /\.(png|jpg|gif|woff|woff2|ttf|svg|eot)$/,
loader: 'file-loader?name=assets/[name]-[hash:6].[ext]'
},
{
test: /favicon.ico$/,
loader: 'file-loader?name=/[name].[ext]'
},
{
test: /\.css$/,
loader: 'style-loader!css-loader'
},
{
test: /\.scss$/,
exclude: /node_modules/,
loaders: ['style-loader', 'css-loader', 'sass-loader']
},
{
test: /\.html$/,
loader: 'raw-loader'
}
],
exprContextCritical: false
},
plugins: [
new CleanWebpackPlugin(
[
'./wwwroot/dist',
'./wwwroot/assets'
]
),
new webpack.NoEmitOnErrorsPlugin(),
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
},
output: {
comments: false
},
sourceMap: false
}),
new webpack.optimize.CommonsChunkPlugin(
{
name: ['vendor', 'polyfills']
}),
new HtmlWebpackPlugin({
filename: 'index.html',
inject: 'body',
template: 'angular2App/index.html'
}),
new CopyWebpackPlugin([
{ from: './angular2App/images/*.*', to: 'assets/', flatten: true }
])
]
};
The production build has to be run from the command line. At present ngc, the angular compiler, can only be used from the command line.
https://github.com/angular/angular/tree/master/modules/%40angular/compiler-cli
See also (Using ngc) http://blog.mgechev.com/2016/06/26/tree-shaking-angular2-production-build-rollup-javascript/
It can be run using npm run build-production which is configured in the package.json.
"build-production": "npm run ngc && npm run webpack-prodroduction"
The production build uses tsconfig-aot.json and main-aot.ts as an entry point.
{
"compilerOptions": {
"target": "es5",
"module": "es2015",
"moduleResolution": "node",
"sourceMap": false,
"emitDecoratorMetadata": true,
"experimentalDecorators": true,
"removeComments": true,
"noImplicitAny": true,
"suppressImplicitAnyIndexErrors": true,
"skipLibCheck": true,
"lib": [
"es2015",
"dom"
]
},
"files": [
"angular2App/app/app.module.ts",
"angular2App/app/modules/about/about.module.ts",
"angular2App/main-aot.ts"
],
"angularCompilerOptions": {
"genDir": "aot",
"skipMetadataEmit": true
},
"compileOnSave": false,
"buildOnSave": false
}
Lets dive into the webpack.dev.js a bit:
Firstly, all plugins are loaded which are required to process all the js, ts, ... files which are included, or used in the project.
var path = require('path');
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var CopyWebpackPlugin = require('copy-webpack-plugin');
var CleanWebpackPlugin = require('clean-webpack-plugin');
The npm environment variable NODE_ENV is used to define the type of build, either a development build or a production build. The entries are configured depending on this parameter.
entry: {
'app': './angular2App/main.ts' // JiT compilation
},
for webpack.prod.js
entry: {
'app': './angular2App/main-aot.ts' // AoT compilation
},
The entries provide Webpack with the required information, where to start from, or where to hook in to.
Webpack knows which paths to run and includes the corresponding files and packages.
The "loaders" section and the "modules" section in the configuration provides Webpack with the following information: which files it needs to get and how to read the files. The modules tells Webpack what to do with the files exactly. Like minifying or whatever.
In this project configuration, if a production node parameter is set, different plugins are pushed into the sections because the files should be treated differently.
output: {
path: "./wwwroot/",
filename: 'dist/[name].bundle.js',
chunkFilename: 'dist/[id].chunk.js',
publicPath: "/"
},
output for production adds a hash:
output: {
path: "./wwwroot/",
filename: 'dist/[name].[hash].bundle.js',
chunkFilename: 'dist/[id].[hash].chunk.js',
publicPath: "/"
},
tells webpack where to put the files in the end. You can use like wildcards to use the "name" or an "hash" or something like that.
module: {
rules: [
//...loaders here
]
},
tell webpack how to react when a certain file extension comes into play. It will then use loaders to handle that file.
The plugins you are providing in the end are necessary to configure how the files should be processed.
plugins: [
//...loaders here
]
The index.html contains all the references required for the Angular client. The scripts are added as part of the build and not manually. The developer only needs to use the imports.
Source index.html file in the angular2App/public folder:
<!doctype html>
<html>
<head>
<base href="./">
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Angular Webpack Template</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
</head>
<body>
<my-app>Loading...</my-app>
</body>
</html>
And the produced build file in the wwwroot folder. The script for the app has been added using Webpack. Hashes are used in a production build for cache busting.
<!doctype html>
<html>
<head>
<base href="./">
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Angular Webpack Template</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" href="css/bootstrap.css">
</head>
<body>
<my-app>Loading...</my-app>
<script type="text/javascript" src="/dist/app.bundle.js"></script></body>
</html>
The NPM Task Runner can be used to build the client SPA application from inside Visual Studio. This task runner can be downloaded from:
https://marketplace.visualstudio.com/items?itemName=MadsKristensen.NPMTaskRunner
The task runners need to be configured correctly. Go to Tools –> Options –> Projects and Solutions –> External Web Tools.
Check that are options are checked. See:
The npm scripts are used to build, watch the client application as required. The scripts can be run from the command line or the npm task runner.
"ngc": "ngc -p ./tsconfig-aot.json",
"start": "concurrently \"webpack-dev-server --inline --progress --port 8080\" \"dotnet run\" ",
"webpack-dev": "set NODE_ENV=development&& webpack",
"webpack-production": "set NODE_ENV=production&& webpack",
"build-dev": "npm run webpack-dev",
"build-production": "npm run ngc && npm run webpack-production",
"watch-webpack-dev": "set NODE_ENV=development&& webpack --watch --color",
"watch-webpack-production": "npm run build-production --watch --color",
"publish-for-iis": "npm run build-production && dotnet publish -c Release"
The watch-webpack-dev npm script can be automatically be started in Visual Studio by adding the following to the package.json
"-vs-binding": { "ProjectOpened": [ "watch-webpack-dev" ] }
Note Webpack task runner cannot be used to build the Angular webpack application as it uses the wrong options and cannot be used to do a production build due to the ngc.
SASS is used to style the SPA application. The SASS files can be built using the SASS. Webpack can build all the styles inline or as an external file, depending on your Webpack config.
{
test: /\.scss$/,
exclude: /node_modules/,
loaders: ["style", "css", "sass"]
},
See: https://damienbod.com/2016/10/14/using-sass-with-webpack-angular2-and-visual-studio/
clean-webpack-plugin is used to clean up the deployment folder inside the wwwroot. This ensures that the application uses the latest files.
The clean task can be configured as follows:
var CleanWebpackPlugin = require('clean-webpack-plugin');
And used in Webpack.
new CleanWebpackPlugin(['./wwwroot/dist']),
Note: require cannot be used because AoT does not work with this.
import { Thing } from './../../../models/thing';
import { TestDataService } from './../../../services/testDataService';
import { Component, OnInit } from '@angular/core';
@Component({
selector: 'home-component',
templateUrl: 'home.component.html'
})
export class HomeComponent implements OnInit {
public message: string;
public things: Thing[] = [];
public thing: Thing = new Thing();
constructor(private _dataService: TestDataService) {
this.message = "Things from the ASP.NET Core API";
}
ngOnInit() {
this.getAllThings();
}
public addThing() {
this._dataService
.Add(this.thing)
.subscribe(() => {
this.getAllThings();
this.thing = new Thing();
}, (error) => {
console.log(error);
});
}
public deleteThing(thing: Thing) {
this._dataService
.Delete(thing.id)
.subscribe(() => {
this.getAllThings();
}, (error) => {
console.log(error);
});
}
private getAllThings() {
this._dataService
.GetAll()
.subscribe(
data => this.things = data,
error => console.log(error),
() => console.log('Get all complete')
);
}
}
The ASP.NET Core API is quite small and tiny. It just provides a demo CRUD service.
using System.Linq;
using Angular2WebpackVisualStudio.Models;
using Angular2WebpackVisualStudio.Repositories.Things;
using Microsoft.AspNetCore.JsonPatch;
using Microsoft.AspNetCore.Mvc;
namespace Angular2WebpackVisualStudio.Controller
{
[Route("api/[controller]")]
public class ThingsController : Microsoft.AspNetCore.Mvc.Controller
{
private readonly IThingsRepository _thingsRepository;
public ThingsController(IThingsRepository thingsRepository)
{
_thingsRepository = thingsRepository;
}
[HttpGet]
public IActionResult Get()
{
return Ok(_thingsRepository.GetAll());
}
[HttpPost]
public IActionResult Add([FromBody] Thing thing)
{
if (thing == null)
{
return BadRequest();
}
if (!ModelState.IsValid)
{
return BadRequest(ModelState);
}
Thing newThing = _thingsRepository.Add(thing);
return CreatedAtRoute("GetSingleThing", new { id = newThing.Id }, newThing);
}
[HttpPatch("{id:int}")]
public IActionResult PartiallyUpdate(int id, [FromBody] JsonPatchDocument<Thing> patchDoc)
{
if (patchDoc == null)
{
return BadRequest();
}
Thing existingEntity = _thingsRepository.GetSingle(id);
if (existingEntity == null)
{
return NotFound();
}
Thing thing = existingEntity;
patchDoc.ApplyTo(thing, ModelState);
if (!ModelState.IsValid)
{
return BadRequest(ModelState);
}
Thing updatedThing = _thingsRepository.Update(id, thing);
return Ok(updatedThing);
}
[HttpGet]
[Route("{id:int}", Name = "GetSingleThing")]
public IActionResult Single(int id)
{
Thing thing = _thingsRepository.GetSingle(id);
if (thing == null)
{
return NotFound();
}
return Ok(thing);
}
[HttpDelete]
[Route("{id:int}")]
public IActionResult Remove(int id)
{
Thing thing = _thingsRepository.GetSingle(id);
if (thing == null)
{
return NotFound();
}
_thingsRepository.Delete(id);
return NoContent();
}
[HttpPut]
[Route("{id:int}")]
public IActionResult Update(int id, [FromBody]Thing thing)
{
var thingToCheck = _thingsRepository.GetSingle(id);
if (thingToCheck == null)
{
return NotFound();
}
if (id != thing.Id)
{
return BadRequest("Ids do not match");
}
if (!ModelState.IsValid)
{
return BadRequest(ModelState);
}
Thing updatedThing = _thingsRepository.Update(id, thing);
return Ok(updatedThing);
}
}
}
Note that in a normal environment, you should always return the typed classes and never the plain HTTP response like here. This application only has strings to return, and this is enough for the demo.
import { Thing } from './../models/thing';
import { Injectable } from '@angular/core';
import { Http, Response, Headers } from '@angular/http';
import 'rxjs/add/operator/map';
import { Observable } from 'rxjs/Observable';
import { Configuration } from '../app.constants';
@Injectable()
export class TestDataService {
private actionUrl: string;
private headers: Headers;
constructor(private _http: Http, private _configuration: Configuration) {
this.actionUrl = _configuration.Server + 'api/things/';
this.headers = new Headers();
this.headers.append('Content-Type', 'application/json');
this.headers.append('Accept', 'application/json');
}
public GetAll = (): Observable<Thing[]> => {
return this._http.get(this.actionUrl).map((response: Response) => <Thing[]>response.json());
}
public GetSingle = (id: number): Observable<Thing> => {
return this._http.get(this.actionUrl + id).map(res => <Thing>res.json());
}
public Add = (thingToAdd: Thing): Observable<Thing> => {
var toAdd = JSON.stringify({ name: thingToAdd.name });
return this._http.post(this.actionUrl, toAdd, { headers: this.headers }).map(res => <Thing>res.json());
}
public Update = (id: number, itemToUpdate: any): Observable<Thing> => {
return this._http
.put(this.actionUrl + id, JSON.stringify(itemToUpdate), { headers: this.headers })
.map(res => <Thing>res.json());
}
public Delete = (id: number): Observable<any> => {
return this._http.delete(this.actionUrl + id);
}
}
The Webpack configuration could also build all of the scss and css files to a separate app.css or app."hash".css which could be loaded as a single file in the distribution. Some of the vendor js and css could also be loaded directly in the html header using the index.html file and not included in the Webpack build.
If you are building both the client application and the server application in separate projects, you could also consider angular-cli of angular2-webpack for the client application.
Debugging the Angular in Visual Studio with breakpoints is not possible with this setup. The SPA app can be debugged in chrome.
https://github.com/preboot/angular2-webpack
https://webpack.github.io/docs/
https://github.com/jtangelder/sass-loader
https://github.com/petehunt/webpack-howto/blob/master/README.md
https://marketplace.visualstudio.com/items?itemName=MadsKristensen.NPMTaskRunner
http://blog.thoughtram.io/angular/2016/06/08/component-relative-paths-in-angular-2.html
https://angular.io/docs/ts/latest/guide/webpack.html
http://blog.mgechev.com/2016/06/26/tree-shaking-angular2-production-build-rollup-javascript/