ASP.NET libman della gestione delle librerie client di Core

ambiente

Visual Studio

• Visual Studio 2019

ASP.NET Nucleo

• 3.1

Gestione della libreria client

Quando si crea un nuovo ASP.NET Core, la cartella wwwroot/lib contiene librerie client quali bootstrap e jquery. Se non si utilizza la libreria client, è comunque un problema. In generale, spesso si aggiungono nuove librerie o si aggiornano librerie esistenti, ad esempio jquery.

Se si utilizza una libreria su un altro server su Internet, ad esempio una RETE CDN, non è necessario esserne a conoscenza. Se si desidera utilizzare la raccolta nel server, è necessario scaricare manualmente la raccolta e posizionarla in questa cartella lib.

Tuttavia, con l'aumento e il passare del tempo delle librerie, la gestione diventa problematica, come "Quale versione è la versione corrente?", "C'è un file necessario correttamente?", "Devo trovare di nuovo una nuova versione".

Quindi ASP.NET Core ti consente di gestire le librerie di questi client in blocco con una funzione di gestione della libreria chiamata LibMan.

Presentazione di LibMan

In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci raccolte lato client.

Verrà aggiunto un file denominato libman.json.

Il contenuto del file è mostrato nella figura. È possibile modificarlo direttamente, ma spesso non viene immesso direttamente perché viene modificato senza autorizzazione per operazione sullo schermo. Per ora, questa è l'unica introduzione.

Aggiungere raccolte client

Fare clic con il pulsante destro del mouse sul → aggiungere una nuova libreria sul lato client.

Selezionare un provider e immettere il nome della raccolta che si desidera introdurre nella raccolta. È possibile eseguire ricerche in base alla corrispondenza parziale, in modo da poter immettere solo il nome che è la chiave.

Ad esempio, se si digita jquery, vengono visualizzati i suggerimenti seguenti:

Premere INVIO o selezionare un candidato in questo momento. L'ultima versione viene quindi selezionata automaticamente.

A proposito, se non ci sono candidati, il provider selezionato potrebbe non essere gestito, quindi prova a scegliere un altro provider.

La posizione di destinazione è più facile da gestire in base all'impostazione predefinita di "wwwroot/lib/", in modo da poterla lasciare così com'è.

Dopo aver immesso la raccolta, fare clic sul pulsante installa.

Se viene visualizzata una finestra di dialogo simile alla seguente, potrebbe non esistere nel provider o specificare una versione e così via.

Il contenuto di libman.json viene quindi aggiunto come segue:

Quando una libreria è registrata in libman.json, viene scaricata automaticamente su wwwroot/lib (che potrebbe richiedere del tempo). Tuttavia, poiché jquery si trova nella cartella lib dall'inizio, potrebbe non essere aggiornato (potrebbe essere). In questo caso, eliminare la jquery esistente e quindi aggiornare libman come segue (non è necessario eseguire nulla se è aggiornato).

È possibile eliminare tutte le librerie esistenti se le si gestisce in libman.

Fare clic con il pulsante destro del mouse su libman.json e scegliere Ripristina libreria sul lato client.

La libreria viene scaricata automaticamente.

Prova a introdurre una nuova libreria.js "tostapane".

È stato introdotto senza doverlo scaricare manualmente.

Come usare la libreria

In genere si usano solo tag di collegamento e script per specificare il percorso appropriato.

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

Modifiche e aggiornamenti della versione della libreria

Apri libman.json.

Se si cancella la versione della libreria di destinazione, verranno visualizzato suggerimenti, quindi tutto ciò che devi fare è selezionare la versione desiderata. Salvare il file quando si apporta modifiche.

La libreria viene aggiornata automaticamente, ma se non viene aggiornata, fare clic con il pulsante destro del mouse su libman.json e scegliere Ripristina libreria sul lato client.