LibMan, la administración de bibliotecas cliente de ASP.NET Core

medio ambiente

Estudio visual

• Visual Studio 2019

Núcleo de ASP.NET

• 3.1

Gestión de bibliotecas de clientes

Al crear un nuevo proyecto ASP.NET Core, la carpeta wwwroot/lib contiene bibliotecas de cliente como bootstrap y jquery. Si no usa la biblioteca de cliente, sigue siendo un problema. En general, a menudo agregará nuevas bibliotecas o actualizará bibliotecas existentes como jquery.

Si utiliza una biblioteca en otro servidor de Internet, como una red CDN, no tiene que tener en cuenta. Si desea utilizar la biblioteca del servidor, debe descargar manualmente la biblioteca y colocarla en esta carpeta lib.

Sin embargo, a medida que las bibliotecas aumentan y pasa el tiempo, la administración se vuelve problemática, como "¿Qué versión es la versión actual?", "¿Hay un archivo necesario correctamente?", "Tengo que encontrar una nueva versión de nuevo".

Así que ASP.NET Core le permite administrar las bibliotecas de estos clientes de forma masiva con una característica de administración de bibliotecas llamada LibMan.

Presentación de LibMan

En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Administrar bibliotecas del lado cliente.

Esto agregará un archivo llamado libman.json.

El contenido del archivo se muestra en la figura. Puede editarlo directamente, pero no suele introducirse directamente porque se edita sin permiso por operación de pantalla. Por ahora, esta es la única introducción.

Agregar bibliotecas de clientes

Haga clic con el botón derecho en el proyecto y → agregue una nueva biblioteca del lado cliente.

Seleccione un proveedor e introduzca el nombre de la biblioteca que desea introducir en la biblioteca. Puede buscar por coincidencia parcial, por lo que solo puede introducir el nombre que es la clave.

Por ejemplo, si escribe jquery, se muestran las siguientes sugerencias:

Pulse Intro o seleccione un candidato en este momento. A continuación, se selecciona automáticamente la versión más reciente.

Por cierto, si no hay candidatos, es posible que el proveedor seleccionado no se administre, así que intente elegir otro proveedor.

La ubicación de destino es más fácil de administrar en función de la configuración predeterminada de "wwwroot/lib/", por lo que puede dejarla tal cual.

Después de introducir la biblioteca, haga clic en el botón instalar.

Si ve un cuadro de diálogo similar al siguiente, es posible que no exista en el proveedor ni especifique una versión, etc.

A continuación, el contenido de libman.json se agrega de la siguiente manera:

Cuando una biblioteca está registrada en libman.json, se descarga automáticamente en wwwroot/lib (lo que puede tardar algún tiempo). Sin embargo, dado que jquery está en la carpeta lib desde el principio, puede que no esté actualizado (puede ser). En este caso, elimine la jquery existente y, a continuación, actualice libman de la siguiente manera (no tiene que hacer nada si está actualizada).

Puede eliminar todas las bibliotecas existentes si las administra en libman.

Haga clic con el botón derecho en libman.json y seleccione Restaurar biblioteca del lado cliente.

La biblioteca se descarga automáticamente.

Intente introducir una nueva biblioteca.js "tostadora".

Se introdujo sin tener que descargarlo manualmente.

Cómo utilizar la biblioteca

Normalmente solo se utilizan etiquetas de vínculo y script para especificar la ruta de acceso adecuada.

<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>

Cambios y actualizaciones en la versión de la biblioteca

Abra libman.json.

Si borra la versión de la biblioteca de destino, verá sugerencias, por lo que todo lo que tiene que hacer es seleccionar la versión que desea. Guarde el archivo al realizar cambios.

La biblioteca se actualiza automáticamente, pero si no se actualiza, haga clic con el botón derecho en libman.json y seleccione Restaurar biblioteca del lado cliente.