Verwenden der LibMan-CLI mit ASP.NET Core

Der Bibliotheks-Manager (LibMan) ist ein einfaches, clientseitiges Tool zum Bibliothekserwerb. LibMan lädt beliebte Bibliotheken und Frameworks vom Dateisystem oder von einem Content Delivery Network (CDN) herunter. Die unterstützten CDNs sind z. B. CDNJS, jsDelivr und unpkg. Die ausgewählten Bibliotheksdateien werden abgerufen und an der entsprechenden Position innerhalb des ASP.NET Core-Projekts platziert.

Prerequisites

Installation

Mit dem folgenden Befehl wird LibMan installiert:

dotnet tool install -g Microsoft.Web.LibraryManager.Cli

Note

Standardmäßig stellt die Architektur der zu installierenden .NET Binärdateien die derzeit ausgeführte Betriebssystemarchitektur dar. Wenn Sie eine andere Architektur angeben möchten, überprüfen Sie, wie Sie den dotnet tool install Befehl mit der Option "--arch" verwenden. Weitere Informationen finden Sie unter GitHub dotnet/aspnetcore.docs issue #29262 - Fügen Sie auf Apple Silicon „-a arm64“ hinzu.

Ein .NET Global Tool wird aus dem Microsoft.Web.LibraryManager.Cli NuGet-Paket installiert.

Usage

libman

So zeigen Sie die installierte LibMan-Version an:

libman --version

So zeigen Sie die verfügbaren CLI-Befehle an:

libman --help

Mit dem obigen Befehl wird eine ähnliche Ausgabe wie die folgende angezeigt:

 1.0.163+g45474d37ed

Usage: libman [options] [command]

Options:
  --help|-h  Show help information
  --version  Show version information

Commands:
  cache      List or clean libman cache contents
  clean      Deletes all library files defined in libman.json from the project
  init       Create a new libman.json
  install    Add a library definition to the libman.json file, and download the 
             library to the specified location
  restore    Downloads all files from provider and saves them to specified 
             destination
  uninstall  Deletes all files for the specified library from their specified 
             destination, then removes the specified library definition from 
             libman.json
  update     Updates the specified library

Use "libman [command] --help" for more information about a command.

In den folgenden Abschnitten werden die verfügbaren CLI-Befehle erläutert.

Initialisieren von LibMan im Projekt

Durch den Befehl libman init wird die Datei libman.json erstellt, sofern sie noch nicht existiert. Die Datei wird mit dem Inhalt der Standardelementvorlage erstellt.

Synopsis

libman init [-d|--default-destination] [-p|--default-provider] [--verbosity]
libman init [-h|--help]

Options

Für den Befehl libman init sind die folgenden Optionen verfügbar:

  • -d|--default-destination <PATH>

    Ein Pfad relativ zum aktuellen Ordner. Bibliotheksdateien werden an diesem Ort installiert, wenn für eine Bibliothek die Eigenschaft destination in libman.json nicht definiert ist. Der <PATH>-Wert wird in die Eigenschaft defaultDestination von libman.json geschrieben.

  • -p|--default-provider <PROVIDER>

    Mit dieser Option wird der Anbieter festgelegt, der verwendet werden soll, wenn für eine Bibliothek kein Anbieter definiert wurde. Der <PROVIDER>-Wert wird in die Eigenschaft defaultProvider von libman.json geschrieben. Ersetzen Sie <PROVIDER> durch einen der folgenden Werte:

    • cdnjs
    • filesystem
    • jsdelivr
    • unpkg

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

Gehen Sie wie folgt vor, um die Datei libman.json in einem ASP.NET Core-Projekt zu erstellen:

  • Navigieren Sie zum Projektstamm.

  • Führen Sie den folgenden Befehl aus:

    libman init

  • Geben Sie den Namen des Standardanbieters ein, oder drücken Sie die EINGABETASTE (Enter), um CDNJS als Standardanbieter zu verwenden. Gültige Werte sind:

    • cdnjs
    • filesystem
    • jsdelivr
    • unpkg

    Befehl „libman init“: Standardanbieter

