ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

时间:2022-02-01 18:19:10

在 ASP.NET Core 中添加静态文件

虽然ASP.NET主要大都做着后端的事情,但前端的一些静态文件也是很重要的。在ASP.NET Core中要启用静态文件,需要Microsoft.AspNetCore.StaticFiles组件。可以通过Nuget添加,或者在project.json配置文件中添加:

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

然后在Startup类中的Configre方法里调用UseStaticFiles扩展方法来实现:

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
loggerFactory.AddConsole();
app.UseStaticFiles();//使用静态文件
//省略其他代码
}

虽然现在很多人在开发.NET CORE时使用VS Code,但我还是不值得放弃VS这么强大的工具。

我们使用空的ASP.NET Core模板创建一个项目进行测试:

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

并添加上面说的Microsoft.AspNetCore.StaticFiles组件,然后在wwwroot文件夹中添加文件Hello.html,内容如下:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>StaticDemo</title>
</head>
<body>
<h1>Hello From Static Files.</h1>
</body>
</html>

运行后,浏览器地址栏输入http://localhost:<port>/Hello.html<port>更改为自己的端口号。

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

官方说可以通过添加hosting.json配置来更改默认的wwwroot路径,但我更改后运行并没有效果。若有朋友知道怎么更改,还请告知!

我添加了hosting.json并添加如下配置后,该文件夹图标会改变,但运行后无法读取到静态文件,还是通过wwwroot路径读取。ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

{
"webroot": "statics"
}

使用npm管理JavaScript包

在ASP.NET 5或之前使用JavaScript一般是使用NuGet来管理,在VS2015中添加了其他包管理工具,包括Node Package Manager (npm)Bower

要使用这些包管理工具,需要先添加配置文件,添加时保留默认名称:

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

*因为安装了Web Essentials扩展,右下角显示了npm的logo。 *

添加配置文件后,在devDependencies节点增加需要使用的JS库的名称,在VS中还支持提示和自动完成:

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

版本号支持^~前缀。

  • 若没有前缀,只从服务器检索与提供的版本号一致的版本。
  • ^前缀,将检索与提供版本号主版本号一致的最新的版本。
  • ~前缀,将检索与提供版本号次版本号一致的最新的版本。

在配置文件添加了所需JS库后,会自动将JS库下载到node_modules文件夹(在VS项目中可能需要开启显示所有文件才能看到)。

但下载下来的文件其实很多我们都用不到,这时可以使用gulp创建任务,将我们需要的文件转移到web root文件夹。而node_modules文件夹就可以在版本控制,以及部署时忽略。

使用gulp压缩和构建JS

gulp是基于node.js构建的,所以我们需要在npm的配置package.json中添加对其的引用,其中包括几个常用插件。

{
"name": "myproject",
"version": "1.0.0",
"devDependencies": {
"gulp": "3.9.0",
"gulp-concat": "2.6.0",
"gulp-cssmin": "0.1.7",
"gulp-uglify": "1.2.0",
"rimraf": "2.4.2"
}
}

然后添加gulp的配置文件gulpfile.js(请查看前面添加nmp配置文件的图)。创建几个任务:

"use strict";
var gulp = require("gulp"),
rimraf = require("rimraf"),
concat = require("gulp-concat"),
cssmin = require("gulp-cssmin"),
uglify = require("gulp-uglify") var paths = {
webroot: "./wwwroot/"
};
paths.node_modules_libs = [
'node_modules/jquery/dist/jquery.js',
'node_modules/bootstrap/dist/js/bootstrap.js',
]
paths.lib = paths.webroot + 'lib/*.js';
paths.js = paths.webroot + "js/**/*.js";
paths.minJs = paths.webroot + "js/**/*.min.js";
paths.concatJsDest = paths.webroot + "js/site.min.js"; gulp.task('lib', function () { //复制npm包到web root中
gulp.src(paths.node_modules_libs).pipe(gulp.dest(paths.webroot + 'lib'))
}); gulp.task("clean:js", function (cb) { //清理压缩后的js文件
rimraf(paths.concatJsDest, cb);
});
gulp.task("min:js", function () { //将需要的js压缩并合并成一个文件以减少http请求数
gulp.src([paths.js, "!" + paths.minJs, paths.lib], { base: "." }).pipe(concat(paths.concatJsDest))
.pipe(uglify())
.pipe(gulp.dest("."));
});

其中lib任务将node_modules中需要的文件复制到webrootlib文件夹,另两个任务分别用于清除文件和压缩文件。

在VS2015中,可以通过“任务运行程序资源管理器”(右键gulp配置文件,或通过视图-其他窗口-任务运行程序资源管理器)进行任务管理,也可以将任务绑定到相应事件以自动运行。

其中清除会在清理项目时运行。

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

运行后目录结构:

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

压缩合并后,前端页面只需引用一个site.min.js就可以了。

gulp就不多说了,这里推荐个中文学习网站:Gulp 中文网

使用Bower管理JavaScript包

因为npm是node.js的包管理工具,而node.js主要用于构建服务端程序。所以,其实客户端的包管理工具我们有更好的选择:Bower

使用时可以添加Bower配置文件,或右键项目选择“管理Bower程序包”。Bower在VS中使用方法和Nuget很像。

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用

JS包默认安装到webrootlib文件夹,可以通过.bowerrc文件更改安装路径。

ASP.NET Core 静态文件及JS包管理器(npm, Bower)的使用