-
Notifications
You must be signed in to change notification settings - Fork 82
Using LibMan CLI
Here's a handy cheat sheet for getting started with LibMan CLI
Before you can use LibMan from the CLI, you must first download and install the global tool via the dotnet CLI.
> dotnet tool install -g Microsoft.Web.LibraryManager.CLI
If you need to install LibMan from an alternative location, use the following syntax.
> dotnet tool install -g Microsoft.Web.LibraryManager.CLI --version 1.0.94-g606058a278 --add-source C:\Temp\
Will install LibMan CLI from C:\Temp\Microsoft.Web.LibraryManager.CLI.1.0.94-g606058a278.nupkg
For more information, see Install a Global Tool
Install library files into your folder/project.
> libman install jquery
Will install the latest version of the library 'jquery' from the default provider.
Will prompt for default provider if there is no defaultProvider in libman.json.
Will prompt for destination if there is no defaultDestination in libman.json
Creates (or updates) libman.json like so:
{ "version": "1.0", "defaultProvider": "cdnjs", "libraries": [ { "library": "jquery@3.3.1", "destination": "lib\\jquery" } ] }
> libman install jquery@2.2.0
Will install a specific version of the library from the default provider.
Note: Syntax is [LibraryName]@[LibraryVersion] for all providers except File System.
> libman install twitter-bootstrap --destination wwwroot/lib/bootstrap
Will install to the specified destination folder
To download and install all files defined in the libman.json, run the restore command
> libman restore
Will fail if there is a conflict with libraries. (ie. more than one library defined with the same library name.)
> libman uninstall jquery
Will remove jquery files from the folder they were restored to.
Will remove the library definition from libman.json
> libman update jquery
Will update to the latest version of the library.
> libman update jquery --to 2.2.0
Will update to a specific version of the library.
> libman clean
Will remove from your project all files that were restored.
> libman cache list
Will print a list of all libraries that exist in the cache - by library name only.
> libman cache list --files
Will print a list of all libraries that exist in the cache, listing all files in the library cache.
> libman cache clean
Will remove all files in the local machine's cache.
> libman cache clean --provider cdnjs
Will remove all files in the local machine's cache for the specified provider.