Die Datei libman.json mit dem folgenden Inhalt wird dem Projektstamm hinzugefügt:

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": []
}

Bibliotheksdateien hinzufügen

Mit dem Befehl libman install werden Bibliotheksdateien in das Projekt heruntergeladen und dort installiert. Die Datei libman.json wird hinzugefügt, sofern sie noch nicht existiert. Die Datei libman.json wird so geändert, dass dort Konfigurationsdetails für die Bibliotheksdateien gespeichert werden.

Synopsis

libman install <LIBRARY> [-d|--destination] [--files] [-p|--provider] [--verbosity]
libman install [-h|--help]

Arguments

LIBRARY

Hierbei handelt es sich um den Namen der zu installierenden Bibliothek. Dieser Name kann eine Notation der Versionsnummer (z. B. @1.2.0) enthalten.

Options

Für den Befehl libman install sind die folgenden Optionen verfügbar:

  • -d|--destination <PATH>

    Der Speicherort für die Installation der Bibliothek. Wenn kein Ort angegeben wird, wird der Standardspeicherort verwendet. Wenn in defaultDestination kein Wert für die Eigenschaft libman.json festgelegt ist, ist diese Option erforderlich.

    Hinweis: Es gibt Einschränkungen für den Zielpfad. Wenn die Paketquelle beispielsweise eine vollständige Projektstruktur und nicht nur den Verteilungsordner aufweist, können Sie das Verschieben eines Ordners nicht angeben. Weitere Informationen finden Sie unter Problem 407 und Problem 702.

  • --files <FILE>

    Geben Sie den Namen der zu installierenden Datei aus der Bibliothek an. Wenn kein Dateiname angegeben wird, werden alle Dateien aus der Bibliothek installiert. Geben Sie die Option --files für jede der zu installierenden Dateien separat an. Relative Pfade werden ebenfalls unterstützt. Beispiel: --files dist/browser/signalr.js.

  • -p|--provider <PROVIDER>

    Der Name des Anbieters, der für den Bibliothekserwerb verwendet werden soll. Ersetzen Sie <PROVIDER> durch einen der folgenden Werte:

    • cdnjs
    • filesystem
    • jsdelivr
    • unpkg

    Wenn kein Wert festgelegt wird, wird der Wert der Eigenschaft defaultProvider in libman.json verwendet. Wenn in defaultProvider kein Wert für die Eigenschaft libman.json festgelegt ist, ist diese Option erforderlich.

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

Betrachten Sie die folgende libman.json -Datei:

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": []
}

So installieren Sie die jQuery-Datei der Version 3.2.1 jquery.min.js mithilfe des CDNJS-Anbieters in den Ordner wwwroot/scripts/jquery:

libman install jquery@3.2.1 --provider cdnjs --destination wwwroot/scripts/jquery --files jquery.min.js

Die endgültige libman.json-Datei sieht etwa wie folgt aus:

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": [
    {
      "library": "jquery@3.2.1",
      "destination": "wwwroot/scripts/jquery",
      "files": [
        "jquery.min.js"
      ]
    }
  ]
}

Installieren der Dateien calendar.js und calendar.css aus C:\temp\contosoCalendar\ mit dem Dateisystemanbieter:

libman install C:\temp\contosoCalendar\ --provider filesystem --files calendar.js --files calendar.css

Die folgende Aufforderung wird aus zwei Gründen angezeigt:

  • Die libman.json-Datei enthält keine defaultDestination-Eigenschaft.
  • Die Option libman install ist im Befehl -d|--destination nicht enthalten.

Befehl „libman install“: Ziel

Wenn das Standardziel bestätigt wurde, ähnelt die Datei libman.json dem folgenden Beispiel:

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": [
    {
      "library": "jquery@3.2.1",
      "destination": "wwwroot/scripts/jquery",
      "files": [
        "jquery.min.js"
      ]
    },
    {
      "library": "C:\\temp\\contosoCalendar\\",
      "provider": "filesystem",
      "destination": "wwwroot/lib/contosoCalendar",
      "files": [
        "calendar.js",
        "calendar.css"
      ]
    }
  ]
}

Wiederherstellen von Bibliotheksdateien

