ASP.NET gestion de bibliothèque client de ASP.NET Core LibMan

environnement

Studio visuel

• Studio visuel 2019

ASP.NET noyau

• 3.1

Gestion de la bibliothèque cliente

Lorsque vous créez un nouveau ASP.NET Core, le dossier wwwroot/lib contient des bibliothèques clientes telles que bootstrap et jquery. Si vous n’utilisez pas la bibliothèque cliente, c’est toujours un problème. En général, vous ajoutez souvent de nouvelles bibliothèques ou mettez à niveau des bibliothèques existantes telles que jquery.

Si vous utilisez une bibliothèque sur un autre serveur sur Internet, comme un CDN, vous n’avez pas besoin d’en être conscient. Si vous souhaitez utiliser la bibliothèque sur votre serveur, vous devez télécharger manuellement la bibliothèque et la placer dans ce dossier lib.

Toutefois, à mesure que les bibliothèques augmentent et que le temps passe, la gestion devient gênante, comme « Quelle version est la version actuelle ? », « Y a-t-il un fichier nécessaire correctement ? », « Je dois retrouver une nouvelle version ».

Ainsi ASP.NET Core vous permet de gérer les bibliothèques de ces clients en vrac avec une fonctionnalité de gestion de bibliothèque appelée LibMan.

Présentation de LibMan

À partir de Solution Explorer, cliquez à droite sur le projet et sélectionnez Gérer les bibliothèques côté client.

Cela ajoutera un fichier appelé libman.json.

Le contenu du fichier est affiché dans la figure. Vous pouvez le modifier directement, mais il n’est pas souvent entré directement parce qu’il est édité sans autorisation par opération d’écran. Pour l’instant, c’est la seule introduction.

Ajouter des bibliothèques clients

Cliquez à droite sur le projet → ajouter une nouvelle bibliothèque côté client.

Sélectionnez un fournisseur et entrez le nom de la bibliothèque que vous souhaitez introduire dans la bibliothèque. Vous pouvez rechercher par correspondance partielle, de sorte que vous pouvez entrer uniquement le nom qui est la clé.

Par exemple, si vous tapez jquery, les suggestions suivantes sont affichées :

Appuyez sur entrez ou sélectionnez un candidat en ce moment. La dernière version est alors automatiquement sélectionnée.

Soit dit en passant, s’il n’y a pas de candidats, le fournisseur sélectionné peut ne pas être géré, alors essayez de choisir un autre fournisseur.

L’emplacement cible est plus facile à gérer en fonction du paramètre par défaut de « wwwroot/lib/ », de sorte que vous pouvez le laisser tel quel.

Après avoir entré dans la bibliothèque, cliquez sur le bouton d’installation.

Si vous voyez un dialogue similaire à ce qui suit, il peut ne pas exister dans le fournisseur ou spécifier une version, etc.

Le contenu de libman.json sont ensuite ajoutés comme suit :

Lorsqu’une bibliothèque est enregistrée dans libman.json, elle est automatiquement téléchargée sur wwwroot/lib (ce qui peut prendre un certain temps). Toutefois, comme jquery est dans le dossier lib depuis le début, il peut ne pas être à jour (il peut être). Dans ce cas, supprimez le jquery existant, puis mettez à jour libman comme suit (vous n’avez rien à faire si elle est à jour).

Vous pouvez supprimer toutes les bibliothèques existantes si vous les gérez en libman.

Cliquez à droite sur libman.json et sélectionnez Restaurer la bibliothèque côté client.

La bibliothèque est téléchargée automatiquement.

Essayez d’introduire une nouvelle bibliothèque.js « grille-pain ».

Il a été introduit sans avoir à le télécharger manuellement.

Comment utiliser la bibliothèque

Vous utilisez généralement simplement des balises de lien et de script pour spécifier le chemin approprié.

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

Modifications et mises à jour de la version de la bibliothèque

Ouvrez libman.json.

Si vous effacez la version de la bibliothèque cible, vous verrez des suggestions, donc tout ce que vous avez à faire est de sélectionner la version que vous voulez. Enregistrez le fichier lorsque vous modifiez.

La bibliothèque est automatiquement mise à jour, mais si elle n’est pas mise à jour, cliquez à droite sur libman.json et sélectionnez Restaurer la bibliothèque côté client.