ASP.NET knihovny klientů společnosti ASP.NET Core LibMan

Prostředí

Visual Studio

• Visual Studio 2019

ASP.NET jádro

• 3.1

Správa klientské knihovny

Když vytvoříte nový projekt ASP.NET Core, složka wwwroot/lib obsahuje klientské knihovny, jako je bootstrap a jquery. Pokud klientskou knihovnu nepoužíváte, je to stále problém. Obecně platí, že často přidáváte nové knihovny nebo upgradujete existující knihovny, jako je například jquery.

Pokud používáte knihovnu na jiném serveru v Síti Internet, například v síti CDN, nemusíte si toho být vědomi. Chcete-li knihovnu použít na serveru, je nutné knihovnu stáhnout ručně a umístit ji do této složky lib.

Jak se však knihovny zvětšují a čas plyne, správa se stává problémovou, například "Která verze je aktuální verze?", "Existuje potřebný soubor správně?", "Musím znovu najít novou verzi".

Takže ASP.NET Core vám umožňuje spravovat knihovny těchto klientů hromadně pomocí funkce správy knihovny s názvem LibMan.

Představujeme LibMan

V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt a vyberte Spravovat knihovny na straně klienta.

Tím přidáte soubor s názvem libman.json.

Obsah souboru je zobrazen na obrázku. Můžete jej upravit přímo, ale často se nezadá přímo, protože je upravován bez povolení operací obrazovky. Prozatím je to jediný úvod.

Přidání klientských knihoven

Klikněte pravým tlačítkem myši na projekt a → přidat novou knihovnu na straně klienta.

Vyberte zprostředkovatele a zadejte název knihovny, kterou chcete do knihovny zavést. Můžete vyhledávat podle částečné shody, takže můžete zadat pouze název, který je klíčem.

Pokud například zadáte příkaz jquery, zobrazí se následující návrhy:

Stiskněte klávesu ENTER nebo vyberte kandidáta. Poté je automaticky vybrána nejnovější verze.

Mimochodem, pokud nejsou žádní kandidáti, vybraný poskytovatel nemusí být spravován, takže zkuste vybrat jiného poskytovatele.

Cílové umístění je snazší spravovat na základě výchozího nastavení "wwwroot/lib/", takže jej můžete nechat tak, jak je.

Po vstupu do knihovny klepněte na tlačítko instalovat.

Pokud se zobrazí dialog podobný následujícímu, nemusí existovat v zprostředkovateli nebo zadat verzi atd.

Obsah libman.json se pak doplňuje takto:

Když je knihovna registrována na libman.json, automaticky se stáhne na wwwroot/lib (což může nějakou dobu trvat). Vzhledem k tomu, že jquery je ve složce lib od začátku, nemusí být aktuální (může být). V takovém případě odstraňte existující jquery a pak aktualizujte libman následujícím způsobem (nemusíte dělat nic, pokud je aktuální).

Pokud je spravujete v libmanu, můžete odstranit všechny existující knihovny.

Klepněte pravým tlačítkem myši na soubor libman.json a vyberte příkaz Obnovit knihovnu na straně klienta.

Knihovna se stáhne automaticky.

Zkuste zavést novou knihovnu.js "toustovač".

Byla zavedena, aniž by ji bylo nutné stahovat ručně.

Jak používat knihovnu

Obvykle používáte pouze značky odkazů a skriptů k určení příslušné cesty.

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

Změny a aktualizace verzí knihovny

Otevřete libman.json.

Pokud vymažete verzi cílové knihovny, zobrazí se návrhy, takže vše, co musíte udělat, je vybrat verzi, kterou chcete. Při změnách soubor uložte.

Knihovna se automaticky aktualizuje, ale pokud není aktualizována, klikněte pravým tlačítkem myši na libman.json a vyberte Obnovit knihovnu na straně klienta.