ASP.NET 核心用戶端庫管理"LibMan"

頁面創建日期 :

環境

Visual Studio
  • Visual Studio 2019
ASP.NET Core
  • 3.1

用戶端庫管理

ASP.NET 創建新 Core 專案時,"wwwroot/lib"資料夾包含用戶端庫,如 bootstrap 和 jquery。 如果您從未使用過用戶端庫,則沒有問題。 通常,您經常添加新庫或升級現有庫(如 jquery)。

如果您使用 Internet 上其他伺服器上的庫(如 CDN),則不需要單獨考慮。 如果要將庫放在自己的伺服器上,則必須手動下載庫並將其放在此 lib 資料夾中。

但是,隨著庫數量的增加和時間的流長,管理變得很麻煩,例如"當前版本是什麼","需要哪些檔是整潔的","我必須再次查找新版本"。

因此 ASP.NET 核心使用名為 LibMan 的庫管理功能批量管理這些用戶端的庫。

LibMan 簡介

從解決方案資源管理器中右鍵單擊 項目,然後選擇"管理用戶端 庫"。

然後 添加一個名為 libman.json 的檔。

文件的內容如圖所示。 您可以直接編輯它,但您很少直接輸入它,因為它會在螢幕操作中編輯。 現在,這隻是介紹。

添加用戶端庫

右鍵單擊項目,選擇→添加的用戶端庫"。

選擇 提供者, 然後鍵入 要在庫中部署的庫的名稱。 由於可以在部分匹配中搜索,因此只需鍵入鍵的名稱即可。

例如 ,鍵入 jquery 時,建議如下所示:

此時,請按 Enter 或選擇建議。 然後,將自動選擇最新版本。

順便說一下,如果您沒有建議,則您選擇的提供程式可能不受管理,因此請嘗試選擇其他提供程式。

目標位置可以按原樣進行,因為根據初始設置"wwwroot/lib/",很容易管理。

輸入庫後 ,按下 「安裝」按鈕。

如果出現類似於以下內容的對話框,則提供程式可能不存在,或者可能未指定版本。

libman.json 的內容將按如下方式添加:

在 libman.json 中註冊庫時,它會自動下載到 wwwroot/lib(這可能需要一些時間)。 但是,jquery 可能不是最新的,因為 jquery 從一開始就位於 lib 檔夾中。 在這種情況下,請刪除現有 jquery,然後更新 libman,如下所示(如果它們是最新的,則不必執行任何操作)

如果由 libman 管理,可以刪除所有現有庫。

右鍵按一下 libman.json, 然後選擇「還原用戶端 庫」。

庫將自動下載。

嘗試引入新的庫.js toastr"

無需手動下載即可推出。

如何使用庫

通常,您只是使用連結或腳本標記來指定相應的路徑。

<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.min.css" />
<link rel="stylesheet" href="~/lib/toastr.js/toastr.css" />

<!-- 省略 -->

<script src="~/lib/popper.js/umd/popper.min.js"></script>
<script src="~/lib/bootstrap/dist/js/bootstrap.min.js"></script>
<script src="~/lib/toastr.js/toastr.min.js"></script>

庫版本更改和更新

打開 libman.json。

如果刪除函式庫的版本,系統將提示您,因此您只選擇該版本。 進行更改後,保存檔。

庫將自動更新,但如果未更新,請右鍵單擊 libman.json, 然後選擇「還原用戶端 庫」。