在 ASP.NET Core 中添加靜態文件
雖然ASP.NET主要大都做着后端的事情,但前端的一些靜態文件也是很重要的。在ASP.NET Core中要啟用靜態文件,需要Microsoft.AspNetCore.StaticFiles
組件。可以通過Nuget添加,或者在project.json
配置文件中添加:
然后在Startup
類中的Configre
方法里調用UseStaticFiles
擴展方法來實現:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
loggerFactory.AddConsole();
app.UseStaticFiles();//使用靜態文件
//省略其他代碼
}
雖然現在很多人在開發.NET CORE時使用VS Code,但我還是不值得放棄VS這么強大的工具。
我們使用空的ASP.NET Core模板創建一個項目進行測試:
並添加上面說的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>
更改為自己的端口號。
官方說可以通過添加hosting.json
配置來更改默認的wwwroot
路徑,但我更改后運行並沒有效果。若有朋友知道怎么更改,還請告知!
我添加了hosting.json
並添加如下配置后,該文件夾圖標會改變,但運行后無法讀取到靜態文件,還是通過wwwroot
路徑讀取。
{
"webroot": "statics"
}
使用npm管理JavaScript包
在ASP.NET 5或之前使用JavaScript一般是使用NuGet來管理,在VS2015中添加了其他包管理工具,包括Node Package Manager (npm)
和Bower
。
要使用這些包管理工具,需要先添加配置文件,添加時保留默認名稱:
*因為安裝了Web Essentials擴展,右下角顯示了npm的logo。 *
添加配置文件后,在devDependencies
節點增加需要使用的JS庫的名稱,在VS中還支持提示和自動完成:
版本號支持^
和~
前綴。
- 若沒有前綴,只從服務器檢索與提供的版本號一致的版本。
^
前綴,將檢索與提供版本號主版本號一致的最新的版本。~
前綴,將檢索與提供版本號次版本號一致的最新的版本。
在配置文件添加了所需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
中需要的文件復制到webroot
的lib
文件夾,另兩個任務分別用於清除文件和壓縮文件。
在VS2015中,可以通過“任務運行程序資源管理器”(右鍵gulp配置文件,或通過視圖-其他窗口-任務運行程序資源管理器)進行任務管理,也可以將任務綁定到相應事件以自動運行。
其中清除會在清理項目時運行。
運行后目錄結構:
壓縮合並后,前端頁面只需引用一個site.min.js
就可以了。
gulp就不多說了,這里推薦個中文學習網站:Gulp 中文網。
使用Bower管理JavaScript包
因為npm是node.js的包管理工具,而node.js主要用於構建服務端程序。所以,其實客戶端的包管理工具我們有更好的選擇:Bower。
使用時可以添加Bower配置文件,或右鍵項目選擇“管理Bower程序包”。Bower在VS中使用方法和Nuget很像。
JS包默認安裝到webroot
的lib
文件夾,可以通過.bowerrc
文件更改安裝路徑。