NET Core 靜態文件及JS包管理器(npm, Bower)的使用
在 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
文件更改安裝路徑。