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， 然后选择"还原客户端 库"。