ASP.NET керування клієнтською бібліотекою Core LibMan

Середовищі

Візуальна студія

• Visual Studio 2019

ASP.NET ядро

• 3.1

Керування клієнтською бібліотекою

Коли ви створюєте новий ASP.NET Core, папка wwwroot/lib містить клієнтські бібліотеки, такі як bootstrap та jquery. Якщо ви не використовуєте клієнтську бібліотеку, це все одно проблема. Загалом, ви часто додаєте нові бібліотеки або оновлюєте існуючі бібліотеки, такі як jquery.

Якщо ви використовуєте бібліотеку на іншому сервері в Інтернеті, наприклад, cdN, ви не повинні знати про це. Якщо ви бажаєте використовувати бібліотеку на вашому сервері, вам слід вручну звантажити бібліотеку і помістити її до цієї теки lib.

Однак, оскільки бібліотеки збільшуються і час минає, управління стає клопітно, наприклад, "Яка версія є поточною версією?", "Чи є необхідний файл належним чином?", "Я повинен знайти нову версію знову".

Таким ASP.NET Core дозволяє керувати бібліотеками цих клієнтів оптом за допомогою функції управління бібліотекою під назвою LibMan.

Представляємо LibMan

У Провіднику рішень клацніть проект правою кнопкою миші та виберіть пункт Керування клієнтськими бібліотеками.

Буде додано файл з назвою libman.json.

Вміст файлу показаний на малюнку. Ви можете редагувати його безпосередньо, але він не часто вводиться безпосередньо, оскільки він редагується без дозволу операції екрану. Поки що це єдине введення.

Додавання клієнтських бібліотек

Клацніть проект правою кнопкою миші → додати нову клієнтську бібліотеку.

Виберіть постачальника та введіть ім'я бібліотеки, яку потрібно ввести в бібліотеку. Ви можете шукати за частковою відповідність, так що ви можете ввести тільки ім'я, яке є ключем.

Наприклад, якщо ввести jquery, відображатимуться такі пропозиції:

Натисніть клавішу Enter або виберіть кандидата. Після цього буде автоматично вибрано останню версію.

До речі, якщо кандидатів немає, обраним провайдером може не керувати, тому спробуйте вибрати іншого провайдера.

Цільовим розташуванням простіше керувати на основі типового параметра «wwwroot/lib/», отже ви можете залишити його без значення.

Після входу в бібліотеку натисніть кнопку встановити.

Якщо ви побачите діалогове вікно, подібне до наведеного нижче, його може не існувати у постачальника або вказати версію тощо.

Вміст libman.json потім додається наступним чином:

Коли бібліотеку зареєстровано на libman.json, вона автоматично завантажується на wwwroot/lib (це може зайняти деякий час). Однак, оскільки jquery знаходиться в папці lib з самого початку, вона може бути не в курсі (це може бути). У цьому випадку видаліть існуючий jquery, а потім оновіть libman наступним чином (вам не потрібно нічого робити, якщо він оновлений).

Ви можете вилучити всі існуючі бібліотеки, якщо керуєте ними у libman.

Клацніть правою кнопкою миші файл libman.json і виберіть команду Відновити клієнтську бібліотеку.

Бібліотека завантажується автоматично.

Спробуйте представити нову бібліотеку.js "toaster".

Він був введений без необхідності завантажувати його вручну.

Як користуватися бібліотекою

Зазвичай ви просто використовуєте посилання та теги скриптів, щоб вказати відповідний шлях.

<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 і виберіть команду Відновити клієнтську бібліотеку.