Mit dem Befehl libman restore werden die in libman.json definierten Bibliotheksdateien installiert. Es gelten die folgenden Regeln:

  • Wenn im Projektstamm keine Datei namens libman.json existiert, wird ein Fehler zurückgegeben.
  • Wenn in einer Bibliothek ein Anbieter festgelegt ist, wird die Eigenschaft defaultProvider in libman.json ignoriert.
  • Wenn in einer Bibliothek ein Ziel festgelegt ist, wird die Eigenschaft defaultDestination in libman.json ignoriert.

Synopsis

libman restore [--verbosity]
libman restore [-h|--help]

Options

Für den Befehl libman restore sind die folgenden Optionen verfügbar:

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

Wiederherstellen der in libman.json definierten Bibliotheksdateien:

libman restore

Löschen von Bibliotheksdateien

Mit dem Befehl libman clean werden zuvor mit LibMan wiederhergestellte Bibliotheksdateien gelöscht. Ordner, die nach diesem Vorgang leer sind, werden gelöscht. Die den Bibliotheksdateien zugeordneten Konfigurationen in der Eigenschaft libraries von libman.json werden nicht entfernt.

Synopsis

libman clean [--verbosity]
libman clean [-h|--help]

Options

Für den Befehl libman clean sind die folgenden Optionen verfügbar:

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

Löschen von über LibMan installierten Bibliotheksdateien:

libman clean

Deinstallieren von Bibliotheksdateien

Der Befehl libman uninstall:

  • werden alle der angegebenen Bibliothek zugeordneten Dateien am in libman.json angegebenen Ziel gelöscht.
  • Entfernt die zugehörige Bibliothekskonfiguration aus libman.json.

Ein Fehler tritt auf, wenn:

  • Im Stammverzeichnis des Projekts ist keine Datei libman.json vorhanden.
  • Die angegebene Bibliothek existiert nicht.

Wenn mehr als eine Bibliothek mit demselben Namen installiert ist, werden Sie dazu aufgefordert, eine auszuwählen.

Synopsis

libman uninstall <LIBRARY> [--verbosity]
libman uninstall [-h|--help]

Arguments

LIBRARY

Hierbei handelt es sich um den Namen der zu deinstallierenden Bibliothek. Dieser Name kann eine Notation der Versionsnummer (z. B. @1.2.0) enthalten.

Options

Für den Befehl libman uninstall sind die folgenden Optionen verfügbar:

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

Betrachten Sie die folgende libman.json -Datei:

{
  "version": "1.0",
  "defaultProvider": "cdnjs",
  "libraries": [
    {
      "library": "jquery@3.7.1",
      "files": [
        "jquery.min.js",
        "jquery.js",
        "jquery.min.map"
      ],
      "destination": "wwwroot/lib/jquery/"
    },
    {
      "provider": "unpkg",
      "library": "bootstrap@5.3.6",
      "destination": "wwwroot/lib/bootstrap/"
    }
  ]
}

  • jQuery kann mit einem der folgenden Befehle deinstalliert werden:

    libman uninstall jquery

    libman uninstall jquery@3.3.1

  • Deinstallieren der über den Anbieter filesystem installierten Lodash-Dateien:

    libman uninstall C:\temp\lodash\

Aktualisieren der Bibliotheksversion

Mit dem Befehl libman update wird eine über LibMan installierte Bibliothek auf die angegebene Version aktualisiert.

Ein Fehler tritt auf, wenn:

  • Im Stammverzeichnis des Projekts ist keine Datei libman.json vorhanden.
  • Die angegebene Bibliothek existiert nicht.

Wenn mehr als eine Bibliothek mit demselben Namen installiert ist, werden Sie dazu aufgefordert, eine auszuwählen.

Synopsis

libman update <LIBRARY> [-pre] [--to] [--verbosity]
libman update [-h|--help]

Arguments

LIBRARY

Hierbei handelt es sich um den Namen der zu aktualisierenden Bibliothek.

Options

