Back in the days if we want to download jQuery library for a POC of a project we used to download the required js and CSS files from jquery site and then locating your folder to place your libraries within. Although, this job is being now replaced with package management systems you’ll need to install a package management system to do it for us. LibMan does it elegantly without any package manager.
LibMan(libman.json) is for managing client-side libraries in projects. It is a way of organizing client-side libraries into a specific folder without much hassle.
LibMan is added in Visual Studio as part of the update 15.8. Note that this is an experimental feature built into visual studio.
- With LibMan, you don’t need any additional package management system to be installed to download client-side libraries for projects. This doesn’t mean that libman is a package management system.
- Reduces the build tasks of organizing the library files.
- You can have the libman for any web projects. LibMan is not tied to any specific project.
For Web Projects, you can just open the folder in Visual Studio and add a
libman.json by yourself or you can do it with context menu option as well. We’ll see how to do it.
In this post, I’ll just create a folder as
app and open this folder as a website and add the libman in here. Notice the empty folders in my solution here.
Now, right click on the app and select
Manage Client-Side Libraries… from the context menu. This should create a
libman.json file in the project.
WebSite/Project and select
Manage Client-Side Libraries… from the menu
Both of the above options would create
libman.json file in the project with the default configuration (if the
libman.json does not exist already)
- defaultProvider: LibMan offers 3 different providers
- cdnjs (default provider)
- filesystem (from local files)
- unpkg (a fast, global cdn)
- defaultDestination: The default destination to all store the libraries, if the destination for a library is not specified. This option is not included by default in the libman.json config file.
- libraries: An array of libraries to configure.
As part of this article, we’ll just download the latest version of the jQuery library from
cdnjs network and map it to our local
lib folder on the website.
One of the good things about this LibMan integration into Visual Studio is that it provides an intellisense if the provider is configured to a CDN network such as
unpkg. The libman.json is not just a JSON file but we’ll have some intellisense while we configure it.
Let’s map the jQuery to the solution/project folder.
Add the following into the
libraries array of
"library": "[email protected]",
After you copy and paste the above code. Save the file. Now the jQuery files should be downloaded as you can see in the output window.
As you can see in the lib folder jQuery library is downloaded.
Notice that only a few js files are downloaded and no
CSS files are downloaded.
You can customize the files that you want to download using the files options inside a library object
"library": "[email protected]",
"files": [ "jquery-ui.css", "images/ui-icons_444444_256x240.png" ]
So, you can download whatever the files you want.
You can still restore the files manually by right-clicking on the project folder and selecting
Restore Client-Side Libraries.
There is an option to restore the files during the build as well. This can be done by right-clicking on the
libman.json and selecting
Enable Restore Client-Side Libraries on Build..
This will prompt you for an alert dialog in Visual Studio
This will add a package to the packages in the package.json file as we are in a web project.
If you are on a csharp project, then a package reference will be added in the
LibMan is a great addition to the visual studio. LibMan will avoid you to stop downloading the client side libraries from the web and unzip them and add it to the appropriate library folders that we wish to have. A cleaner way to set up the client side libraries without much effort.
If you are a guy who does Research and Development (R&D) all day long this LibMan is for you. You don’t need to search for the libraries around the web. Just use LibMan.
This LibMan still has its limitations to few providers as of now. But, hopefully, Microsoft might add few of them over time.
That’s it for the post.