ASP.NET gestão da biblioteca de clientes da Core, LibMan

ambiente

Estúdio Visual

• Visual Studio 2019

Núcleo ASP.NET

• 3.1

Gestão de bibliotecas de clientes

Quando você cria um novo projeto ASP.NET Core, a pasta wwwroot/lib contém bibliotecas de clientes, como bootstrap e jquery. Se você não usar a biblioteca de clientes, ainda é um problema. Em geral, muitas vezes você adicionará novas bibliotecas ou atualizará bibliotecas existentes, como jquery.

Se você usa uma biblioteca em outro servidor na Internet, como um CDN, você não precisa estar ciente disso. Se você quiser usar a biblioteca em seu servidor, você deve baixar manualmente a biblioteca e colocá-la nesta pasta lib.

No entanto, à medida que as bibliotecas aumentam e o tempo passa, a gestão se torna problemática, como "Qual versão é a versão atual?", "Existe um arquivo necessário corretamente?", "Eu tenho que encontrar uma nova versão novamente".

Assim, ASP.NET Core permite que você gerencie as bibliotecas desses clientes em massa com um recurso de gerenciamento de biblioteca chamado LibMan.

Apresentando LibMan

Do Solution Explorer, clique com o botão direito do mouse no projeto e selecione Gerenciar bibliotecas do lado do cliente.

Isso adicionará um arquivo chamado libman.json.

O conteúdo do arquivo é mostrado na figura. Você pode editá-lo diretamente, mas muitas vezes não é inserido diretamente porque é editado sem permissão por operação de tela. Por enquanto, esta é a única introdução.

Adicionar bibliotecas de clientes

Clique com o botão direito do mouse no projeto e → adicionar uma nova biblioteca do lado do cliente.

Selecione um provedor e digite o nome da biblioteca que deseja introduzir na biblioteca. Você pode pesquisar por partida parcial, para que você possa digitar apenas o nome que é a chave.

Por exemplo, se você digitar jquery, as seguintes sugestões ão exibidas:

Pressione digitar ou selecionar um candidato neste momento. A versão mais recente é então selecionada automaticamente.

A propósito, se não houver candidatos, o provedor selecionado pode não ser gerenciado, então tente escolher outro provedor.

O local de destino é mais fácil de gerenciar com base na configuração padrão de "wwwroot/lib/", para que você possa deixá-lo como está.

Depois de entrar na biblioteca, clique no botão instalar.

Se você vir uma caixa de diálogo semelhante à seguinte, ela pode não existir no provedor ou especificar uma versão, etc.

O conteúdo de libman.json é então adicionado da seguinte forma:

Quando uma biblioteca é registrada em libman.json, ela é automaticamente baixada para wwwroot/lib (o que pode levar algum tempo). No entanto, como jquery está na pasta lib desde o início, pode não estar atualizado (pode ser). Neste caso, exclua o jquery existente e atualize libman da seguinte forma (você não precisa fazer nada se estiver atualizado).

Você pode excluir todas as bibliotecas existentes se gerenciá-las em libman.

Clique com o botão direito do mouse em libman.json e selecione Restaurar biblioteca do lado do cliente.

A biblioteca é baixada automaticamente.

Tente introduzir uma nova biblioteca.js "torradeira".

Foi introduzido sem ter que baixá-lo manualmente.

Como usar a biblioteca

Você geralmente usa apenas tags de link e script para especificar o caminho apropriado.

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

Alterações e atualizações da versão da biblioteca

Abra libman.json.

Se você apagar a versão da biblioteca de destino, você verá sugestões, então tudo o que você precisa fazer é selecionar a versão desejada. Salve o arquivo quando fizer alterações.

A biblioteca é atualizada automaticamente, mas se não for atualizada, clique com o botão direito do mouse em libman.json e selecione Restaurar biblioteca do lado do cliente.