Für den Befehl libman update sind die folgenden Optionen verfügbar:

  • -pre

    Abrufen der aktuellen Vorabversion der Bibliothek

  • --to <VERSION>

    Abrufen einer bestimmten Version der Bibliothek

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

  • Aktualisieren von jQuery auf die aktuelle Version:

    libman update jquery

  • Aktualisieren von jQuery auf Version 3.3.1:

    libman update jquery --to 3.3.1

  • Aktualisieren von jQuery auf die aktuelle Vorabversion:

    libman update jquery -pre

Bibliothekscache verwalten

Mit dem Befehl libman cache wird der LibMan-Bibliothekscache verwaltet. Der Anbieter filesystem verwendet den Bibliothekscache nicht.

Synopsis

libman cache clean [<PROVIDER>] [--verbosity]
libman cache list [--files] [--libraries] [--verbosity]
libman cache [-h|--help]

Arguments

PROVIDER

Wird nur mit dem Befehl clean verwendet. Damit wird der zu bereinigende Anbietercache angegeben. Gültige Werte sind:

  • cdnjs
  • filesystem
  • jsdelivr
  • unpkg

Options

Für den Befehl libman cache sind die folgenden Optionen verfügbar:

  • --files

    Listen Sie die Namen der zwischengespeicherten Dateien auf.

  • --libraries

    Nennen Sie die Namen der zwischengespeicherten Bibliotheken.

  • -h|--help

    Zeigt Hilfeinformationen an

  • --verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad der Ausgabe fest. Ersetzen Sie <LEVEL> durch einen der folgenden Werte:

    • quiet
    • normal
    • detailed

Examples

  • Verwenden Sie einen der folgenden Befehle, um die Namen der zwischengespeicherten Bibliotheken nach Anbietern sortiert anzuzeigen:

    libman cache list

    libman cache list --libraries

    Es wird eine Ausgabe ähnlich der folgenden angezeigt:

    Cache contents:
---------------
unpkg:
    knockout
    react
    vue
cdnjs:
    font-awesome
    jquery
    knockout
    lodash.js
    react

  • Anzeigen der Namen der zwischengespeicherten Bibliotheksdateien nach Anbietern sortiert:

    libman cache list --files

    Eine Ausgabe ähnlich der folgenden wird angezeigt:

    Cache contents:
---------------
unpkg:
    knockout:
        <list omitted for brevity>
    react:
        <list omitted for brevity>
    vue:
        <list omitted for brevity>
cdnjs:
    font-awesome
        metadata.json
    jquery
        metadata.json
        3.2.1\core.js
        3.2.1\jquery.js
        3.2.1\jquery.min.js
        3.2.1\jquery.min.map
        3.2.1\jquery.slim.js
        3.2.1\jquery.slim.min.js
        3.2.1\jquery.slim.min.map
        3.3.1\core.js
        3.3.1\jquery.js
        3.3.1\jquery.min.js
        3.3.1\jquery.min.map
        3.3.1\jquery.slim.js
        3.3.1\jquery.slim.min.js
        3.3.1\jquery.slim.min.map
    knockout
        metadata.json
        3.4.2\knockout-debug.js
        3.4.2\knockout-min.js
    lodash.js
        metadata.json
        4.17.10\lodash.js
        4.17.10\lodash.min.js
    react
        metadata.json

    Beachten Sie, dass bei der obigen Ausgabe die Versionen 3.2.1 und 3.3.1 von jQuery unter dem Anbieter CDNJS zwischengespeichert sind.

  • Leeren des Bibliothekscaches für den Anbieter CDNJS:

    libman cache clean cdnjs

    Wenn der Cache für den Anbieter CDNJS geleert wurde, wird nach dem Ausführen des Befehls libman cache list Folgendes angezeigt:

    Cache contents:
---------------
unpkg:
    knockout
    react
    vue
cdnjs:
    (empty)

  • Leeren des Caches für alle unterstützten Anbieter:

    libman cache clean

    Wenn alle Anbietercaches geleert wurden, wird nach dem Ausführen des Befehls libman cache list Folgendes angezeigt:

    Cache contents:
---------------
unpkg:
    (empty)
cdnjs:
    (empty)

Weitere Ressourcen

  • Last updated on